View a markdown version of this page

Uso de la API - Amazon Bedrock

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de la API

Para realizar comprobaciones de barandillas, envíe una InvokeGuardrailChecks solicitud al punto de conexión de tiempo de ejecución de Amazon Bedrock.

Formato de las solicitudes

{ "messages": [ { "role": "user", "content": [{ "text": "string" }] } ], "checks": { "contentFilter": { "categories": [ { "category": "VIOLENCE | HATE | SEXUAL | INSULTS | MISCONDUCT" } ] }, "promptAttack": { "categories": [ { "category": "JAILBREAK | PROMPT_INJECTION | PROMPT_LEAKAGE" } ] }, "sensitiveInformation": { "entities": [ { "type": "EMAIL | PHONE | US_SOCIAL_SECURITY_NUMBER | ..." } ] } } }
  • messages: obligatorio. Al menos un mensaje con un bloque de contenido de texto.

  • checks: obligatorio. Debe configurarse al menos un campo de verificación.

Formato de las respuestas

{ "results": { "contentFilter": { "results": [ ... ] }, "promptAttack": { "results": [ ... ] }, "sensitiveInformation": { "results": [ ... ], "truncated": false } }, "usage": { "contentFilter": { "textUnits": 0 }, "promptAttack": { "textUnits": 0 }, "sensitiveInformation": { "textUnits": 0 } } }

Solo los cheques que ha solicitado aparecen en results yusage. Cada textUnits valor es el número de unidades de texto que evaluó la verificación. Para ver la definición de una unidad de texto, consulta los precios de Amazon Bedrock.

Errores

En la siguiente tabla se enumeran los errores que la InvokeGuardrailChecks API puede devolver.

InvokeGuardrailChecks Errores de API
Código de HTTP Error Causa
400 ValidationException La solicitud tiene un formato incorrecto, faltan campos obligatorios o infringe una restricción.
403 AccessDeniedException La persona que llama no está autorizada a invocar la API.
429 ThrottlingException La tasa de solicitudes superó la cuota de la cuenta. Vuelva a intentarlo con un retraso exponencial.
500 InternalServerException El servicio encontró un error inesperado. Intente realizar de nuevo la solicitud .
503 ServiceUnavailableException El servicio no está disponible temporalmente. Vuelva a intentarlo con un retroceso exponencial.