Saltar para o conteúdo principal
As políticas MAIP permitem que você aplique guardrails ao comportamento do agente de IA em tempo de execução. Quando um agente solicita acesso a um recurso com escopo, todas as políticas ativas são avaliadas antes que a ação prossiga. Se alguma política negar a solicitação, a ação será bloqueada.
As políticas MAIP são diferentes das políticas de emissão. As políticas de emissão governam a criação e verificação de credenciais para usuários humanos e emissores. As políticas MAIP governam o comportamento do agente de máquina em tempo de execução — controlando o que os agentes podem fazer com base em pontuações de confiança, profundidade de delegação, escopos e tipo de agente.

Quando usar políticas MAIP

Use as políticas MAIP quando precisar:
  • Bloquear agentes com baixas pontuações de confiança de realizar operações sensíveis
  • Exigir aprovação humana quando um agente está profundamente em uma cadeia de delegação
  • Restringir tipos específicos de agentes (por exemplo, llm ou worker) de acessar certos escopos
  • Impor regras diferentes para diferentes níveis de risco sem alterar o código do agente
  • Adicionar guard-rails de tempo de execução a fluxos de trabalho de orquestração multiagente
Se você não criar nenhuma política MAIP, o acesso do agente será controlado apenas por atribuições de escopo e status do agente.

Como as políticas funcionam

Cada política MAIP contém uma ou mais regras. Cada regra tem:
  • Condições — verificações em nível de campo avaliadas em relação ao contexto do agente solicitante
  • Efeito — allow, deny, ou require_approval
  • requires_approval — flag opcional que aciona um fluxo de trabalho de aprovação humana
As regras dentro de uma política são avaliadas independentemente. Se qualquer regra com um efeito deny corresponder, a ação é bloqueada independentemente de quaisquer regras allow. Este é um modelo de negação-prevalece.

Ordem de avaliação

  1. Status do agente — o agente deve estar active. Agentes suspensos ou revogados são sempre negados.
  2. Verificação de escopo — o escopo solicitado deve estar nos escopos concedidos do agente. Escopos explicitamente negados (prefixados com !) sempre bloqueiam o acesso.
  3. Regras de política — todas as políticas de locatário ativas são avaliadas em ordem de prioridade (números menores primeiro). As condições de cada regra são combinadas com AND.

Campos de condição

Operadores

Efeitos

Criar uma política

Todas as novas políticas são criadas com status: "active" e entram em vigor imediatamente.

Categorias de política

Prioridade

O campo priority controla a ordem de avaliação. Números menores são avaliados primeiro. Intervalo: 1–1000. Padrão: 100. Se várias políticas compartilharem a mesma prioridade, elas serão avaliadas na ordem de criação.

Avaliando políticas em tempo de execução

Chame o endpoint de avaliação antes que seu agente execute uma operação sensível. A resposta informa se a ação é permitida, negada ou requer aprovação humana.
Resposta permitida:
Resposta negada:
Requer resposta de aprovação:
Quando requires_approval é true, sua aplicação deve rotear a ação através de um fluxo de trabalho de aprovação humana antes de prosseguir.

Listando políticas

Retorna todas as políticas MAIP para seu inquilino, incluindo suas regras, prioridade e status.

Padrões comuns

Bloquear agentes não confiáveis de gravar dados

Negar a qualquer agente com pontuação de confiança abaixo de 0,5 o acesso a escopos de gravação.

Exigir aprovação para cadeias de delegação profunda

Agentes com mais de três níveis de profundidade em uma cadeia de delegação devem obter aprovação humana para qualquer ação.

Restringir agentes LLM de executar ferramentas

Impedir que agentes do tipo LLM invoquem escopos de execução de ferramentas, permitindo outros tipos de agentes.

Bloquear vários tipos de agente de um escopo

Use o operador in para corresponder a uma lista de valores em vez de escrever regras separadas para cada tipo de agente.

Negar todos os escopos de gravação com uma única regra

Use o operador contains para corresponder a qualquer escopo que inclua uma substring, em vez de listar cada escopo de gravação individualmente.

Combinar várias regras em uma política

Uma única política pode conter várias regras para aplicação em camadas:
Esta política bloqueia agentes com pontuações de confiança abaixo de 0,3 e exige aprovação humana para operações de escrita de agentes com pontuações entre 0,3 e 0,7.

Políticas MAIP vs. políticas RBAC

Relacionado

Referência da API de Políticas MAIP

Crie, liste e avalie políticas MAIP via API REST.

Pontuações de confiança

Entenda o sistema de pontuação de confiança que alimenta as condições da política.

Autorização do agente

Autorização baseada em escopo e gerenciamento de sessão para agentes.

Identidade da máquina

Visão geral completa do Protocolo de Identidade do Agente de Máquina.