View a markdown version of this page

Utilisation de l’API - Amazon Bedrock

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.

InvokeGuardrailChecks Erreurs d'API
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.