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,
llmouworker) 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
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, ourequire_approval - requires_approval — flag opcional que aciona um fluxo de trabalho de aprovação humana
deny corresponder, a ação é bloqueada independentemente de quaisquer regras allow. Este é um modelo de negação-prevalece.
Ordem de avaliação
- Status do agente — o agente deve estar
active. Agentes suspensos ou revogados são sempre negados. - Verificação de escopo — o escopo solicitado deve estar nos escopos concedidos do agente. Escopos explicitamente negados (prefixados com
!) sempre bloqueiam o acesso. - 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
status: "active" e entram em vigor imediatamente.
Categorias de política
Prioridade
O campopriority 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.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
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 operadorin 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 operadorcontains 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: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.

