microsoft/agent-governance-toolkitAplicação de políticas, identidade de confiança zero, sandbox de execução e registro de auditoria para agentes autônomos de IA. Cobre 10/10 do OWASP Agentic Top 10 com governança determinística e de falha fechada.
🌍 English | Español | 日本語 | 简体中文 | 한국어 | 繁體中文
🚀 Quick Start · 📋 Specifications · 📦 PyPI · 📝 Changelog
-brightgreen){kind=icon}
[!IMPORTANT] Public Preview -- versões de pré-visualização pública com qualidade de produção. Pode ter mudanças disruptivas antes do GA.
Aplicação de políticas, identidade, sandboxing e SRE para agentes de IA autônomos. Um pip install, qualquer framework.
Seus agentes de IA chamam ferramentas, navegam na web, consultam bancos de dados e delegam para outros agentes. Uma vez implantados, eles tomam decisões de forma autônoma. Você precisa de respostas para três perguntas:
1. Esta ação é permitida? Um agente com acesso a send_email e query_database não deveria ser capaz de drop_table. Escopos OAuth e funções IAM controlam quais serviços um agente pode alcançar, não o que ele faz depois de conectado.
2. Qual agente fez isso? Em um sistema multiagente, cinco agentes podem compartilhar uma única chave de API. Quando algo dá errado, "um agente fez isso" não é uma resposta a incidentes.
3. Você consegue provar o que aconteceu? Auditores e reguladores precisam de registros à prova de adulteração de cada decisão: qual política estava ativa, o que o agente solicitou e por que foi permitido ou negado.
A segurança em nível de prompt ("por favor, siga as regras") não é uma superfície de controle. É um pedido educado a um sistema estocástico. O OWASP LLM01:2025 afirma isso explicitamente: "não está claro se existem métodos infalíveis de prevenção para injeção de prompt." Os números publicados corroboram isso. Andriushchenko et al. (ICLR 2025) relatam 100% de taxa de sucesso de ataque em GPT-4o, GPT-3.5, Claude 3 e Llama-3 usando ataques adaptativos com acesso a logprob e otimização de sufixo, avaliados contra o benchmark JailbreakBench (Chao et al., NeurIPS 2024). O próprio AI Red Teaming Agent da Microsoft formaliza a Attack Success Rate (ASR), a taxa de violações de política sob entrada adversária, como a métrica canônica para essa classe de falha. Lessons from Red Teaming 100 Generative AI Products reforça o ponto: "as mitigações não eliminam o risco completamente" e o red teaming deve ser um processo contínuo porque as defesas na camada do modelo são probabilísticas por construção.
O AGT não tenta vencer essa batalha dentro do prompt. Cada chamada de ferramenta, envio de mensagem e delegação é interceptado em código de aplicação determinístico antes que a intenção do modelo chegue à rede. Ações que o kernel do AGT nega não são "improváveis". Elas são estruturalmente impossíveis. Essa é a diferença entre pedir que um agente se comporte bem e torná-lo incapaz de se comportar mal.
Pré-requisitos: Python 3.11+
pip install "agent-governance-toolkit[full]"
Use o extra [full] para as importações de início rápido abaixo. O wheel base
agent-governance-toolkit instala apenas a CLI de conformidade; os módulos de
governança residem na distribuição core consolidada. A importação de início rápido
agentmesh continua a ser a API wrapper atual. Importar agent_os emite um
DeprecationWarning porque a antiga distribuição agent-os-kernel está obsoleta.
Use agent-governance-toolkit-core (ou o extra [full] que o inclui) como
a distribuição de substituição. O código host do motor de políticas usa o ACS SDK;
agt-policies fornece o comando de migração unidirecional v4-para-v5. O modelo de
regras pré-ACS agent_os.policies desapareceu, e BREAKING_CHANGES.md lista as
suas substituições.
O motor de políticas é publicado upstream como
agent-control-spec.
agent-hooks define o seu
contrato de interceção. O AGT mantém as APIs host AgentControl e os adaptadores
de framework em policy-engine/, não um segundo motor de decisão.
Isto mantém a avaliação de políticas num único local. O AGT pode adotar correções
upstream através de uma atualização de dependência, mantendo as suas APIs host e
integrações de framework.
Consulte o guia do pacote ACS para
a distinção entre pacotes upstream e os SDKs de compatibilidade do AGT.
Para o Claude Code, adicione o AGT como um marketplace de plugins e instale o plugin de governança:
/plugin marketplace add microsoft/agent-governance-toolkit
/plugin install agt-governance@agent-governance-toolkit
Registre qualquer função de ferramenta em duas linhas:
from agentmesh.governance import govern