Crie sua política de raciocínio automatizado

Quando você cria uma política de raciocínio automatizado, seu documento fonte de entrada é traduzido em um conjunto de regras lógicas formais e um esquema de variáveis e tipos.

Exemplo: se o documento de origem contiver uma política de RH declarando que “funcionários em tempo integral que trabalharam por pelo menos 1 ano são elegíveis para licença parental”, o raciocínio automatizado extrairá variáveis como is_full_time (booleano), years_of_service (inteiro) e eligible_for_parental_leave (booleano), junto com uma regra que as conecta.

nota

Vídeo tutorial: Para ver um step-by-step passo a passo da criação de uma política de raciocínio automatizado, assista ao seguinte tutorial:

Tutorial de demonstração 1 - Criação de políticas em verificações automatizadas de raciocínio

Crie sua política de raciocínio automatizado no console

1. No painel de navegação à esquerda, escolha Raciocínio automatizado e, em seguida, escolha Criar política.

2. Insira um Nome para a política.

3. (Opcional) Insira uma descrição para a política.

4. Para o Source, você precisa fornecer um documento que descreva as regras e políticas do seu domínio de conhecimento. Este documento deve conter as regras, políticas ou diretrizes de negócios que você deseja que o Raciocínio Automatizado valide. Por exemplo, você pode carregar um documento de política de RH que defina a elegibilidade aos benefícios dos funcionários, um manual de conformidade que descreva os requisitos regulamentares ou uma especificação técnica que descreva as restrições do sistema. O documento deve ser abrangente e escrito de forma clara, pois o raciocínio automatizado extrairá regras lógicas formais desse conteúdo.

   nota

   Prática recomendada: para políticas complexas, é melhor dividir o conteúdo em partes fáceis de entender e importar progressivamente novos conteúdos em uma política para torná-la mais complexa. Comece com um subconjunto específico de suas regras, crie e teste a política minuciosamente e, em seguida, adicione gradualmente mais conteúdo nas iterações subsequentes. Essa abordagem ajuda você a identificar e resolver problemas com antecedência, garante que cada adição funcione corretamente com as regras existentes e facilita a solução de problemas quando surgem problemas.

   Faça o seguinte:

   1. Para o método Ingest, faça o seguinte:

      1. Selecione Carregar documento e, em seguida, selecione Escolher arquivo. Faça upload de um documento PDF do conteúdo de origem que servirá como base para sua política.

      2. Selecione Inserir texto. Cole ou insira o conteúdo de origem que servirá como base para sua política.

   2. (Recomendado) Para obter instruções, especifique informações adicionais sobre como processar seu documento de origem. Embora opcional, fornecer informações sobre como a política será usada e em quais partes do documento focar ou ignorar ajuda no processo de extração lógica.

      nota

      As instruções devem explicar que tipo de perguntas a política validará, descrever a estrutura do documento de entrada e dar um exemplo do tipo de perguntas que os usuários farão. Por exemplo: “Esta política validará as perguntas de RH sobre a elegibilidade da licença. O documento tem seções sobre diferentes tipos de licença. Os usuários farão perguntas como “Estou qualificado para a licença parental se eu trabalhar aqui por 9 meses?”

5. (Opcional) Em Tags, escolha Adicionar nova tag para marcar sua política. As tags podem ajudar você a gerenciar, filtrar e pesquisar seus recursos da AWS.

6. Selecione Criar política.

Crie sua política de raciocínio automatizado usando a API

Você pode usar a operação da CreateAutomatedReasoningPolicy API para criar uma política de raciocínio automatizado de forma programática.

Parâmetros de solicitação

Os parâmetros a seguir são obrigatórios ou opcionais ao criar uma política de raciocínio automatizado:

name(obrigatório)

O nome da política de raciocínio automatizado. O nome deve ser exclusivo na sua conta e região da AWS.

description (opcional)

Uma descrição da política de raciocínio automatizado. Use isso para fornecer contexto sobre a finalidade da política e os tipos de validações que ela executa.

clientRequestToken (opcional)

Um identificador exclusivo que diferencia maiúsculas de minúsculas para garantir que a operação seja concluída no máximo uma vez. Se esse token corresponder a uma solicitação anterior, o Amazon Bedrock ignorará a solicitação, mas não retornará um erro.

policyDefinition (opcional)

A definição de política que contém as regras lógicas formais, as variáveis e os tipos de variáveis personalizados usados para validar as respostas do modelo básico em seu aplicativo.

tags (opcional)

Uma lista de tags a serem associadas à política de raciocínio automatizado. As tags ajudam você a organizar e gerenciar suas políticas.

Elementos de resposta

A API retorna as seguintes informações:

policyArn

O nome de recurso da Amazon (ARN) da política de raciocínio automatizado que você criou.

version

A versão da política de raciocínio automatizado. A versão inicial éDRAFT.

name

O nome da política de raciocínio automatizado.

Exemplo

O exemplo a seguir mostra como criar uma política de raciocínio automatizado usando o AWS CLI:

aws bedrock create-automated-reasoning-policy \
  --name "DeleteMe" \
  --description "A Test AR Policy" \
  --source-document file://policy-document.pdf

Exemplo de resposta:

{
  "createdAt": "2025-07-21T14:43:52.692Z",
  "definitionHash": "f16ba1ceca36e1d21adce559481add6a4998b79ae203d933fd0206a28d5c2896513dd62f57b293cba282441269a72063b1d9da02fcf2b421e9bf8495ff8c87af",
  "description": "A Test AR Policy",
  "name": "DeleteMe",
  "policyArn": "arn:aws:bedrock:us-east-1:286352875722:automated-reasoning-policy/lnq5hhz70wgk",
  "updatedAt": "2025-07-21T14:43:52.692Z",
  "version": "DRAFT"
}

Exibir detalhes da política de raciocínio automatizado

Depois de criar sua política, você pode ver a lógica e as variáveis traduzidas na página Definições da política.