View a markdown version of this page

Syntax und Beispiele für Amazon Bedrock-Richtlinien - AWS Organizations
Die Amazon Bedrock-Richtliniensyntax umfasst die folgenden Elemente

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.

Syntax und Beispiele für Amazon Bedrock-Richtlinien

Eine Amazon Bedrock-Richtlinie ist eine Klartextdatei, die nach den Regeln von JSON strukturiert ist. Die Syntax für Amazon Bedrock-Richtlinien folgt der Syntax für alle Verwaltungsrichtlinientypen. Weitere Informationen finden Sie unter Richtliniensyntax und Vererbung für Verwaltungsrichtlinientypen. Dieses Thema konzentriert sich auf die Anwendung dieser allgemeinen Syntax auf die spezifischen Anforderungen des Amazon Bedrock-Richtlinientyps.

Das folgende Beispiel für eine Amazon Bedrock-Richtlinie zeigt die grundlegende Amazon Bedrock-Richtliniensyntax:

{
    "bedrock": {
        "guardrail_inference": {
            "us-east-1": {
                "config_1": {
                    "identifier": {
                        "@@assign": "arn:aws:bedrock:us-east-1:123456789012:guardrail/hu1dlsv9wy1d:1"
                    },
                    "selective_content_guarding": {
                        "system": {
                            "@@assign": "selective"
                        },
                        "messages": {
                            "@@assign": "comprehensive"
                        }
                    },
                    "model_enforcement": {
                        "included_models": {
                            "@@assign": ["ALL"]
                        },
                        "excluded_models": {
                            "@@assign": ["amazon.titan-embed-text-v2:0", "cohere.embed-english-v3"]
                        }
                    }
                }
            }
        }
    }
}

Die Amazon Bedrock-Richtliniensyntax umfasst die folgenden Elemente

"bedrock"

Der Schlüssel auf oberster Ebene für Richtliniendokumente von Amazon Bedrock.

"guardrail_inference"

Definiert die Konfiguration zur Durchsetzung von Leitplanken.

<region>

Die Region, in der die Richtlinie durchgesetzt wird. Beispiel, "us-east-1".

"config_1"

Konfigurations-ID für die Guardrail-Einstellungen.

"identifier" (Erforderlich)

Guardrail ARN, gefolgt von :version der Guardrail-Version.

  • Die Guardrail muss dem Verwaltungskonto gehören. Sie können keine Richtlinie mit einem Guardrail von einem anderen Konto aus erstellen.

  • Der Guardrail muss eine Version haben, und diese Version darf nicht DRAFT sein. Informationen zum Erstellen einer Version Ihrer Leitplanke finden Sie unter Erstellen einer Version einer Leitplanke im Amazon Bedrock-Benutzerhandbuch.

  • Die Guardrail muss über eine ressourcenbasierte Richtlinie verfügen, die es Mitgliedern der Organisation ermöglicht, Anrufe zu tätigen. ApplyGuardrail

  • Die Guardrail muss in der angegebenen Region erstellt und verwendet werden.

"selective_content_guarding" (Optional)

Amazon Bedrock APIs ermöglicht die Markierung bestimmter Inhalte innerhalb der Eingabe, die der Anrufer von den Leitplanken verarbeiten lassen möchte. Mit diesen Einstellungen können die Verantwortlichen kontrollieren, ob sie die vom Anrufer getroffenen Entscheidungen zur Kennzeichnung von Inhalten respektieren oder nicht. Wenn angegeben, ist einer von oder erforderlich. "system" "messages"

"system" (Optional)

Wählen Sie aus, wie Systemaufforderungen von Guardrails verarbeitet werden sollen. Standardmäßig, wenn nicht angegebencomprehensive.

  • "comprehensive": Wertet den gesamten Inhalt unabhängig von den Guard-Inhalts-Tags aus.

  • "selective": Wertet nur Inhalte innerhalb der Guard-Content-Tags aus. Wertet keinen Inhalt aus, wenn keine Tags angegeben sind.

"messages" (Optional)

Wählen Sie aus, wie Nachrichteninhalte mit Konversationen zwischen Benutzer und Assistent von Guardrails verarbeitet werden sollen. Standardmäßig auf, comprehensive wenn nicht angegeben.

  • "comprehensive": Wertet den gesamten Inhalt unabhängig von den Guard-Inhalts-Tags aus.

  • "selective": Wertet nur Inhalte innerhalb der Guard-Content-Tags aus. Wertet den gesamten Inhalt von Nachrichten aus, wenn keine Tags angegeben sind.

"model_enforcement" (Optional)

Modellspezifische Informationen für die erzwungene Leitplankenkonfiguration. Falls nicht vorhanden, wird die Konfiguration für alle Modelle erzwungen.

"included_models" (Erforderlich)

Liste der Modelle, bei denen die Leitplanke durchgesetzt werden soll. Wenn dieses Feld leer ist, wird die Durchsetzung auf alle Modelle angewendet. Akzeptiert auch das Schlüsselwort „ALL“, um explizit alle Modelle einzubeziehen.

"excluded_models" (Erforderlich)

Modelle, die von der Durchsetzung der Leitplanke ausgeschlossen werden sollen. Wenn dieses Feld leer ist, werden keine Modelle von der Durchsetzung ausgeschlossen. Wenn ein Modell sowohl in der Liste der eingeschlossenen als auch in der Liste der ausgeschlossenen Modelle enthalten ist, wird es ausgeschlossen.