Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Verwenden der API
Um Guardrail-Prüfungen durchzuführen, senden Sie eine InvokeGuardrailChecks Anfrage an den Amazon Bedrock-Laufzeitendpunkt.
Anforderungsformat
{ "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– Erforderlich. Mindestens eine Nachricht mit einem Textinhaltsblock. -
checks– Erforderlich. Es muss mindestens ein Prüffeld gesetzt sein.
Reaktionsformat
{ "results": { "contentFilter": { "results": [ ... ] }, "promptAttack": { "results": [ ... ] }, "sensitiveInformation": { "results": [ ... ], "truncated": false } }, "usage": { "contentFilter": { "textUnits": 0 }, "promptAttack": { "textUnits": 0 }, "sensitiveInformation": { "textUnits": 0 } } }
Nur die von Ihnen angeforderten Schecks werden unter results und angezeigtusage. Jeder textUnits Wert gibt die Anzahl der Texteinheiten an, die bei der Prüfung ausgewertet wurden. Die Definition einer Texteinheit finden Sie unter Amazon Bedrock — Preise
Fehler
In der folgenden Tabelle sind die Fehler aufgeführt, die die InvokeGuardrailChecks API zurückgeben kann.
| HTTP-Code | Fehler | Ursache |
|---|---|---|
| 400 | ValidationException | Die Anfrage ist falsch formatiert, es fehlen Pflichtfelder oder sie verstößt gegen eine Einschränkung. |
| 403 | AccessDeniedException | Der Aufrufer ist nicht berechtigt, die API aufzurufen. |
| 429 | ThrottlingException | Die Anforderungsrate hat das Kontingent des Kontos überschritten. Versuchen Sie es erneut mit exponentiellem Backoff. |
| 500 | InternalServerException | Beim Dienst ist ein unerwarteter Fehler aufgetreten. Wiederholen Sie die Anforderung. |
| 503 | ServiceUnavailableException | Der Service ist vorübergehend nicht verfügbar. Versuchen Sie es erneut mit exponentiellem Backoff. |