View a markdown version of this page

Sintaxe e exemplos de políticas do Amazon Bedrock - AWS Organizations
A sintaxe da política Amazon Bedrock inclui os seguintes elementos:

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Sintaxe e exemplos de políticas do Amazon Bedrock

Uma política do Amazon Bedrock é um arquivo de texto simples estruturado de acordo com as regras do JSON. A sintaxe das políticas do Amazon Bedrock segue a sintaxe de todos os tipos de políticas de gerenciamento. Para obter mais informações, consulte Sintaxe de política e herança para tipos de política de gerenciamento. Este tópico se concentra na aplicação dessa sintaxe geral aos requisitos específicos do tipo de política Amazon Bedrock.

O exemplo de política do Amazon Bedrock a seguir mostra a sintaxe básica da política do 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"]
                        }
                    }
                }
            }
        }
    }
}

A sintaxe da política Amazon Bedrock inclui os seguintes elementos:

"bedrock"

A chave de nível superior para documentos de política do Amazon Bedrock.

"guardrail_inference"

Define a configuração de fiscalização do guardrail.

<region>

A região onde a política será aplicada. Por exemplo, ."us-east-1"

"config_1"

Identificador de configuração para as configurações do guarda-corpo.

"identifier" (Obrigatório)

ARN do Guardrail, seguido pela :version versão do Guardrail.

  • O Guardrail deve pertencer à conta de gerenciamento. Você não pode criar uma política usando um Guardrail de outra conta.

  • O Guardrail deve ter uma versão, e essa versão não pode ser RASCUNHO. Para criar uma versão da sua grade de proteção, consulte Criar uma versão de uma grade de proteção no guia do usuário do Amazon Bedrock.

  • O Guardrail deve ter uma política baseada em recursos que permita que os membros da organização liguem. ApplyGuardrail

  • O Guardrail deve ser criado e usado na região especificada.

"selective_content_guarding" (Opcional)

O Amazon Bedrock APIs permite marcar conteúdo específico na entrada que o chamador deseja que as grades de proteção processem. Essas configurações permitem que os agentes controlem se devem ou não respeitar as decisões de marcação de conteúdo tomadas pelo chamador. Quando especificado, um dos "system" ou "messages" é obrigatório.

"system" (Opcional)

Escolha como as solicitações do sistema serão processadas por grades de proteção. O padrão é comprehensive quando não especificado.

  • "comprehensive": avalie todo o conteúdo, independentemente das tags de proteção de conteúdo.

  • "selective": avalie somente o conteúdo dentro das tags de proteção de conteúdo. Não avalia nenhum conteúdo quando nenhuma tag é especificada.

"messages" (Opcional)

Escolha como o conteúdo da mensagem com a conversa do usuário e do assistente será processado por grades de proteção. O padrão é comprehensive quando não especificado.

  • "comprehensive": avalie todo o conteúdo, independentemente das tags de proteção de conteúdo.

  • "selective": avalie somente o conteúdo dentro das tags de proteção de conteúdo. Avalia todo o conteúdo das mensagens quando nenhuma tag é especificada.

"model_enforcement" (Opcional)

Informações específicas do modelo para a configuração forçada do guarda-corpo. Se não estiver presente, a configuração é aplicada em todos os modelos.

"included_models" (Obrigatório)

Lista de modelos para aplicar a grade de proteção. Quando vazio, aplica a fiscalização a todos os modelos. Também aceita a palavra-chave “ALL” para incluir explicitamente todos os modelos.

"excluded_models" (Obrigatório)

Modelos a serem excluídos da aplicação da grade de proteção. Quando vazio, não exclui nenhum modelo da fiscalização. Se um modelo estiver presente nas listas de modelos incluídos e excluídos, ele será excluído.