Ir para conteúdo
be-human.ai
← Voltar ao blog

Ferramentas e integrações

Mapeamento de permissões para agentes de IA: quem usa cada ferramenta

Mapeie quem pode combinar usuário, agente e ferramenta, e alinhe cada permissão às regras de aprovação escritas pela empresa. Método passo a passo.

Capa tipográfica do Be Human com o título: Mapeamento de permissões para agentes de IA: quem usa cada ferramenta
Ilustração conceitual criada com IA · Be Human

Mapeamento de permissões é o processo de listar quais usuários, agentes e ferramentas podem interagir, em quais condições e com qual etapa de aprovação. Para um agente de IA, o mapa deve refletir as regras de aprovação que a sua empresa já escreveu, e não as permissões amplas que o fornecedor concede por padrão. Quando as duas coisas coincidem, cada ação em uma ferramenta pode ser rastreada até uma pessoa que decidiu que ela era permitida.

Principais pontos

  • Uma permissão é uma combinação: um papel solicitante, uma identidade do agente, uma ferramenta e uma classe de ação.
  • Comece pelas regras de aprovação que a empresa já escreveu e traduza cada uma delas em algo que a ferramenta consiga aplicar.
  • Conceda primeiro a ação mais restrita (leitura, depois rascunho, depois escrita) e nomeie um aprovador para cada escrita.
  • Revise o mapa em uma agenda fixa e de novo após qualquer nova ferramenta, mudança de papel ou incidente.
  • Teste pedidos permitidos e negados em cada linha, para que os registros mostrem os dois resultados.

O que uma permissão significa quando há um agente

Em uma empresa, uma permissão responde a uma pergunta simples: quem pode pedir a qual agente que use qual ferramenta para fazer o quê. Os agentes tornam essa pergunta mais difícil porque agem em nome de uma pessoa, mas normalmente têm credenciais próprias. Uma permissão concedida apenas ao agente permite que qualquer pessoa que consiga acioná-lo alcance a ferramenta. Já uma permissão concedida apenas ao usuário pode não cobrir o que o agente faz em tarefas de segundo plano, execuções agendadas ou mensagens de acompanhamento.

Por isso o mapa precisa cobrir combinações, e não objetos isolados. A linha “o agente pode ler registros de clientes” está incompleta. A versão útil diz qual papel pode disparar a leitura, qual identidade de agente a executa, quais sistema e campos estão envolvidos e se o resultado pode ser usado em uma escrita posterior. O OWASP Authorization Cheat Sheet defende a mesma ideia em termos gerais de software: o acesso deve ser verificado a cada requisição contra uma regra explícita, e não presumido a partir da interface que a pessoa, por acaso, usou.

Comece pelas regras de aprovação que você já escreveu

A maioria das empresas já tem regras de aprovação, mesmo que elas estejam em um procedimento financeiro, em uma política comercial ou em um e-mail curto do líder de operações. Uma regra pode dizer que reembolsos acima de um teto definido precisam da confirmação de um gerente, ou que contratos só são assinados por um diretor. Essas regras são a fonte de verdade. O mapa de permissões é apenas a tradução delas.

Reúna cada regra que toca um sistema que um agente poderia alcançar. Para cada uma, escreva cinco fatos: quem solicita a ação, quem aprova, qual sistema está envolvido, o que exatamente a ação altera e onde fica registrada a evidência da aprovação. Regras que terminam em “a equipe resolve” não são aplicáveis, então reescreva-as até que um papel nomeado possa ser verificado. Se uma regra não puder ser escrita dessa forma, isso é um sinal de que o processo precisa de uma decisão antes que qualquer agente toque nele.

Monte a matriz: usuários, agentes e ferramentas

Depois que as regras estão explícitas, a matriz tem seis colunas. Cada linha é uma combinação permitida, e toda combinação que não está na matriz é negada.

  • Solicitante: um papel nomeado, como gerente de conta ou auxiliar financeiro, nunca “todos da equipe”.
  • Agente: a identidade com que o agente roda, com nome e credenciais próprias.
  • Ferramenta e ação: uma ferramenta e uma classe de ação, como ler contatos ou criar um rascunho de fatura.
  • Condição: o limite que se aplica, como uma pasta, um canal ou um teto retirado da regra de aprovação.
  • Aprovador: o papel que precisa confirmar antes que uma escrita tenha efeito. Linhas de leitura podem deixar esse campo vazio.
  • Evidência: o lugar onde o pedido, a decisão e o resultado são registrados.

A maioria das linhas será de leitura, e esse é o formato esperado. Uma empresa com um mapa saudável tem muitas leituras restritas, menos rascunhos e pouquíssimas escritas diretas. Um modelo mais completo, com essas colunas e valores de exemplo, está na Matriz de permissões de ferramentas para agentes de IA: modelo prático.

Um método de sete passos para mapear permissões

O método abaixo funciona para um agente e um conjunto pequeno de ferramentas, e escala repetindo os mesmos passos para cada novo papel.

  • Passo 1: liste cada regra de aprovação que toca um sistema alcançável por um agente e marque as regras que ainda não estão escritas.
  • Passo 2: nomeie os papéis que solicitam trabalho e as pessoas que aprovam. Remova qualquer papel que não possa ser nomeado.
  • Passo 3: para cada ferramenta, liste suas ações e classifique-as em três grupos: leitura, rascunho e escrita. Mantenha exclusões e pagamentos em uma classe própria, pois carregam o maior risco.
  • Passo 4: crie uma linha para cada combinação de solicitante, agente, ferramenta e classe de ação.
  • Passo 5: associe uma condição e um aprovador a cada linha de escrita. Uma linha de escrita sem aprovador é uma decisão sem resposta, não uma permissão em aberto.
  • Passo 6: traduza cada linha no mecanismo que a ferramenta suporta, como um escopo de token, uma permissão de pasta ou uma restrição de canal. Quando a ferramenta não consegue aplicar uma linha, ela vira uma regra de processo, com uma pessoa nomeada que a confere.
  • Passo 7: execute um pedido permitido e um pedido negado para cada linha e guarde os resultados junto ao mapa.

A tradução do passo 6 é onde a maioria das divergências aparece. O controle de acesso do lado da ferramenta costuma ser mais grosseiro do que a regra de negócio, então a lacuna precisa ser fechada por um escopo mais estreito ou por uma etapa explícita de aprovação no fluxo de trabalho.

[Marcador de imagem]

Como uma divergência aparece na prática

Cenário ilustrativo: um líder de atendimento escreve que os agentes podem rascunhar respostas para clientes, mas só ele pode enviá-las. A integração é configurada com uma única credencial que permite criar rascunhos e também enviar mensagens. O mapa tem uma linha de rascunho e uma linha de envio, com o líder de atendimento como aprovador, mas a credencial permite enviar sem qualquer aprovação. O registro mostra mensagens enviadas pela identidade do agente, sem aprovação alguma, porque a ferramenta nunca pediu uma.

A correção não é um prompt melhor. O escopo de envio precisa ser separado do escopo de rascunho, ou a ação de envio precisa passar por uma etapa de aprovação que a própria ferramenta aplique. O mesmo padrão vale para agendas, pastas compartilhadas e canais de chat. Para um olhar mais detalhado sobre a separação entre rascunho e envio, veja Ler, preparar e enviar: três permissões diferentes de IA.

Como a Be Human trata permissões em operações gerenciadas

A Be Human projeta infraestrutura de IA personalizada, na qual cada agente mantém sua identidade, memória, canais, ferramentas, permissões e contexto operacional sob controle humano. Uma primeira implantação define um papel útil, a memória e as ferramentas que esse papel precisa, seus limites de aprovação e um critério de sucesso observável. O mapa de permissões é produzido como parte dessa definição, para que a primeira integração já reflita as regras que a empresa escreveu.

Em operações gerenciadas, o mesmo mapa se torna um documento de trabalho. As revisões de permissões o comparam com as ferramentas e papéis atuais, a manutenção das integrações o atualiza quando um fornecedor muda um escopo ou uma API, e a resposta a incidentes usa os registros de pedidos negados para descobrir onde um limite falhou. O serviço é prestado remotamente, em inglês e em português.

Mantendo o mapa atualizado

As permissões se desviam com o tempo. Pessoas mudam de função, ferramentas acrescentam escopos, fornecedores renomeiam ações e novos canais são conectados. Um mapa que estava correto no lançamento pode ficar errado em poucas semanas. Por isso, defina um ponto fixo de revisão e acrescente gatilhos que não esperam o calendário: uma mudança de papel, uma nova ferramenta, um novo canal ou qualquer incidente em que uma ação foi permitida quando não deveria. Guarde os registros de pedidos negados, porque eles mostram onde as pessoas esperavam um acesso que o agente nunca recebeu, e muitas vezes esse é o primeiro sinal de que uma regra precisa ser reescrita. Para canais de chat em particular, a lógica está em Permissões de agente de IA no Slack: canais, escopos e aprovadores. Se ainda não estiver claro qual tarefa única deve ir primeiro, o diagnóstico gratuito de IA da Be Human pode ajudar a encontrar a primeira tarefa que vale entregar a um agente.

Perguntas frequentes

Em que o mapeamento de permissões difere de uma matriz de permissões? Uma matriz de permissões normalmente lista o que a ferramenta permite, enquanto um mapa de permissões lista quais combinações de pessoa, agente, ferramenta e ação a sua empresa aprovou. O mapa parte das regras de negócio e depois verifica se a ferramenta consegue aplicá-las. Na prática, para um líder de operações, o mapa é o documento mais útil, porque mostra as lacunas entre a política e a configuração.

O agente deve ter identidade própria ou usar o login do funcionário que pediu o trabalho? Sempre que a ferramenta permitir, dê ao agente uma identidade própria, para que suas ações sejam separadas nos registros e possam ser revogadas sem afetar pessoas. O acesso delegado pelo login de alguém é mais difícil de auditar e tende a carregar mais permissões do que a tarefa exige. Quando a ferramenta só suporta delegação, registre qual pessoa autorizou a conexão e limite o escopo com rigor.

Com que frequência o mapa deve ser revisado? Revise-o em uma agenda fixa que acompanhe a frequência com que seus papéis e ferramentas mudam, e sempre após uma mudança de papel, uma nova integração ou um incidente. Mantenha a revisão curta e específica: verifique se cada linha de escrita tem aprovador, confira cada escopo contra a ferramenta atual e leia o registro de pedidos negados em busca de padrões. Um mapa revisado em passos pequenos e regulares se mantém mais próximo da realidade do que um mapa refeito uma vez por ano.

Precisamos mapear permissões antes que um agente tenha acesso de escrita a qualquer coisa? Sim, e este é o melhor momento para fazer isso. Um agente somente de leitura ainda expõe dados de clientes, financeiros ou internos, então suas leituras precisam de linhas com solicitantes e condições. Escrever o mapa primeiro também define o que o agente poderá rascunhar depois, o que impede que um piloto somente de leitura se transforme silenciosamente em uma integração de escrita.

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.

Menos tarefas. Mais espaço para você.

Traga o trabalho para o qual falta tempo.

Agende uma conversa e teste 7 dias grátis um agente de IA personalizado ↗Ou faça o diagnóstico gratuito de IA →