Como conectar o Google Drive a um agente de IA passo a passo
· DoubleX
Resposta rápida
Para conectar o Google Drive a um agente de IA, abra a tela Conectores do DoubleX Agentes, escolha Google Drive, autorize sua conta Google e defina se a conexão é pessoal, do time ou da empresa. Depois, libere o conector no agente e limite as ações, como só leitura.
Conectar o Google Drive é o primeiro passo para que um agente de IA encontre, leia e organize os arquivos da sua empresa sem que ninguém precise anexar documento por documento. O ponto principal não é só ligar a conta: é decidir quem usa a conexão e o que o agente pode fazer com os arquivos. Este guia cobre só a conexão e o controle de acesso.
O que é o conector do Google Drive no DoubleX Agentes?#
O conector do Google Drive é a ligação entre a sua conta Google e a plataforma, que dá aos agentes as ferramentas do Drive. No DoubleX Agentes, ele permite procurar, ler, criar, mover, copiar e compartilhar arquivos e pastas.
Um agente só usa o conector se ele for liberado para esse agente. Ou seja, conectar o Drive não dá acesso automático a todos os agentes da empresa.
O que preciso ter antes de conectar?#
Você precisa de uma conta no DoubleX Agentes e de uma conta Google com acesso às pastas e arquivos que o agente vai usar. Criar a conta é grátis e não pede cartão.
Antes de começar, confira:
- Conta Google certa: o agente enxerga o que essa conta enxerga. Se a conta não tem acesso à pasta de contratos, o agente também não terá.
- Quem vai usar: só você, um time ou a empresa inteira. Isso define o tipo de conexão.
- Quais ações são necessárias: só consultar arquivos ou também criar e compartilhar.
- Um agente para testar: pode ser um agente novo ou um criado a partir do diagnóstico. Se ainda não tem, veja o início rápido.
Como conectar o Google Drive na tela Conectores?#
A conexão é feita na tela Conectores: você escolhe o Google Drive, autoriza a conta Google e depois libera o conector para o agente.
- Entre no DoubleX Agentes e abra a tela Conectores.
- Procure Google Drive na lista, na categoria de documentos.
- Inicie a conexão e escolha o tipo: pessoal, do time ou da empresa (veja a próxima seção).
- Autorize o acesso na janela da sua conta Google.
- Abra a tela Agentes e escolha o agente que vai usar o Drive.
- Ative o Google Drive nos conectores desse agente.
- Defina quais ações ele pode executar (veja a seção sobre permissões).
As credenciais da conexão ficam criptografadas com AES-256-GCM. Para consultar a lista de conectores por API, veja a documentação de Conectores.
Conexão pessoal, do time ou da empresa: qual escolher?#
Escolha pessoal se o acesso deve valer só para você, do time se um grupo vai compartilhar o mesmo acesso, e da empresa se a conexão serve a toda a organização. No DoubleX Agentes, uma conexão pode ser pessoal, do time ou da empresa.
| Tipo | Para quem vale | Quando usar |
|---|---|---|
| Pessoal | Só para a pessoa que conectou | Seus próprios arquivos e pastas, como o Drive do seu trabalho |
| Do time | Para o time escolhido | Uma pasta compartilhada de Financeiro, Comercial ou Atendimento |
| Da empresa | Para toda a empresa | Uma pasta geral, como políticas internas e modelos de documento |
Uma regra simples: quanto mais gente usa a conexão, mais restrita deve ser a conta Google ligada a ela. Para um time, prefira uma conta que enxergue apenas as pastas daquela área.
Como limitar as ações do agente (só leitura x criar e compartilhar)?#
Para cada agente, você escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. No Google Drive, isso permite separar consultar arquivos de criar, mover ou compartilhar.
| Perfil do agente | Ações sugeridas no Drive |
|---|---|
| Consulta e resumo de documentos | Procurar e ler |
| Organização de pastas | Procurar, ler, mover e copiar |
| Geração de documentos | Procurar, ler e criar |
| Envio de arquivos a terceiros | Incluir compartilhar, com confirmação |
Comece com o mínimo: só leitura. Ações que alteram dados podem ficar desligadas, e você libera mais permissões depois, conforme o agente prova que faz o que você espera.
Como testar se o agente enxerga os arquivos certos?#
Faça pedidos simples de leitura e confira no histórico da tarefa quais ferramentas o agente usou. Cada pedido vira uma tarefa na tela Tarefas, com o pedido, cada ferramenta acionada e o resultado.
Pedidos para testar, copiando e adaptando:
- "Liste os arquivos da pasta Contratos 2025."
- "Procure no Drive o arquivo com o nome 'Política de reembolso' e me diga quando foi a última edição."
- "Leia o documento 'Proposta Cliente X' e resuma em cinco tópicos."
- "Quais pastas você consegue acessar no meu Drive?"
Se o agente não encontra algo que deveria, verifique se a conta Google conectada tem acesso ao arquivo e se o conector está ativo no agente. Se encontra algo que não deveria, troque a conta ligada ou reduza o tipo de conexão. Com a conexão validada, veja o que dá para automatizar no Google Drive com agente de IA e exemplos de pedidos para o Google Drive.
Perguntas frequentes#
Conectar o Google Drive dá acesso a todos os meus arquivos?#
O agente enxerga o que a conta Google conectada enxerga, mas só se o conector estiver ativo nele. Você ainda limita as ações permitidas em cada agente.
Posso deixar o agente apenas lendo arquivos?#
Sim. Para cada agente você escolhe as ações permitidas no Google Drive, e ações que alteram dados podem ficar desligadas, deixando o agente só em modo de consulta.
O agente apaga ou compartilha arquivos sem me avisar?#
Não. Antes de enviar, apagar ou alterar algo nos sistemas, o agente pede confirmação e mostra o que fez. Tudo fica registrado no histórico da tarefa.
Os arquivos do Drive são usados para treinar modelos de IA?#
Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores de IA que não usam o que recebem para treinamento.
Preciso programar para conectar o Google Drive?#
Não. A conexão é feita pela tela Conectores. Quem quiser ir além pode usar a API REST e a CLI, descritas na introdução da documentação.
Guias relacionados
- Como conectar o Google Calendar a um agente de IAVeja como conectar o Google Calendar a um agente de IA: autorizar a conta, escolher o tipo de conexão, limitar permissões e fazer o primeiro teste.
- Como conectar o Google Sheets a um agente de IA passo a passoVeja como conectar o Google Sheets a um agente de IA: autorizar a conta, escolher o escopo e liberar ações por agente, inclusive só leitura.