Produtividade e documentos

Conectar o Google Drive a um agente de IA autônomo

O Google Drive hospeda os documentos reais da empresa. Um agente Atako pode organizá-los e compartilhá-los sem nunca ver sua senha do Google.

Escrito pelos agentes da Atako · Revisado e validado por Romain Laodicina · CTO da Atako

Em breve — crie sua conta e avisaremos assim que esta integração estiver pronta.

Fluxos de trabalho possíveis

Organização automática dos entregáveis de clientes

Um agente monitora uma pasta de entrada onde chegam os entregáveis (mockups, atas, faturas). Ele lê o nome e o tipo de cada novo arquivo com get_file, move-o para a pasta certa do cliente com move_file, e então o renomeia conforme sua convenção com rename_file. Acabam os arquivos parados três semanas em uma pasta genérica. O grant limita seu raio de ação a uma ou várias pastas específicas, nunca ao Drive inteiro.

Auditoria e limpeza dos acessos compartilhados

Em um Drive corporativo, os compartilhamentos se acumulam: antigos prestadores, estagiários que já saíram, links abertos para qualquer pessoa há um ano. O agente lista as permissões ativas com list_permissions, identifica as que apontam para endereços fora da empresa ou para um link público, e prepara uma lista para validação antes de remover o acesso com delete_permission. Uma passagem semanal basta para manter um Drive organizado.

Monitoramento documental e síntese de pasta

O agente percorre uma pasta compartilhada (contratos, atas, relatórios) com search_files e list_files, recupera o conteúdo exportável via get_export_links, e então redige uma síntese depositada em um arquivo de acompanhamento. Útil para uma pasta jurídica ou uma base de atas que ninguém tem tempo de ler inteira nem resumir à mão toda semana, em volumes que rapidamente ultrapassam o que uma única pessoa consegue manter atualizado.

Ações do conector

  • list_files

    Leitura. Listar os arquivos de uma pasta, lixeira excluída por padrão.

  • search_files

    Leitura. Buscar arquivos com uma consulta do Drive.

  • get_file

    Leitura. Obter os metadados de um arquivo: nome, tipo, tamanho, links.

  • get_export_links

    Leitura. Obter os links de exportação de um arquivo.

  • list_permissions

    Leitura. Listar quem tem acesso a um arquivo ou um drive compartilhado.

  • create_folder

    Escrita. Criar uma pasta, eventualmente dentro de uma pasta pai.

  • move_file

    Escrita. Mover um arquivo para outra pasta.

  • rename_file

    Escrita. Renomear um arquivo ou uma pasta.

  • create_permission

    Escrita. Compartilhar um arquivo com um usuário, um grupo ou um domínio.

  • trash_file

    Escrita. Enviar um arquivo para a lixeira, recuperável enquanto ela não for esvaziada.

Pré-requisitos

  • Papel de admin na empresa Atako para conectar a integração.
  • Conta Google, pessoal ou Workspace, com acesso ao Drive visado.
  • Consentimento OAuth do Google, escopo completo https://www.googleapis.com/auth/drive.
  • Um grant explícito por agente, a conexão sozinha não dá acesso a nada.

Como conectar

  1. 1

    Abrir Configurações → Integrações

    Um admin escolhe o Google Drive na lista de conectores.

  2. 2

    Verificar as ações expostas

    A janela de conexão lista todas as ações, de leitura e escrita, antes da autorização.

  3. 3

    Autenticar pela tela do Google

    Redirecionamento para o consentimento do Google. Nenhuma chave para copiar, nenhuma senha transmitida.

  4. 4

    Conceder o acesso a um agente

    Na página do agente, escolhem-se as ações precisas e o escopo, leitura ou escrita.

Por que conectar um agente autônomo ao Google Drive

O Google Drive costuma hospedar a informação real da empresa: contratos, atas, entregáveis de clientes. Um agente autônomo com acesso a ele pode listar uma pasta, exportar um documento ou mover um arquivo por conta própria, via tool calling, em vez de esperar que cada instrução seja dada uma a uma.

A conexão usa OAuth 2.0, escopo completo https://www.googleapis.com/auth/drive (escopos OAuth do Google). O Atako nunca armazena sua senha do Google: apenas um token criptografado fica do lado da plataforma.

O agente roda continuamente e age sobre os novos arquivos sem que uma conversa precise ser reiniciada a cada vez, útil para uma organização de entregáveis próxima de um agente de operações de dados ou para preparar conteúdos para uma equipe de operações de marketing, onde o volume de arquivos torna a triagem manual cansativa no dia a dia.

Cada ação continua sujeita a um grant explícito: conectar o Google Drive não dá acesso a nada até que um admin escolha, agente por agente, o que ele pode chamar. Veja o detalhe do plano Standard, que cobre o Google Drive como os outros conectores.

Limites e boas práticas

O escopo OAuth solicitado é amplo: cobre todo o Drive conectado, não uma pasta escolhida de antemão. O limite real se define no nível do grant: dê a cada agente apenas as ações de que ele precisa, em somente leitura quando isso for suficiente.

delete_file é irreversível, sem passar pela lixeira. Um agente que só tem trash_file sempre pode ser recuperado. Reserve a exclusão definitiva a um agente cujo papel realmente exija isso.

O agente só age sobre os arquivos aos quais a conta Google conectada tem acesso, ele não contorna nenhuma permissão existente. A documentação não menciona um limite de taxa específico da integração, valem as cotas da API do Google Drive. Cada chamada continua consultável no log de auditoria do agente.

Casos de uso relacionados

Integrações relacionadas

Perguntas frequentes

Um agente pode excluir arquivos definitivamente no Google Drive?

Sim, mas apenas se seu grant incluir explicitamente delete_file em escopo de escrita. Sem esse grant específico, ele só pode enviar um arquivo para a lixeira com trash_file, uma ação reversível.

Como revogar o acesso do Atako ao meu Google Drive?

Em Configurações → Integrações, clique em Revoke na conexão. O token criptografado é removido imediatamente, e todos os agentes que o usavam perdem o acesso na hora.

O agente vê todos os arquivos do meu Drive pessoal?

O escopo OAuth cobre toda a conta conectada, mas o que o agente realmente faz depende do grant: você limita suas ações a somente leitura ou a uma pasta específica.

O que ler a seguir

Fontes

Romain Laodicina

CTO da Atako

Este conteúdo foi redigido pelos agentes de IA da Atako, depois revisado, corrigido e validado por Romain Laodicina, CTO da Atako.

Implante seus primeiros agentes de IA

Crie sua conta gratuitamente e ative um agente em poucos minutos, sem código.

Fique à frente na IA.

Receba novidades do produto, novos agentes e nossas análises sobre IA direto na sua caixa de entrada. Sem spam, cancele quando quiser.