Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utilisation de l’API
Pour effectuer des contrôles de sécurité, envoyez une InvokeGuardrailChecks demande au point de terminaison Amazon Bedrock Runtime.
Format des demandes
{ "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: obligatoire. Au moins un message avec un bloc de contenu textuel. -
checks: obligatoire. Au moins un champ de contrôle doit être défini.
Format de la réponse
{ "results": { "contentFilter": { "results": [ ... ] }, "promptAttack": { "results": [ ... ] }, "sensitiveInformation": { "results": [ ... ], "truncated": false } }, "usage": { "contentFilter": { "textUnits": 0 }, "promptAttack": { "textUnits": 0 }, "sensitiveInformation": { "textUnits": 0 } } }
Seuls les chèques que vous avez demandés apparaissent sous results etusage. Chaque textUnits valeur est le nombre d'unités de texte évaluées par le contrôle. Pour la définition d'une unité de texte, consultez la tarification d'Amazon Bedrock
Erreurs
Le tableau suivant répertorie les erreurs que l'InvokeGuardrailChecksAPI peut renvoyer.
| Code HTTP | Erreur | Cause |
|---|---|---|
| 400 | ValidationException | La demande est mal formée, ne contient pas de champs obligatoires ou enfreint une contrainte. |
| 403 | AccessDeniedException | L'appelant n'est pas autorisé à appeler l'API. |
| 429 | ThrottlingException | Le taux de demandes a dépassé le quota du compte. Réessayez avec un recul exponentiel. |
| 500 | InternalServerException | Le service a rencontré une erreur inattendue. Réitérez la demande. |
| 503 | ServiceUnavailableException | Le service est temporairement indisponible. Réessayez avec un recul exponentiel. |