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

Ferramentas e integrações

Acesso do agente de IA ao Google Drive: separe leitura e escrita por pasta

Conceda ao agente acesso por pasta no Google Drive, com permissões de leitura e escrita separadas e uma revisão periódica que detecta desvios de permissão.

Capa tipográfica do Be Human com o título: Acesso do agente de IA ao Google Drive: separe leitura e escrita por pasta
Ilustração conceitual criada com IA · Be Human

Para dar acesso de um agente de IA ao Google Drive, compartilhe apenas as pastas específicas de que ele precisa, usando a identidade Google própria do agente, nunca um login pessoal e nunca a raiz do drive. Use o papel somente leitura na pasta que guarda o material de origem e uma pasta separada, com permissão de escrita, para rascunhos ou saídas. Assim o agente não consegue alterar os originais com que trabalha. Depois, revise a lista de compartilhamento em uma cadência fixa, porque as permissões de pasta vão se desviando aos poucos conforme as pessoas movem arquivos, criam links e trocam de função.

Principais pontos

  • Dê ao agente uma pasta para leitura e outra, diferente, para escrita, e nunca compartilhe uma pasta pai que contenha as duas.
  • Use uma identidade de agente dedicada, para que cada ação no Drive possa ser rastreada até o agente e não até uma pessoa.
  • Atribua o papel de Leitor (Viewer) ao material de origem e o papel de Editor apenas a uma pasta de saídas que uma pessoa revisa antes de qualquer coisa sair dela.
  • Compare o estado real de compartilhamento com uma matriz de acesso aprovada toda semana, e faça com que uma pessoa nomeada seja responsável por cada diferença.
  • Trate qualquer movimentação, cópia, troca de link ou transferência de propriedade em uma pasta liberada como uma mudança que exige verificação imediata.

Por que o escopo por pasta funciona melhor que o compartilhamento arquivo por arquivo

As permissões do Google Drive descem na hierarquia. Quando uma pasta é compartilhada, tudo o que está dentro dela também é, incluindo arquivos adicionados no mês seguinte por alguém que nunca pensou no agente. Compartilhar arquivos individualmente parece mais seguro à primeira vista, mas essa abordagem logo se desfaz. O agente precisa de arquivos novos conforme o trabalho chega, e cada arquivo novo vira uma exceção manual que alguém acaba esquecendo de liberar ou de revogar.

O escopo por pasta acompanha a forma como as equipes realmente organizam o trabalho. Uma pasta de referência com tabelas de preços, procedimentos e modelos é um limite claro. Uma pasta de saídas, onde os rascunhos aparecem, é outro. Para cada pasta, a pergunta é simples: o que o agente precisa fazer aqui, e o que acontece se ele fizer isso errado?

Esta é a mesma lógica do menor privilégio para qualquer agente: comece com o acesso mínimo que completa a tarefa e amplie somente com evidências. O princípio está detalhado em permissões mínimas para agentes de IA, e os detalhes do Google Workspace estão em acesso de agente de IA ao Google Workspace e Microsoft 365.

Como montar pastas separadas de leitura e escrita?

A configuração leva menos tempo que a revisão que vem depois, e vale a pena fazê-la nesta ordem.

  • Passo 1: Crie uma identidade Google dedicada para o agente, usada apenas nesse papel, para que as ações dele no histórico de auditoria não se misturem com as de uma pessoa.
  • Passo 2: Crie uma pasta de referência e coloque nela cópias dos documentos de origem. Evite compartilhar a pasta de trabalho ativa da empresa, que contém arquivos que ninguém revisou para uso por agentes.
  • Passo 3: Crie uma pasta de saídas separada, fora da pasta de referência e não aninhada dentro dela, para que permissões herdadas não apaguem os dois limites.
  • Passo 4: Compartilhe a pasta de referência com a identidade do agente como Leitor (Viewer) e a pasta de saídas como Editor. Não compartilhe mais nada.
  • Passo 5: Desative o compartilhamento por link nas duas pastas. Não use acesso para qualquer pessoa com o link em um agente.
  • Passo 6: Registre o ID de cada pasta, seu papel, seu responsável e sua finalidade na matriz de acesso antes da primeira execução.

A matriz é o documento com o qual tudo o mais é comparado. Sem ela, uma revisão só consegue perguntar se o compartilhamento parece razoável, o que é um teste fraco.

Qual método de acesso ao Google o agente deve usar?

Há dois padrões comuns. Com OAuth delegado, o agente age por meio de uma conta de usuário que concedeu consentimento para um conjunto específico de escopos, e pode fazer dentro desses escopos o que esse usuário pode fazer. Com uma conta de serviço, o agente tem identidade própria e vê apenas o que foi compartilhado com essa identidade. A documentação de OAuth 2.0 do Google descreve como os aplicativos solicitam escopos e como os usuários concedem consentimento, e a tela de consentimento é o momento de ler a lista com atenção.

No Drive, a escolha do escopo importa mais que o método. O Google oferece escopos somente leitura e escopos mais amplos que permitem alterar arquivos. Escolha o escopo somente leitura sempre que a tarefa permitir, e confira a lista atual de escopos do Google antes de fechar a configuração, porque os nomes e as classificações dos escopos mudam com o tempo. Não use a sessão de um funcionário como atalho. Quando essa pessoa muda de função, o acesso do agente muda junto, e o registro de auditoria aponta para a pessoa errada. As diferenças entre os dois padrões estão em conta de serviço ou OAuth para agentes de IA.

O que o agente pode escrever, e o que precisa continuar com uma pessoa?

O acesso de escrita concentra a maior parte do risco, então as regras devem ser explícitas antes da primeira execução.

  • Se o agente só precisa ler um arquivo, conceda o papel de Leitor na pasta que o contém e nada mais.
  • Se o agente precisa criar rascunhos, deixe-o gravar apenas arquivos novos na pasta de saídas, e nunca sobrescrever um arquivo da pasta de referência.
  • Se o agente precisa renomear ou mover arquivos, deixe isso fora da primeira versão. Uma pessoa faz a organização depois da revisão.
  • Se o agente precisa compartilhar um arquivo com alguém de fora da empresa, ele prepara o pedido e uma pessoa envia.
  • Se o agente precisa excluir algo, a resposta é não. O acesso de Editor normalmente permite que quem o tem remova arquivos que pode editar, então a pasta de saídas deve conter apenas material que a equipe consegue gerar de novo, e a exclusão fica fora do alcance do agente.

Para os rascunhos, use uma convenção de nomes que inclua o identificador da tarefa e um número de versão. Assim fica possível saber o que o agente produziu, quando uma pessoa revisou e qual versão foi usada. A questão mais ampla de como um rascunho se torna um documento enviado está em ler, rascunhar e enviar: três permissões diferentes de IA.

O que é desvio de permissão, e por que ele passa despercebido?

Desvio de permissão é o que acontece quando o estado real de compartilhamento de uma pasta deixa, aos poucos, de corresponder à matriz aprovada. Nada falha no momento em que isso acontece, então ninguém recebe um alerta. As causas mais comuns são ações banais de escritório.

  • Alguém move a pasta de saídas para uma pasta de equipe mais ampla, para facilitar a busca, e os rascunhos ficam visíveis para pessoas que não deveriam vê-los.
  • Uma pasta de referência é copiada para um drive compartilhado onde outros papéis têm acesso de Editor.
  • O compartilhamento por link é ativado durante uma transferência pontual e nunca é desligado.
  • A pessoa que era dona de uma pasta sai da empresa, a propriedade é transferida e ninguém revisa a concessão feita ao agente.
  • Surge uma nova subpasta dentro da pasta de referência com arquivos que o agente não deveria ver, ou uma pasta necessária fica fora da concessão, o agente falha e alguém cria um contorno arriscado.

Cenário ilustrativo: uma pequena equipe de compras faz um agente ler tabelas de preços de fornecedores em uma pasta de referência e gravar comparativos de rascunho em uma pasta de saídas. Depois, um coordenador move a pasta de saídas para uma pasta de equipe com público mais amplo, para facilitar a busca. O agente continua funcionando, então ninguém percebe. A listagem semanal seguinte mostra um grupo extra com acesso de Leitor à pasta de saídas, que a matriz não inclui. O responsável move a pasta de volta, e a matriz ganha uma nova regra: a pasta de saídas não pode ser movida sem aprovação.

Como a abordagem gerenciada da Be Human trata o acesso às pastas?

Em um projeto com a Be Human, a primeira entrega nomeia cada pasta que o agente pode acessar, o papel que ela ocupa, a pessoa que aprova mudanças e a verificação que confirma que a concessão ainda corresponde ao combinado. O agente roda com identidade própria, e as credenciais continuam sob controle do cliente. A operação gerenciada acrescenta o trabalho recorrente: uma listagem programada do estado de compartilhamento, a comparação com a matriz aprovada, a resposta a incidentes quando aparece uma diferença e uma atualização controlada quando uma nova pasta é realmente necessária. A abordagem não substitui o julgamento humano sobre o que o agente deve enxergar. Ela torna o limite visível e revisado em um calendário.

Qual cadência de revisão detecta o desvio a tempo?

Uma cadência de revisão só funciona quando cada nível tem um responsável claro e uma saída clara. O NIST AI Risk Management Framework trata o monitoramento e a revisão periódica como parte da gestão do risco de IA, e não como um complemento opcional depois da implantação. Uma cadência prática para o acesso dos agentes às pastas fica assim.

  • Semanal: uma listagem automática de cada pasta que o agente alcança, com papel, configuração de link e responsável, comparada com a matriz. Cada diferença vai para uma pessoa nomeada como alerta.
  • Mensal: uma pessoa revisa os itens sinalizados e quaisquer pastas usadas pelo agente que não estejam na matriz, e confirma que a matriz ainda reflete o trabalho real.
  • Após cada reorganização: qualquer movimentação, renomeação, cópia para um drive compartilhado ou transferência de propriedade que envolva uma pasta liberada dispara uma verificação imediata, e não espera a próxima execução semanal.
  • Trimestral: o responsável pergunta se cada concessão ainda é necessária e se um papel mais restrito bastaria, usando o mesmo raciocínio de menor privilégio usado na configuração.
  • Após um incidente: se o desvio expôs conteúdo, revogue a concessão primeiro, investigue depois e restaure o acesso somente por meio de uma mudança documentada na matriz.

Mantenha um registro curto de cada revisão, com a data, os achados e a pessoa que aprovou. O registro é o que mostra, depois, que o limite se manteve e que o desvio foi detectado, e não presumido como inexistente. Faça o diagnóstico gratuito de IA da Be Human para encontrar a primeira tarefa que vale entregar a um agente e decidir qual pasta ele deve ler primeiro.

Perguntas frequentes

Um agente de IA pode editar arquivos no Google Drive sem acesso ao drive inteiro? Sim. Compartilhe apenas as pastas de que a tarefa precisa, uma para o material de origem e uma para as saídas, e deixe a raiz do drive e os drives compartilhados não relacionados fora da concessão. O agente então enxerga apenas o que essas pastas contêm, desde que ninguém as aninhe dentro de um compartilhamento mais amplo. Confira a lista de compartilhamento após qualquer reorganização para garantir que isso continue valendo.

O agente deve usar minha conta Google ou uma própria? Use uma identidade dedicada. Se o agente roda com um login pessoal, as ações dele aparecem como suas no histórico, e o acesso dele se mistura com as suas permissões, então revogar uma coisa pode atrapalhar a outra. Uma identidade separada, com concessões de pasta próprias, é mais fácil de auditar, pausar e remover.

Qual é a diferença entre Leitor (Viewer) e Editor para um agente? O Leitor permite que o agente leia arquivos sem alterá-los, o que serve a materiais de referência e documentos de origem. O Editor permite modificar e, muitas vezes, remover arquivos dessa pasta, então deve ficar apenas em uma pasta de saídas em que se espera trabalho gerado e revisado por uma pessoa. O papel de Comentador fica entre os dois, quando o agente só precisa deixar observações para as pessoas.

Com que frequência devemos revisar as permissões das pastas do agente? Revise o estado de compartilhamento semanalmente com uma listagem automática, mensalmente com uma pessoa responsável pela decisão e imediatamente após qualquer movimentação, cópia ou troca de propriedade em uma pasta liberada. Acrescente uma pergunta trimestral sobre se cada concessão ainda é necessária e se um papel mais restrito funcionaria. Pastas com registros de clientes ou financeiros merecem um ciclo mais curto que pastas com material de referência geral.

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 →