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

Ferramentas e integrações

Agente de IA acessando o Google Drive: escopos por pasta e tipo

Veja como limitar um agente de IA a pastas e tipos de arquivo específicos no Google Drive e como revisar esse escopo quando a estrutura de pastas mudar.

Capa tipográfica do Be Human com o título: Agente de IA acessando o Google Drive: escopos por pasta e tipo
Ilustração conceitual criada com IA · Be Human

Para dar a um agente de IA acesso ao Google Drive com segurança, conceda apenas as pastas e os tipos de arquivo que o trabalho dele exige, defina separadamente os direitos de leitura e de escrita e revise essa fronteira sempre que a estrutura de pastas mudar. Comece mapeando o papel do agente para uma lista curta de pastas compartilhadas e depois aplique essa lista tanto nas configurações de compartilhamento quanto nas chamadas de ferramenta do próprio agente. Uma pessoa nomeada deve ser responsável pelo escopo e verificá-lo em uma agenda fixa, porque as permissões do Drive seguem a árvore de pastas, e a árvore não para de mudar.

Principais pontos

  • Parta do trabalho: liste as pastas e os tipos de arquivo que o agente precisa, nunca o drive inteiro por padrão.
  • Conceda leitura e escrita separadamente, e dê escrita apenas a uma pasta dedicada de rascunhos ou revisão, quando escrever fizer parte do papel.
  • Filtre por tipo de arquivo dentro das ferramentas do agente, para que atalhos, exportações e formatos inesperados fiquem fora de alcance.
  • Trate renomeações, movimentações, novas subpastas e mudanças de compartilhamento como eventos de escopo que disparam uma revisão.
  • Mantenha um aprovador nomeado e um critério de sucesso por escrito, para que cada mudança de escopo seja uma decisão e não um efeito colateral.

Por que um acesso ao drive inteiro é o padrão errado

Compartilhar uma pasta de nível superior com um agente é a forma mais rápida de fazê-lo funcionar, e também a mais rápida de dar a ele mais do que ele precisa. No Google Drive, os arquivos herdam o compartilhamento da pasta que os contém. Um agente com acesso a uma pasta raiz enxerga todas as subpastas abaixo dela, incluindo arquivos antigos, exportações pessoais e rascunhos que ninguém aprovou. Arquivos individuais também podem ser compartilhados para fora da pasta, de modo que a fronteira da pasta, sozinha, não mostra tudo o que o agente consegue alcançar.

O princípio que governa isso é o menor privilégio: o agente deve ter o menor conjunto de permissões que lhe permita cumprir o papel. Aplicado ao Drive, isso significa escolher pastas pela finalidade e não pelo lugar onde a equipe guarda a maioria dos arquivos. Uma pasta de propostas em andamento é um escopo sensato. O drive compartilhado inteiro não é, a menos que o papel realmente toque em cada documento dele. A abordagem mais ampla de conceder apenas o necessário a um agente está descrita em integração com Google Workspace e Microsoft 365.

Mapeie o papel para pastas e tipos de arquivo primeiro

Antes de alterar qualquer configuração de compartilhamento, escreva o que o agente faz e quais documentos ele precisa para fazer isso. Esse mapa passa a ser a referência de todas as revisões seguintes, então mantenha-o curto o bastante para que um responsável o leia em poucos minutos. Siga esta ordem:

  • Escreva uma frase descrevendo o papel e o resultado que ele produz, como um resumo para um lead de vendas ou um rascunho para a fila de revisão de contratos.
  • Liste cada pasta de onde o papel lê, descrita pela finalidade e pelo responsável, não apenas pelo nome.
  • Liste cada pasta onde o papel escreve. Essa lista deve ser menor que a de leitura, idealmente limitada a um único local de rascunhos.
  • Para cada pasta, indique os tipos de arquivo que o papel realmente usa, como Google Docs, Google Sheets, PDFs ou apresentações. Tudo o que não for citado está fora do escopo por padrão.
  • Marque cada pasta que contenha dados pessoais, financeiros ou contratuais, e decida se o agente precisa dela ou apenas de uma cópia com dados ocultos.
  • Registre por escrito qual responsável humano confirmou a lista, para que a aprovação possa ser rastreada depois.

Qualquer coisa que não apareça no mapa fica excluída. Essa única regra evita a maior parte dos alcances acidentais.

Como separar escopos de leitura e de escrita

O modelo OAuth 2.0 do Google permite que uma aplicação peça um nível específico de permissão, em vez de controle total sobre a conta. No Drive, a diferença importa: uma permissão somente de leitura não consegue modificar arquivos, enquanto uma permissão mais ampla pode criar, editar e excluir. Peça o escopo mais restrito que cubra o papel e não solicite um mais amplo por precaução, caso uma tarefa futura precise dele. Quando uma tarefa futura realmente precisar de mais, isso deve disparar uma nova aprovação, e não um alargamento silencioso da conexão existente.

Verifique duas camadas. O escopo do token define o que a conexão do agente pode fazer, e o papel de compartilhamento em cada pasta define o que a conta pode fazer ali. Valide as duas em um teste, porque uma divergência entre elas é o tipo de problema que fica escondido até alguém ler os registros. Decida também se o agente atua por uma conta de serviço com acesso a pastas específicas ou por uma concessão delegada a um usuário. Essa escolha muda quem aparece como autor nos registros e como o acesso é revogado, por isso merece uma decisão própria, como explicado em conta de serviço ou OAuth para agentes de IA.

Um padrão de partida viável é leitura apenas nas pastas de origem, escrita em uma única pasta de rascunhos e nenhuma escrita em pastas de arquivo morto, modelos ou políticas. O artigo complementar sobre acesso do agente de IA ao Google Drive por pasta aprofunda os próprios níveis de permissão.

Filtre por tipo de arquivo dentro das ferramentas do agente

A fronteira da pasta indica onde o agente pode procurar. Ela não indica quais arquivos valem a leitura. Coloque o filtro na própria ferramenta: o agente pede o conteúdo de uma pasta pelo ID da pasta-mãe e pelo tipo de arquivo, recebe primeiro os metadados e solicita o conteúdo apenas dos tipos aprovados. Uma ferramenta que lista somente a pasta permitida, devolve nome, tipo e data da última alteração, e lê o conteúdo apenas em formatos autorizados, é muito mais fácil de auditar do que uma busca aberta pelo drive.

Regras típicas incluem permitir Google Docs e Sheets nativos, e PDFs somente quando o papel precisar deles. Exclua atalhos, a menos que você tenha verificado cada destino, porque um atalho pode apontar para um arquivo fora da pasta permitida. Recuse arquivos acima de um tamanho acordado e devolva um erro claro que o agente possa reportar a uma pessoa, em vez de tentar de novo em silêncio. Registre cada leitura com o ID da pasta e o ID do arquivo, para que um responsável veja o que o agente acessou.

Trate o texto dentro dos documentos como dado, não como instrução. Um arquivo em uma pasta permitida pode conter frases escritas para manipular um agente, e a ferramenta nunca deve deixar o conteúdo de um documento alterar o escopo, a lista de pastas ou as regras de aprovação.

Cenário ilustrativo: uma pasta de contratos que é reorganizada

Cenário ilustrativo, não é um exemplo de cliente: uma pequena equipe de operações guarda contratos em uma pasta chamada Contratos, com duas subpastas, Ativos e Arquivo. O agente lê Ativos e grava resumos em uma pasta Rascunhos de Revisão. Depois, a equipe renomeia Ativos para Vigentes e cria uma nova subpasta chamada Renovações dentro de Contratos, movendo para ela alguns PDFs que estavam em Arquivo. A ferramenta do agente foi configurada pelo nome das pastas, então ou falha, ou resolve para o lugar errado. Enquanto isso, a nova pasta Renovações fica sob Contratos e herda o compartilhamento, o que significa que o agente agora consegue ler renovações assinadas que nunca deveria resumir. Parte desses arquivos são cópias digitalizadas com dados pessoais.

Nada falhou de forma visível. O problema apareceu somente quando o responsável comparou o registro de leitura do agente com o mapa de pastas. A correção foi direta: apontar a ferramenta para os IDs das pastas em vez dos nomes, excluir a nova subpasta até que o responsável a aprove e incluir uma revisão de escopo no processo de renomear ou reorganizar pastas.

Como revisar o escopo quando a estrutura de pastas muda

O desvio de escopo costuma vir de trabalho comum: uma pasta é reorganizada, um arquivo é compartilhado com um novo colega ou uma equipe muda de responsável. Trate esses eventos como gatilhos de revisão, não como ruído de fundo. Revise o escopo sempre que:

  • Uma pasta dentro do escopo for renomeada, movida, dividida ou unida.
  • Uma nova subpasta aparecer dentro de uma pasta do escopo.
  • Um arquivo for movido para dentro ou para fora de uma pasta do escopo.
  • O compartilhamento de uma pasta ou arquivo mudar, incluindo o compartilhamento por link.
  • Um novo tipo de arquivo aparecer, como imagens digitalizadas ao lado de documentos nativos.
  • O responsável por uma pasta mudar, ou a pessoa que aprovou o escopo sair da empresa.
  • O papel do agente ou o critério de sucesso mudar.

Quando um gatilho disparar, execute sempre a mesma verificação curta. Compare a árvore atual de pastas com o mapa escrito, usando IDs de pasta e não nomes. Marque como excluída toda subpasta desconhecida até que o responsável a aprove por escrito. Confirme o compartilhamento efetivo de itens novos ou movidos, e não apenas o da pasta-mãe. Faça uma leitura bem-sucedida de um arquivo conhecido em cada pasta permitida e uma tentativa de leitura em uma pasta que deveria estar bloqueada, e confirme que o bloqueio se mantém. Depois, atualize o mapa e registre quem aprovou a mudança e por quê.

Se você não consegue saber se uma nova pasta pertence ao escopo, exclua-a por enquanto. Ampliar o acesso depois é uma mudança controlada, com responsável e registro. Descobrir, depois do fato, que um agente leu material sensível é um incidente, e uma revisão muito mais cara.

Como a Be Human trata escopos do Drive em operações gerenciadas

A abordagem da Be Human começa com o mesmo mapa descrito acima. Em um primeiro projeto, o papel, as pastas e os tipos de arquivo de que ele precisa, os limites de aprovação e um critério de sucesso observável são definidos em conjunto, de modo que cada permissão tenha uma finalidade declarada antes de ser concedida. Em operações gerenciadas, que podem incluir monitoramento, avaliações recorrentes, revisão de permissões e resposta a incidentes, o escopo continua em revisão depois de definido. Mudanças nas pastas disparam uma verificação de permissões, os registros de leitura do agente são acompanhados em busca de acessos fora do mapa, e qualquer coisa fora da fronteira segue uma resposta definida. Incluir uma pasta passa pela mesma etapa de aprovação da concessão original. Se você não tem certeza de qual pasta deve receber a primeira tarefa que vai entregar a um agente, o diagnóstico gratuito de IA da Be Human pode ajudar a encontrá-la.

Perguntas frequentes

É possível limitar um agente de IA a uma única pasta compartilhada no Google Drive? Sim. Compartilhe apenas a pasta necessária com a conta do agente, solicite as permissões mais restritas que o papel permite e faça a ferramenta consultar pelo ID dessa pasta. Confirme em um teste que um arquivo fora da pasta não pode ser lido, porque atalhos e arquivos compartilhados diretamente podem ampliar o alcance além da pasta.

Um agente deve algum dia ter acesso de escrita ao Google Drive? Somente quando escrever fizer parte do papel, e geralmente em uma única pasta de rascunhos ou de revisão. Alterações em documentos de origem, modelos ou arquivos morto devem passar por uma pessoa ou por uma etapa explícita de aprovação. Mantenha a permissão de escrita separada da de leitura, para que uma mudança em uma não amplie a outra silenciosamente.

O que acontece quando uma pasta é renomeada ou movida? Se o agente se refere às pastas pelo nome, ele pode falhar ou resolver para o local errado, por isso refira-se às pastas pelo ID. Novas subpastas e arquivos movidos podem herdar o compartilhamento da nova pasta-mãe, o que pode ampliar o acesso sem que ninguém perceba. Revise a árvore após cada reorganização e exclua o que for desconhecido até que o responsável confirme.

Com que frequência um escopo do Drive deve ser revisado? Revise sempre que ocorrer um gatilho, como uma reorganização, uma mudança de compartilhamento, uma troca de responsável ou um novo tipo de arquivo. Mantenha também uma revisão periódica em uma agenda mantida pelo responsável da pasta, com uma frequência compatível com o ritmo real de mudança das pastas. Faça cada revisão curta e por escrito, para que a próxima pessoa veja o que foi verificado e o que foi decidido.

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 →