View a markdown version of this page

Verwenden der API - Amazon Bedrock

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.

InvokeGuardrailChecks API-Fehler
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.