Lista de ferramentas permitidas para agentes: quem edita e como ela muda
Como manter uma lista de ferramentas permitidas para cada papel de agente de IA, definir quem pode editá-la e revisar cada mudança antes da produção.

Uma lista de ferramentas permitidas é uma relação versionada, com negação por padrão, dos recursos que cada papel de agente pode acionar. Quem aplica essa lista é o harness, e não um pedido feito no prompt. Para mantê-la, dê a cada papel uma lista curta ligada à tarefa escrita, nomeie um dono que responda por ela e envie cada inclusão ou remoção pelo mesmo caminho de revisão, teste e publicação que você usa para software. Feito assim, o agente não consegue ampliar o próprio alcance, e cada mudança deixa um registro que alguém consegue explicar.
Principais pontos
- Uma lista de ferramentas permitidas é uma relação com negação por padrão, por papel de agente, aplicada pelo harness e não por instruções no prompt.
- Comece cada papel com o menor número de ferramentas que a tarefa escrita exige, e amplie a lista somente com evidência registrada.
- Nomeie um dono responsável por papel e separe quem pede uma ferramenta de quem aprova.
- Revise mudanças na lista como se fossem código: motivo escrito, teste com casos de falha, aprovação, nota de versão e caminho de reversão.
- Audite a lista em produção em uma periodicidade fixa, para identificar cedo qualquer desvio da versão aprovada.
O que a lista controla e o que não controla
Uma lista de ferramentas responde antes de tudo a uma pergunta: quais ferramentas este agente pode chamar? Aqui, ferramenta significa qualquer capacidade que o harness expõe, como ler o registro de um cliente, criar uma fatura em rascunho, enviar um e-mail, consultar uma agenda ou executar um script. Se a ferramenta não estiver na lista daquele papel, o harness recusa a chamada, independentemente do que o modelo pedir ou do que o prompt disser.
Isso pesa mais quando o agente lê conteúdo que não controla. Um texto dentro de um e-mail ou de uma página da web pode tentar induzir o agente a chamar uma ferramenta que ele não deveria usar. Se o harness recusar essa chamada porque a ferramenta não consta na lista do papel, a instrução não produz efeito. As orientações da OWASP sobre injeção de prompt tratam a limitação do que o modelo consegue fazer como uma defesa central, e a lista de ferramentas é o ponto onde esse limite é aplicado.
A lista não substitui o restante do desenho de controles. Ela decide quais ferramentas existem para um papel. Não decide quais argumentos uma ferramenta aceita, quais registros ela pode tocar nem se uma pessoa precisa confirmar uma ação de alto impacto. Esses controles pertencem aos esquemas, às portas de permissão e às regras de aprovação. Trate a lista como a fronteira mais grossa, e espere fronteiras mais finas por trás dela.
Mantenha essa distinção clara nas conversas com fornecedores e equipes internas. A frase "o agente tem acesso ao CRM" é vaga demais para revisar. A frase "o papel de triagem de suporte pode ler os campos do chamado e adicionar notas internas, e não pode enviar mensagens externas" pode ser verificada linha por linha.
Monte a lista papel por papel
Comece pela função que o papel exerce, e não pelas ferramentas que você já tem. Escreva a tarefa em uma frase e liste as ações que essa frase exige. Cada ação corresponde a uma ferramenta. O que a frase não exige fica de fora da lista.
Cenário ilustrativo: uma equipe quer um agente que faça a triagem de e-mails de suporte, classifique cada um e prepare rascunhos de resposta para uma pessoa aprovar. A lista desse agente pode incluir leitura da mensagem recebida, leitura do histórico do chamado, inclusão de uma etiqueta interna e criação de um rascunho de resposta. Não incluiria envio de e-mail, emissão de reembolso nem alteração de dados de cobrança. A ferramenta de rascunho é útil, mas o envio fica com uma pessoa, então a ferramenta de envio fica fora da lista desse papel.
Ao lado da lista, escreva um cartão do papel. Ele registra o nome do papel, a finalidade e o dono. Traz cada ferramenta permitida com um motivo em uma linha, as ferramentas excluídas de propósito e a evidência que justificaria incluir uma ferramenta no futuro. Os motivos importam. Uma ferramenta sem motivo tende a sobreviver a todas as revisões, porque ninguém se lembra por que foi adicionada.
Os nomes e as descrições das ferramentas também influenciam o funcionamento da lista. O agente escolhe entre as ferramentas que vê, então um conjunto pequeno de ferramentas com nomes claros é mais fácil de usar corretamente do que um conjunto grande com nomes parecidos. As orientações da Anthropic sobre como escrever ferramentas para agentes defendem o mesmo ponto: ferramentas distintas e bem descritas. Para o lado dos nomes, veja nomes de ferramentas para agentes de IA: nomes, descrições e esquemas claros.
Defina quem pode editar a lista
A maioria das falhas de lista de ferramentas é falha de responsabilidade. A lista é editada por quem estiver na sala quando surge a necessidade de uma ferramenta, e ninguém consegue explicar a mudança meses depois. Separe explicitamente três papéis.
- O solicitante é a pessoa que precisa de uma nova capacidade para um papel e registra a tarefa que ela atende.
- O dono é a pessoa responsável pelo papel, normalmente o líder do processo de negócio que o agente apoia. O dono aprova ou rejeita inclusões e remoções.
- O aprovador de risco é alguém de fora da equipe que verifica qualquer ferramenta capaz de movimentar dinheiro, enviar dados para fora da empresa ou alterar direitos de acesso. Dependendo da ferramenta, costuma ser um responsável por segurança ou finanças.
Disso decorrem três regras. Ninguém aprova o próprio pedido. Engenheiros podem implementar uma mudança, mas não podem publicá-la sem a aprovação do dono. Remover uma ferramenta segue o mesmo caminho de incluí-la, porque a remoção altera o que o agente pode fazer e pode quebrar um fluxo do qual alguém depende.
O acesso à configuração do harness deve ficar restrito a um grupo pequeno. O agente não deve poder editar a própria lista, e nenhuma ferramenta que ele consegue chamar deve poder fazê-lo. As orientações de autorização da OWASP descrevem o princípio geral de aplicar decisões de acesso em um lugar que quem faz o pedido não consegue modificar. Aplique esse princípio ao arquivo ou serviço que o harness lê para decidir se uma chamada é permitida.
Revise as mudanças antes que cheguem à produção
Cada mudança deve chegar como uma proposta escrita, sempre com as mesmas partes. Quem revisa precisa conseguir decidir em poucos minutos, sem reunião. A sequência de revisão funciona melhor nesta ordem:
- Escreva a proposta: papel, ferramenta, tarefa que ela atende e o que o agente fará com ela.
- Classifique a ferramenta pelo impacto: somente leitura, escrita em dados internos, escrita em dados externos, movimentação de dinheiro ou alteração de acesso.
- Confronte a proposta com o cartão do papel e explique por que uma opção mais restrita não funciona.
- Obtenha a aprovação do dono e, para qualquer ferramenta além de somente leitura, a do aprovador de risco.
- Execute a mudança em um ambiente de teste com as tarefas de amostra do papel, incluindo tarefas que devem falhar.
- Registre a versão aprovada com uma nota de versão que informe a mudança, os aprovadores e o motivo.
- Publique, mantendo a versão anterior pronta para reversão.
O teste com casos de falha é a etapa que as equipes mais pulam. Uma mudança precisa provar duas coisas: a nova ferramenta funciona, e o agente continua bloqueado em todas as ferramentas que não deveria alcançar. Os testes negativos detectam os casos em que uma ferramenta adicionada torna silenciosamente possível uma ação vizinha. Portas de aprovação para ações específicas de alto impacto ficam ao lado da lista, e aprovação humana em agentes de IA: onde colocar cada etapa no harness explica onde elas devem estar.
Teste, publique e reverta mudanças na lista
Testar fica mais barato quando o ambiente se parece com a produção. Execute o papel em uma cópia de homologação com registros fictícios, para que uma escrita equivocada não chegue a um cliente real. Guarde os casos de teste no mesmo repositório do cartão do papel, para que os dois mudem juntos e o revisor os veja lado a lado.
Publique cada lista com um identificador de versão. Quando o agente se comporta de forma inesperada, a primeira pergunta é qual lista estava ativa naquele momento. Se ninguém consegue responder, o harness não tem um histórico utilizável. A reversão deve restaurar exatamente a versão anterior, e não uma aproximação reconstruída de memória.
Acrescente um alarme para padrões suspeitos. Se um papel começar a chamar uma ferramenta recém-liberada com muito mais frequência do que os testes previram, ou chamar ferramentas em uma ordem que o cartão do papel não descreve, o harness deve pausar o papel e avisar o dono. Esse alarme não resolve o problema. Ele impede que o dano se espalhe enquanto o dono decide qual é a resposta correta.
Audite a lista em produção e feche as lacunas
Listas de ferramentas se desviam com o tempo. Alguém adiciona uma ferramenta em uma emergência e esquece de removê-la. Uma atualização do fornecedor muda o nome de uma ferramenta, e o harness passa a acionar a errada. O trabalho de um papel se expande informalmente enquanto a lista continua igual. Uma auditoria recorrente encontra essas lacunas antes que elas causem um incidente.
Uma auditoria prática cobre estes pontos:
- Compare a lista em produção com a última versão aprovada e liste cada diferença.
- Confirme que cada ferramenta permitida ainda aparece no cartão do papel, com um motivo atual.
- Identifique as ferramentas que não foram chamadas durante o período revisado e proponha a remoção.
- Revise as chamadas recusadas. Um conjunto de recusas pode indicar que o papel precisa de uma ferramenta pelo caminho adequado, ou que as entradas estão empurrando o agente para uma ferramenta que ele não deveria usar.
- Confirme que o dono e o aprovador de risco de cada papel continuam em funções.
Ferramentas sem uso são um risco silencioso. Cada uma é uma capacidade que existe sem motivo atual, e removê-las costuma ser a melhoria de segurança mais barata disponível. O NIST AI Risk Management Framework trata esse tipo de trabalho como governança contínua, e não como configuração única, o que combina com listas que precisam ser mantidas à medida que os papéis mudam.
A Be Human desenha e opera essa camada como parte de operações gerenciadas. Em um primeiro projeto, definimos o papel, as ferramentas e a memória de que ele precisa, os limites de aprovação e um critério de sucesso observável, e depois mantemos a lista como um registro versionado, com donos nomeados. O trabalho contínuo pode incluir revisão de permissões, avaliações recorrentes, manutenção de integrações e mudanças controladas que seguem o mesmo caminho de revisão descrito aqui, para que sua equipe veja quem aprovou cada capacidade e por que o agente a possui.
Se ainda não está claro qual papel deve receber uma lista primeiro, o diagnóstico gratuito de IA da Be Human ajuda a identificar a primeira tarefa que vale entregar a um agente.
Perguntas frequentes
Qual é a diferença entre uma lista de permissões e uma lista de bloqueios para agentes de IA? Uma lista de permissões libera apenas as ferramentas nomeadas nela, e todas as outras são recusadas por padrão. Uma lista de bloqueios libera tudo, exceto as ferramentas nomeadas, o que significa que qualquer ferramenta nova fica disponível até que alguém lembre de bloqueá-la. Para agentes que podem agir sobre sistemas do negócio, a negação por padrão é o ponto de partida mais seguro, porque torna cada nova capacidade uma decisão visível.
O agente pode pedir ferramentas que não tem? Ele pode solicitar uma em linguagem simples, por exemplo explicando que precisa de um registro que não consegue ler. O pedido deve ir ao solicitante e ao dono pelo processo de proposta, e não ser registrado no harness como uma permissão concedida pelo próprio agente. A capacidade de descrever uma necessidade é útil, mas a capacidade de conceder acesso a si mesmo é justamente o que a lista existe para impedir.
Quantas ferramentas um único papel deve ter na lista? Não existe um número universal, mas um papel que precisa de muitas ferramentas normalmente tem um problema de escopo. Se o cartão do papel não consegue explicar cada ferramenta em uma linha, talvez o papel deva ser dividido ou reduzido. Conjuntos menores e bem descritos são mais fáceis de revisar, mais fáceis de testar e mais fáceis de o agente usar corretamente.
Precisamos de uma lista separada para o ambiente de teste? Em geral, a mesma versão da lista deve ser testada na homologação e depois promovida sem alterações para a produção. Diferenças entre ambientes são fonte de surpresas e dificultam dizer qual configuração foi aprovada. Qualquer configuração específica do ambiente, como o endereço do sandbox, deve ser declarada na configuração, e não tratada com edições manuais na lista.
Seu próximo passo
Descubra primeiro onde um agente de IA cabe na sua empresa.
Faça o diagnóstico gratuito de IA da Be Human. Algumas perguntas sobre o seu trabalho mostram qual tarefa entregar primeiro a um agente, o que ele precisa saber e onde uma pessoa aprova.
Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.


