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.
| 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. |