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

Ferramentas e integrações

Agente de IA no Gmail e Outlook: escopos que permanecem seguros

Dê ao agente de IA acesso ao Gmail ou Outlook limitado a pastas e ações, com aprovação humana, logs de auditoria e testes antes de entrar no ar.

Capa tipográfica do Be Human com o título: Agente de IA no Gmail e Outlook: escopos que permanecem seguros
Ilustração conceitual criada com IA · Be Human

Para dar a um agente de IA acesso seguro ao Gmail ou ao Outlook, conceda a permissão mais restrita que a tarefa exige e, em seguida, aplique os limites de pasta, marcador e ação na camada que fica entre o agente e a caixa de entrada. Os escopos do provedor normalmente valem para a conta inteira, então uma permissão somente leitura ou somente rascunho não limita sozinha o agente a uma pasta ou marcador. Restrinja o agente a um fluxo definido de mensagens, separe leitura, rascunho e envio, e registre cada ação para que uma pessoa possa conferir o trabalho.

Principais pontos

  • Comece por uma tarefa e um fluxo de e-mails, não pela conta inteira.
  • Peça separadamente as permissões de leitura, rascunho e envio, e evite controle total da caixa, a menos que a função realmente exija.
  • Aplique os limites de pasta e marcador na sua própria camada de ferramentas, porque a maioria dos escopos do provedor cobre a caixa inteira.
  • Mantenha o envio atrás de aprovação humana até que o agente passe por um conjunto de testes escrito.
  • Registre cada leitura e cada ação proposta com um motivo, para que um revisor consiga rastrear o que aconteceu.

Que acesso o agente realmente precisa?

A maior parte do trabalho útil com e-mail se divide em quatro atividades: ler mensagens, marcá-las, redigir respostas e enviar. Um agente de triagem de suporte, por exemplo, normalmente precisa ler as solicitações que chegam, aplicar um marcador interno e preparar um rascunho para uma pessoa aprovar. Raramente ele precisa enviar e-mails sozinho, e não tem motivo para enxergar conversas de folha de pagamento, jurídico ou assuntos pessoais que estejam na mesma caixa.

Antes de abrir qualquer conexão, escreva essas atividades em linguagem simples. Para cada uma, defina se o agente pode executá-la sozinho, se só pode executá-la após aprovação de uma pessoa ou se nunca deve executá-la. Essa lista é a base de todas as permissões seguintes. Se ela não cabe em poucas linhas, a tarefa ainda não está pronta para um agente. Para uma visão mais ampla de como um mesmo agente pode alcançar vários canais, veja conectar agente de IA ao e-mail sem colocar sua caixa em risco.

Por que os escopos do provedor não bastam

O modelo OAuth 2.0 do Google pede que a aplicação solicite escopos específicos, e o Gmail oferece escopos separados para leitura somente, alterações em mensagens e marcadores, criação de rascunhos e envio. O Microsoft Graph separa de forma parecida a leitura de e-mails, a leitura e escrita e o envio para o Outlook. Essas diferenças importam, e você deve sempre escolher a mais restrita que sustente a tarefa.

Na maioria dos casos, porém, esses escopos não restringem o acesso a uma única pasta ou marcador. Um escopo de leitura do Gmail geralmente permite ler mensagens em toda a conta, qualquer que seja o marcador. Uma permissão delegada do Outlook geralmente segue a caixa do usuário conectado. Por isso, os limites de pasta e marcador precisam ser aplicados em outro lugar. No Exchange Online, políticas de acesso de aplicativo podem limitar um registro de aplicativo a um conjunto definido de caixas ou grupos de segurança habilitados para e-mail, o que é um controle útil quando o agente roda como aplicação e não como usuário. Confira a documentação atual do provedor antes de depender de qualquer mecanismo específico, porque os controles disponíveis mudam. A documentação OAuth 2.0 do Google explica como os escopos são solicitados e concedidos, e é um bom ponto de partida para o lado do Gmail. Para comparar como ficam as configurações do Google Workspace e do Microsoft 365, veja integrar agente de IA ao Google Workspace ou Microsoft 365 com acesso mínimo.

O provedor decide o que a conexão consegue alcançar. Sua camada de ferramentas decide o que o agente tem permissão de pedir.

Plano passo a passo para definir o acesso à caixa

  • Primeiro, escolha uma função e um fluxo. Um exemplo prático é um marcador dedicado, com o nome de uma única fila, alimentado por um filtro que uma pessoa controla e pode alterar.
  • Segundo, quando o negócio permitir, dê ao agente uma caixa ou conta própria, para que a identidade dele nunca seja igual à do dono.
  • Terceiro, peça o escopo mais restrito do provedor para cada atividade e anote por que cada escopo é necessário.
  • Quarto, aplique o limite do marcador na ferramenta de leitura. A ferramenta aceita apenas o identificador aprovado do marcador e recusa qualquer outro pedido, não importa o que o modelo solicite.
  • Quinto, implemente o rascunho como criação de um objeto de rascunho, nunca como envio. O envio fica em uma ferramenta separada que não roda sem um registro de aprovação.
  • Sexto, defina como o agente trata remetentes desconhecidos, anexos e links, e quais casos ele deve passar para uma pessoa sem tentar responder.
  • Sétimo, registre cada leitura, alteração de marcador e rascunho com data e hora, identificador da mensagem, motivo e a regra que permitiu a ação.
  • Oitavo, execute um conjunto de testes escrito antes de entrar no ar, e repita-o após cada mudança de permissão ou de prompt.

Decida quais ações exigem aprovação

Use três níveis. O primeiro reúne as ações que o agente executa sozinho: ler mensagens dentro do marcador aprovado, aplicar um marcador interno e acrescentar uma nota ao registro interno do caso. O segundo reúne as ações que o agente prepara e uma pessoa aprova: respostas em rascunho, encaminhamento para uma equipe interna nomeada e a retirada de uma mensagem da fila. O terceiro reúne as ações que o agente nunca executa: enviar para endereços externos sem aprovação, apagar mensagens, alterar filtros ou regras de encaminhamento, compartilhar acesso com outras pessoas e qualquer coisa que envolva dinheiro, contratos ou assinaturas.

Um guia curto de decisão ajuda quando surge uma ação nova:

  • Se a ação muda o que alguém de fora da empresa recebe, ela exige aprovação.
  • Se a ação fica dentro da caixa, é fácil de desfazer e toca apenas o marcador aprovado, o agente pode executá-la sozinho.
  • Se a ação altera filtros, encaminhamentos, delegações ou permissões, ela continua com uma pessoa.
  • Se a ação compromete dinheiro, uma assinatura ou uma posição jurídica, ela continua com uma pessoa, mesmo que o rascunho esteja pronto.

A lógica por trás de separar rascunho e envio é tratada com mais profundidade em ler, preparar e enviar: três permissões diferentes de IA.

Como proteger o agente de instruções escondidas em e-mails?

E-mail é entrada não confiável. Qualquer remetente pode escrever um texto que parece uma instrução, inclusive uma mensagem que pede ao agente para encaminhar uma conversa ou ignorar suas regras. As orientações da OWASP sobre injeção de prompt recomendam tratar o conteúdo de fontes externas como dado, e não como comando, e desenhar o sistema de modo que um modelo persuadido ainda não consiga causar muito dano. Para agentes de caixa de e-mail, isso significa que endereços de destinatário tirados do texto da mensagem devem ser conferidos contra uma lista permitida, regras de encaminhamento não podem ser alteradas pelo agente, anexos são lidos de forma restrita e qualquer ação que saia da empresa passa pela etapa de aprovação.

Exemplo ilustrativo: um e-mail de fornecedor contém uma linha pedindo ao agente que envie o resumo mais recente do pedido para um endereço fora da empresa. O agente trata a linha como conteúdo a ser resumido, e não como pedido para agir. Ele cria um item de revisão para o responsável de compras, porque o endereço está fora da lista permitida e o pedido não veio de uma pessoa pelo canal aprovado do agente. Nenhuma mensagem sai da caixa, e o item de revisão registra o identificador da mensagem para conferência posterior.

A cartilha da OWASP sobre prevenção de injeção de prompt lista outros padrões, e a orientação da OWASP sobre autorização explica por que as verificações de permissão devem ficar em código que o modelo não consegue reescrever.

Como testar e revisar o acesso à caixa antes de entrar no ar?

Crie um marcador de teste com mensagens semeadas que cubram casos rotineiros, remetentes desconhecidos, uma mensagem pedindo envio externo, uma mensagem com instrução embutida no corpo e uma mensagem colocada logo fora do marcador aprovado. Escreva o resultado esperado de cada caso antes da primeira execução. Normalmente os resultados esperados são estes: leitura dentro do escopo é permitida, leitura fora do escopo é recusada, um rascunho é criado e um envio externo é bloqueado e encaminhado para revisão. Rode os testes em uma caixa de homologação, e não na caixa real, e repita-os sempre que um escopo, marcador, filtro ou prompt mudar.

Revise os registros como tarefa de operação, e não apenas como tarefa de desenvolvimento. Um dono de negócio ou responsável por operações deve conseguir ver o que o agente leu, o que rascunhou, o que propôs enviar e o que uma pessoa aprovou. Nos primeiros meses, revise os registros toda semana e, quando o padrão estiver estável e o conjunto de testes continuar passando, passe para um ritmo mensal. Qualquer leitura inesperada fora do marcador é um incidente, mesmo sem dano, porque mostra que um limite não se sustentou.

Em um projeto com a Be Human, a primeira entrega define uma função, o fluxo de e-mails que o agente pode ler, os marcadores que pode aplicar, os rascunhos que pode criar e as ações que sempre aguardam uma pessoa. O escopo do provedor é ajustado para a opção mais restrita que funcione, e as regras de pasta e ação são aplicadas na camada de ferramentas do agente, onde podem ser testadas. A operação gerenciada cobre revisões recorrentes de permissões, monitoramento dos registros, manutenção quando o provedor de e-mail ou a conexão mudam e resposta a incidentes caso algum limite falhe. O serviço é remoto e disponível em inglês e em português.

Se você ainda não tem certeza de qual tarefa de caixa de e-mail deve vir 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

Posso limitar um agente do Gmail a um único marcador? Normalmente não apenas pelo escopo do provedor, então o limite precisa ficar na sua própria camada de ferramentas. Crie um marcador dedicado alimentado por um filtro que uma pessoa controla, e faça a ferramenta de leitura do agente aceitar apenas o identificador desse marcador. Teste com mensagens fora do marcador para confirmar que a recusa acontece no código, e não só no prompt.

Um agente de IA deve enviar e-mails sozinho em algum momento? Só para um tipo de mensagem estreito e de baixo risco que uma pessoa tenha aprovado por escrito, como uma confirmação automática com texto fixo e regra fixa de destinatário. A maioria dos agentes de negócio deve preparar rascunhos para uma pessoa enviar, pelo menos até que o conjunto de testes e os registros mostrem comportamento estável por um período contínuo. Qualquer tipo novo de mensagem deve voltar ao nível de aprovação antes de ser ampliado.

O que o agente deve fazer se a conexão com a caixa expirar? O agente deve interromper a tarefa afetada, evitar tentar de novo com credenciais mais amplas e avisar uma pessoa com contexto suficiente para restabelecer a conexão com segurança. Mantenha a ação que falhou em uma fila para que possa ser revisada, em vez de repetida em silêncio. O processo para isso é descrito em o que um agente deve fazer quando uma conexão expira?.

Uma caixa dedicada é melhor que a caixa do dono? Na maioria dos casos, sim, porque a identidade, as permissões e os registros do agente ficam separados da correspondência pessoal e executiva do dono. Um endereço dedicado de suporte ou operações também facilita definir o fluxo, já que só chegam nele as mensagens que pertencem à função. Mantenha a caixa do dono totalmente fora do escopo do agente, a menos que uma tarefa específica e revisada exija um encaminhamento a partir dela.

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 →