View a markdown version of this page

Sintassi ed esempi delle policy di Amazon Bedrock - AWS Organizations
La sintassi della policy di Amazon Bedrock include i seguenti elementi:

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Sintassi ed esempi delle policy di Amazon Bedrock

Una policy di Amazon Bedrock è un file di testo semplice strutturato secondo le regole di JSON. La sintassi per le policy di Amazon Bedrock segue la sintassi di tutti i tipi di policy di gestione. Per ulteriori informazioni, consulta Sintassi ed ereditarietà delle policy per i tipi di policy di gestione. Questo argomento si concentra sull'applicazione di tale sintassi generale ai requisiti specifici del tipo di policy Amazon Bedrock.

Il seguente esempio di policy di Amazon Bedrock mostra la sintassi di base della policy 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 sintassi della policy di Amazon Bedrock include i seguenti elementi:

"bedrock"

La chiave di primo livello per i documenti relativi alle policy di Amazon Bedrock.

"guardrail_inference"

Definisce la configurazione di applicazione del guardrail.

<region>

La regione in cui verrà applicata la politica. Ad esempio, "us-east-1".

"config_1"

Identificatore di configurazione per le impostazioni del guardrail.

"identifier" (Obbligatorio)

Guardrail ARN, seguito :version dalla versione Guardrail.

  • Il Guardrail deve essere di proprietà dell'account di gestione. Non è possibile creare una politica utilizzando un Guardrail di un altro account.

  • Il Guardrail deve avere una versione e quella versione non può essere DRAFT. Per creare una versione del tuo guardrail, consulta Creare una versione di un guardrail nella guida per l'utente di Amazon Bedrock.

  • Il Guardrail deve disporre di una politica basata sulle risorse che consenta ai membri dell'organizzazione di effettuare chiamate. ApplyGuardrail

  • Il Guardrail deve essere creato e utilizzato nella regione specificata.

"selective_content_guarding" (facoltativo).

Amazon Bedrock APIs consente di contrassegnare contenuti specifici all'interno dell'input che il chiamante desidera che i guardrail elaborino. Queste impostazioni consentono agli esecutori di decidere se rispettare o meno le decisioni di tagging dei contenuti prese dal chiamante. Quando specificato, uno dei due è obbligatorio. "system" "messages"

"system" (facoltativo).

Scegli in che modo le istruzioni di sistema verranno elaborate dai guardrail. Il valore predefinito è quando non specificato. comprehensive

  • "comprehensive": valuta tutti i contenuti indipendentemente dai tag guard content.

  • "selective": Valuta solo i contenuti all'interno dei tag di contenuto di guard. Non valuta alcun contenuto quando non viene specificato alcun tag.

"messages" (facoltativo).

Scegli in che modo il contenuto dei messaggi con conversazione con utente e assistente verrà elaborato dai guardrails. Il valore predefinito è quando non specificato. comprehensive

  • "comprehensive": valuta tutti i contenuti indipendentemente dai tag guard content.

  • "selective": Valuta solo i contenuti all'interno dei tag di contenuto di guard. Valuta tutto il contenuto dei messaggi quando non viene specificato alcun tag.

"model_enforcement" (facoltativo).

Informazioni specifiche del modello per la configurazione forzata del guardrail. Se non è presente, la configurazione viene applicata a tutti i modelli.

"included_models" (Obbligatorio)

Elenco dei modelli su cui applicare il guardrail. Quando è vuoto, applica l'applicazione a tutti i modelli. Accetta anche la parola chiave «ALL» per includere esplicitamente tutti i modelli.

"excluded_models" (Obbligatorio)

Modelli da escludere dall'applicazione del guardrail. Se vuoto, non esclude alcun modello dall'applicazione. Se un modello è presente sia nell'elenco dei modelli inclusi che in quelli esclusi, viene escluso.