View a markdown version of this page

Syntaxe et exemples de politiques Amazon Bedrock - AWS Organizations
La syntaxe de la politique Amazon Bedrock inclut les éléments suivants

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.

Syntaxe et exemples de politiques Amazon Bedrock

Une politique Amazon Bedrock est un fichier en texte brut structuré selon les règles du JSON. La syntaxe des politiques Amazon Bedrock suit celle de tous les types de politiques déclaratives. Pour plus d'informations, consultez Syntaxe des politiques et héritage pour les types de politiques déclaratives. Cette rubrique se concentre sur l'application de cette syntaxe générale aux exigences spécifiques du type de politique Amazon Bedrock.

L'exemple de politique Amazon Bedrock suivant montre la syntaxe de base de la politique Amazon Bedrock :

{
    "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"]
                        }
                    }
                }
            }
        }
    }
}

La syntaxe de la politique Amazon Bedrock inclut les éléments suivants

"bedrock"

La clé de niveau supérieur pour les documents de politique d'Amazon Bedrock.

"guardrail_inference"

Définit la configuration de renforcement des garde-corps.

<region>

Région dans laquelle la politique sera appliquée. Par exemple, "us-east-1".

"config_1"

Identifiant de configuration pour les paramètres du garde-corps.

"identifier" (Obligatoire)

Guardrail ARN, suivi :version de la version Guardrail.

  • Le garde-corps doit appartenir au compte de gestion. Vous ne pouvez pas créer de politique à l'aide d'un garde-corps provenant d'un autre compte.

  • Le garde-corps doit avoir une version, et cette version ne peut pas être DRAFT. Pour créer une version de votre garde-corps, consultez la section Créer une version d'un garde-corps dans le guide de l'utilisateur d'Amazon Bedrock.

  • Le Guardrail doit avoir une politique basée sur les ressources qui permet aux membres de l'organisation d'appeler. ApplyGuardrail

  • Le garde-corps doit être créé et utilisé dans la région spécifiée.

"selective_content_guarding" (facultatif)

Les API Amazon Bedrock permettent de marquer du contenu spécifique dans la saisie que l'appelant souhaite voir traiter par des garde-fous. Ces paramètres permettent aux responsables de l'application de contrôler s'ils doivent ou non respecter les décisions de balisage du contenu prises par l'appelant. Lorsque cela est spécifié, l'un "system" des "messages" deux est requis.

"system" (facultatif)

Choisissez la manière dont les instructions du système seront traitées par les glissières de sécurité. La valeur par défaut est comprehensive lorsqu'elle n'est pas spécifiée.

  • "comprehensive": évaluez l'ensemble du contenu, quelles que soient les balises de contenu de protection.

  • "selective": évaluez uniquement le contenu inclus dans les balises de contenu Guard. N'évalue aucun contenu lorsqu'aucune balise n'est spécifiée.

"messages" (facultatif)

Choisissez la manière dont le contenu des messages contenant les conversations entre l'utilisateur et l'assistant sera traité par des garde-fous. La valeur par défaut est comprehensive lorsqu'elle n'est pas spécifiée.

  • "comprehensive": évaluez l'ensemble du contenu, quelles que soient les balises de contenu de protection.

  • "selective": évaluez uniquement le contenu inclus dans les balises de contenu Guard. Évalue tout le contenu des messages lorsqu'aucune balise n'est spécifiée.

"model_enforcement" (facultatif)

Model-specific informations relatives à la configuration du garde-corps imposé. Si elle n'est pas présente, la configuration est appliquée à tous les modèles.

"included_models" (Obligatoire)

Liste des modèles sur lesquels renforcer le garde-corps. Lorsqu'il est vide, applique l'application à tous les modèles. Accepte également le mot clé « ALL » pour inclure explicitement tous les modèles.

"excluded_models" (Obligatoire)

Modèles à exclure de l'application du garde-corps. Lorsqu'il est vide, aucun modèle n'est exclu de l'application. Si un modèle est présent à la fois dans les listes des modèles inclus et exclus, il est exclu.