Como conectar o Google Sheets a um agente de IA passo a passo
· DoubleX
Resposta rápida
Para conectar o Google Sheets a um agente de IA, abra a tela Conectores, escolha o Google Sheets e autorize o acesso com sua conta Google. Depois defina se a conexão é pessoal, do time ou da empresa e libere ações por agente. No DoubleX Agentes, dá para deixar só leitura.
Conectar uma planilha a um agente de IA não exige código. Você autoriza o acesso uma vez, escolhe quem pode usar a conexão e define o que o agente pode fazer. Este guia cobre só a conexão, do cadastro ao primeiro teste.
O que o agente consegue fazer no Google Sheets depois de conectado?#
Depois de conectado, o agente consegue ler e escrever células, acrescentar linhas e criar planilhas novas, além de localizar os arquivos pelo nome. Cada uma dessas ações pode ser liberada ou bloqueada separadamente.
| Ação | O que o agente faz | Risco |
|---|---|---|
| Ler células | Consulta valores de abas e intervalos | Baixo (não altera nada) |
| Escrever células | Atualiza valores existentes | Altera dados |
| Acrescentar linhas | Adiciona registros ao fim da aba | Altera dados |
| Criar planilhas | Gera um arquivo novo com a estrutura pedida | Cria arquivos |
Para ver exemplos de uso, consulte o que um agente de IA pode fazer no Google Sheets.
Como criar a conta e chegar à tela Conectores?#
Crie a conta grátis, sem cartão, e abra a tela Conectores no menu da plataforma. É nela que ficam todos os sistemas ligados ao DoubleX Agentes.
- Acesse doublex.ai e crie a conta, informando o segmento da empresa, o que quer melhorar e onde estão as informações.
- Se quiser, faça o diagnóstico: uma conversa de 5 a 10 minutos que mostra por onde começar e pode virar uma equipe de agentes pronta para testar.
- Abra a tela Conectores.
- Procure o Google Sheets na lista.
O passo a passo geral da plataforma está no início rápido.
Como autorizar o Google Sheets: conexão pessoal, do time ou da empresa?#
Você autoriza o Google Sheets entrando com a conta Google e aceitando o acesso. Depois, escolhe o escopo da conexão: pessoal, do time ou da empresa.
- Na tela Conectores, selecione o Google Sheets.
- Inicie a conexão e entre com a conta Google dona das planilhas.
- Revise o que está sendo pedido e autorize.
- Defina o escopo da conexão.
| Escopo | Quem usa | Quando escolher |
|---|---|---|
| Pessoal | Só você | Planilhas suas, que ninguém mais deve acessar por agente |
| Time | Pessoas do time | Planilha de uma área, como comercial ou financeiro |
| Empresa | Toda a empresa | Planilhas de uso geral, como cadastros e controles comuns |
Os dados de acesso das conexões ficam criptografados com AES-256-GCM. Para detalhes técnicos sobre conexões, veja a documentação de Conectores.
Como escolher quais ações o agente pode executar (leitura x escrita)?#
Para cada agente, você escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. Isso significa que dois agentes com a mesma conexão podem ter permissões diferentes.
- Abra a tela Agentes e selecione o agente (ou crie um novo).
- Adicione o Google Sheets aos conectores do agente.
- Marque as ações liberadas: deixe só as de leitura para um agente de consulta ou inclua escrita e criação de planilhas quando necessário.
- Salve.
Ações que alteram dados podem ficar desligadas, deixando o agente em modo só leitura. Mesmo com a escrita liberada, o agente pede confirmação antes de enviar, apagar ou alterar algo e mostra o passo a passo do que fez.
Para um roteiro de cuidados mais completo, veja o checklist de segurança para IA com Google Sheets.
Como testar com um primeiro pedido e conferir o histórico da tarefa?#
Faça um pedido simples de leitura e confira na tela Tarefas o que o agente fez. Cada pedido vira uma tarefa com histórico completo: o pedido, cada ferramenta usada e o resultado.
Exemplos de pedidos para o primeiro teste:
- "Leia a aba Clientes da planilha Controle Comercial e me diga quantas linhas existem."
- "Mostre os valores do intervalo A1:D10 da planilha Orçamento 2025."
- "Procure a planilha Estoque e liste os nomes das abas."
- "Crie uma planilha chamada Teste de Conexão com as colunas Data, Responsável e Status."
Depois, abra a tela Tarefas e veja quem pediu, qual ação foi usada e quando. Se o resultado estiver certo, passe para rotinas, como em atualizar planilhas do Google automaticamente com IA.
O que fazer se o agente não encontra a planilha?#
Quase sempre o problema é de conta, de nome ou de permissão. Confira os pontos abaixo, nesta ordem.
- Verifique se a conta Google autorizada é a que tem acesso à planilha.
- Confirme se o Google Sheets está adicionado ao agente e se a ação de leitura está liberada.
- Peça pelo nome exato do arquivo, como aparece no Google Drive.
- Veja se a conexão tem o escopo certo: uma conexão pessoal de outra pessoa não vale para você.
- Se nada resolver, refaça a autorização na tela Conectores.
Perguntas frequentes#
Preciso programar para conectar o Google Sheets?#
Não. A conexão é feita na tela Conectores, entrando com a conta Google e autorizando o acesso. Quem quiser ir além tem API REST, CLI e servidor MCP.
Dá para deixar o agente só com leitura?#
Sim. Para cada agente, você escolhe quais ações o Google Sheets pode executar. Ações que alteram dados podem ficar desligadas, deixando o agente só consultando.
O agente altera a planilha sem me avisar?#
Não. Antes de enviar, apagar ou alterar algo nos sistemas, o agente pede confirmação e mostra o passo a passo do que fez. Tudo fica registrado no histórico da tarefa.
Os dados da minha planilha treinam modelos de IA?#
Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores que não usam o que recebem para treinamento.
Qual a diferença entre conexão pessoal, do time e da empresa?#
A pessoal vale só para você, a do time vale para as pessoas daquele time e a da empresa vale para toda a organização. Escolha o menor escopo que atenda ao seu caso.
Guias relacionados
- O que um agente de IA pode fazer no Google Sheets: exemplosVeja o que um agente de IA pode fazer no Google Sheets: ler células, resumir dados, acrescentar linhas e criar planilhas, com pedidos prontos para copiar.
- 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 Drive a um agente de IA passo a passoVeja como conectar o Google Drive a um agente de IA na tela Conectores, escolher entre conexão pessoal, do time ou da empresa e limitar o que o agente pode fazer.