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çãoO que o agente fazRisco
Ler célulasConsulta valores de abas e intervalosBaixo (não altera nada)
Escrever célulasAtualiza valores existentesAltera dados
Acrescentar linhasAdiciona registros ao fim da abaAltera dados
Criar planilhasGera um arquivo novo com a estrutura pedidaCria 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.

  1. Acesse doublex.ai e crie a conta, informando o segmento da empresa, o que quer melhorar e onde estão as informações.
  2. 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.
  3. Abra a tela Conectores.
  4. 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.

  1. Na tela Conectores, selecione o Google Sheets.
  2. Inicie a conexão e entre com a conta Google dona das planilhas.
  3. Revise o que está sendo pedido e autorize.
  4. Defina o escopo da conexão.
EscopoQuem usaQuando escolher
PessoalSó vocêPlanilhas suas, que ninguém mais deve acessar por agente
TimePessoas do timePlanilha de uma área, como comercial ou financeiro
EmpresaToda a empresaPlanilhas 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.

  1. Abra a tela Agentes e selecione o agente (ou crie um novo).
  2. Adicione o Google Sheets aos conectores do agente.
  3. 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.
  4. 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.

  1. Verifique se a conta Google autorizada é a que tem acesso à planilha.
  2. Confirme se o Google Sheets está adicionado ao agente e se a ação de leitura está liberada.
  3. Peça pelo nome exato do arquivo, como aparece no Google Drive.
  4. Veja se a conexão tem o escopo certo: uma conexão pessoal de outra pessoa não vale para você.
  5. 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

Mais guias de Google Sheets