Matriz de permissões de ferramentas para agentes de IA: modelo prático

Uma matriz de permissões de ferramentas para agentes de IA é uma tabela com uma linha para cada ferramenta que o agente pode acessar. Cada linha descreve as ações permitidas naquela ferramenta, os dados que essas ações podem tocar, as condições que se aplicam e a pessoa nomeada que aprova tudo o que estiver fora da rotina. Bem construída, a matriz mostra de imediato por que um agente pode ler a conversa de um cliente, mas não pode emitir um reembolso, e dá à equipe um único lugar para apertar o acesso quando um papel muda.

Principais pontos

• Uma matriz de permissões mapeia cada ferramenta para ações permitidas, escopo de dados e aprovador, com uma linha por ferramenta e nível de permissão.
• Comece pelo papel do agente e pelas tarefas recorrentes, não pela lista de ferramentas que o fornecedor disponibiliza.
• Separe permissões de leitura, rascunho e ação, e exija um aprovador humano nomeado para qualquer coisa que gaste dinheiro, altere um contrato ou contate um cliente pela primeira vez.
• Revise a matriz em uma agenda fixa e depois de cada incidente, porque o acesso tende a crescer em silêncio ao longo do tempo.
• Mantenha a matriz dentro das notas operacionais do agente, para que quem o opera possa conferir sem depender de quem o construiu.

Por que uma matriz vence uma lista de aplicativos conectados

Uma lista de aplicativos conectados diz o que está instalado. Uma matriz diz o que está permitido, e essas duas coisas se afastam rapidamente. As equipes costumam dar ao agente acesso total a uma ferramenta porque uma tarefa precisava de uma ação específica, e ninguém voltou para restringir. Meses depois, o agente pode apagar registros que só precisava ler.

O risco não se resume a erros. Um agente que lê e-mails recebidos, documentos de fornecedores ou páginas da web está lendo conteúdo escrito por pessoas que você não controla. As orientações da OWASP sobre injeção de prompt tratam esse texto não confiável como motivo para limitar o que o agente pode fazer com ele, e não como um problema que uma instrução bem escrita resolve. O lugar mais seguro para aplicar esse limite é na conexão com a ferramenta, onde a permissão é real, e não em uma frase dentro do prompt que o modelo pode ou não seguir.

A matriz também dá ao dono do negócio visibilidade do acesso. Em vez de perguntar à equipe técnica se o agente pode enviar e-mails, você lê uma linha e sabe.

Quais colunas o modelo precisa?

Mantenha o modelo pequeno o bastante para que alguém consiga revisá-lo em dez minutos. Cada linha de ferramenta deve conter estes campos:

• Ferramenta: o nome do sistema e a conta, conexão ou identidade de serviço específica que o agente usa.
• Ações permitidas: os verbos autorizados, como ler, pesquisar, criar rascunho, atualizar um campo nomeado, enviar ou excluir.
• Escopo de dados: os objetos, pastas, funis, grupos de clientes ou intervalos de datas que as ações podem tocar.
• Condições: limites como valor máximo, quantidade diária ou campos que nunca podem mudar.
• Aprovador: o papel nomeado que precisa confirmar ações fora do escopo rotineiro, e o canal onde essa confirmação acontece.
• Evidência: onde cada ação é registrada, para que uma pessoa possa auditar o que aconteceu e quando.
• Data de revisão: quando a linha foi conferida pela última vez contra o papel atual.

O campo de aprovador merece a maior atenção. Um cargo como “gerente comercial” é um ponto de partida, mas a matriz deve nomear a pessoa ou o substituto que responde quando o agente pede aprovação. Um pedido de aprovação sem ninguém por trás é um fluxo travado, e as equipes costumam reagir removendo a etapa de aprovação por completo.

Como montar a matriz de um agente?

Monte a matriz de dentro para fora, a partir do trabalho. Comece pelo papel do agente, depois percorra suas tarefas e, por fim, as ferramentas que essas tarefas exigem. Não parta do catálogo de ferramentas, porque isso gera uma linha para tudo o que o fornecedor oferece.

• Escreva o papel em uma frase e liste de três a cinco tarefas recorrentes que o agente deve concluir.
• Para cada tarefa, identifique as ferramentas de que ela precisa e remova qualquer ferramenta que seja apenas conveniente.
• Para cada ferramenta restante, liste o menor conjunto de ações que completa a tarefa.
• Restrinja o escopo de dados até que uma pessoa consiga explicar em uma frase por que cada objeto está incluído.
• Atribua um aprovador a toda ação que altere dinheiro, registros, compromissos com clientes ou direitos de acesso.
• Defina um critério de sucesso observável para cada tarefa, para saber se o acesso concedido é suficiente e não mais do que suficiente.
• Teste primeiro com acesso somente leitura, depois amplie uma linha de cada vez e registre cada mudança com o motivo.

A última etapa é onde a maioria das equipes perde a disciplina. Ampliar o acesso em pequenos passos mantém fácil a identificação da causa de qualquer problema. Ampliar tudo de uma vez torna o primeiro incidente difícil de explicar.

Ler, rascunhar ou agir: qual nível de permissão?

A maioria das linhas se encaixa em um de três níveis. Escolher o nível antes de escolher as ações mantém a matriz honesta.

• Se a tarefa só precisa de informação, conceda acesso de leitura no escopo mais restrito que responde à pergunta.
• Se a saída é uma proposta que uma pessoa vai revisar, conceda permissão para criar rascunho e nunca para enviar.
• Se a ação é reversível, de baixo risco e coberta por condições claras, o agente pode agir dentro dessas condições e registrar o resultado.
• Se a ação movimenta dinheiro, assina um documento, exclui dados, altera acessos ou contata um cliente pela primeira vez, exija um aprovador nomeado antes da execução.

Este guia é deliberadamente conservador. As equipes podem passar uma linha de rascunho para ação mais tarde, quando os registros mostrarem que o agente se comporta como o critério de sucesso espera. Fazer essa passagem antes de existir essa evidência é a origem mais comum de um incidente evitável. Para aprofundar essa divisão, veja Ler, rascunhar e enviar: três permissões diferentes de IA e Menor privilégio para agentes de IA: comece pelo acesso mínimo.

A identidade que o agente usa também importa. Um login pessoal compartilhado dá ao agente o mesmo alcance da pessoa que o possui, o que quebra a matriz. Uma identidade de serviço dedicada, com apenas os escopos concedidos, mantém a matriz e as permissões reais alinhadas. As compensações estão em Conta de serviço ou OAuth para agentes de IA: qual usar.

Cenário ilustrativo: um agente de cotações em um distribuidor de equipamentos

Cenário ilustrativo: um pequeno distribuidor de equipamentos quer que um agente prepare cotações para pedidos recebidos de clientes comerciais já existentes. A equipe escreve a matriz desta forma. O agente lê a conta do cliente e o território de vendas atribuído no CRM, e nada fora desse território. Ele consulta a tabela de preços vigente, mas não consegue editá-la. Ele cria rascunhos de cotação na ferramenta de orçamentos e não consegue enviá-los. Qualquer desconto além da tabela padrão precisa ser aprovado pelo gerente comercial, e o pedido segue para a fila de revisão do gerente com o histórico do cliente anexado. Cada rascunho e cada aprovação é registrado com o identificador do pedido.

A matriz também registra o critério de sucesso: a equipe de vendas aceita a maior parte dos rascunhos com apenas pequenos ajustes durante um período de teste, e nenhuma cotação sai sem uma ação de envio feita por uma pessoa. Quando um novo vendedor entra no território, a equipe atualiza uma única linha de escopo de dados, e não a configuração inteira. O objetivo do exemplo é a forma do registro, não um resultado específico. Quem lê a matriz consegue ver o que o agente pode tocar, quem decide e onde fica a evidência.

Como a Be Human mantém a matriz atualizada e o que revisar primeiro

A Be Human desenha agentes de IA personalizados, com identidade, memória, canais, ferramentas, permissões e contexto operacional sob controle humano. Um primeiro projeto define um papel útil, a memória e as ferramentas que esse papel precisa, os limites de aprovação e um critério de sucesso observável. A matriz de permissões é um resultado direto dessa definição. A operação contínua mantém a matriz precisa ao longo do tempo, por meio de revisão de permissões, manutenção das integrações e resposta a incidentes, para que as linhas sejam reavaliadas quando uma ferramenta muda, quando alguém da equipe troca de função ou quando a tarefa de um agente se expande.

Na maioria das empresas, a primeira revisão deve cobrir três pontos: qualquer linha com direito de envio, exclusão ou pagamento, qualquer linha em que o aprovador seja um papel sem pessoa nomeada e qualquer conexão que ainda use um login pessoal. Essas três verificações costumam revelar mais do que uma auditoria completa de todas as ferramentas. Se você ainda não tem certeza de qual tarefa merece um agente primeiro, o diagnóstico gratuito de IA da Be Human é um ponto de partida prático.

Perguntas frequentes

O que é uma matriz de permissões de ferramentas para agentes de IA? É uma tabela que lista cada ferramenta que um agente pode usar, as ações permitidas em cada uma, os dados que essas ações podem tocar e a pessoa que aprova tudo o que estiver fora da rotina. Ela transforma uma frase vaga, como “o agente tem acesso ao nosso CRM”, em um registro específico que alguém pode revisar e alterar. A maioria das equipes mantém a matriz em um documento compartilhado, junto das notas operacionais do agente.

Em que o menor privilégio é diferente de apenas limitar o prompt do agente? Um prompt é uma instrução que se pede ao modelo que siga, enquanto uma permissão é uma restrição que o sistema conectado aplica. O menor privilégio aplica a restrição na conexão com a ferramenta, então uma instrução enganosa não consegue ampliar o que o agente pode fazer. Regras no prompt ainda ajudam no comportamento, mas não devem ser o único controle.

Quem deve aprovar as ações do agente? O aprovador deve ser uma pessoa nomeada que entenda a consequência de negócio da ação, como um gerente comercial para descontos ou um responsável financeiro para pagamentos. Cada aprovador precisa de um substituto e de um canal claro, ou os pedidos de aprovação vão travar. Para ações de baixo risco e reversíveis, a aprovação pode ser uma regra registrada, e não uma revisão ao vivo.

Com que frequência a matriz deve ser revisada? Revise-a em uma agenda fixa e também depois de qualquer incidente, de qualquer mudança no papel do agente e de qualquer mudança nas pessoas que aprovam o trabalho dele. Uma revisão trimestral é um padrão razoável para papéis estáveis, e revisões mais frequentes são melhores quando as tarefas mudam com frequência. Cada revisão deve confirmar que todas as linhas ainda correspondem a uma tarefa real e que nenhuma linha concede mais acesso do que o critério de sucesso exige.

Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.