Ferramentas que você vai precisar 

Antes de começar, certifique-se de ter: 

• ✅ Conta gratuita no Langflow 

• ✅ Conta gratuita no SheetDB 

• ✅ Conta na OpenAI (para usar modelos GPT) 

• ✅ Uma planilha pública no Google Sheets bem estruturada (com cabeçalhos claros) 

Arquitetura do agente 

O agente utiliza a abordagem de Tool Calling, ou seja, ele tem acesso a ferramentas (tools) que pode usar para cumprir tarefas com base nos pedidos dos usuários. 

Fluxo de funcionamento: 

1. O usuário envia um pedido em linguagem natural. 

2. O agente interpreta o pedido. 

3. Ele escolhe a tool adequada (buscar, editar, inserir, etc.). 

4. Executa a ação via API do SheetDB. 

5. Retorna a resposta em linguagem natural ao usuário. 

Passo a passo da construção do agente no Langflow 

1. Criar o fluxo 

No Langflow, crie um novo fluxo em branco. 

2. Adicionar o ChatInput 

• Vá no menu lateral e arraste o componente ChatInput. 

• Ele captura as mensagens enviadas pelo usuário no Playground. 

3. Adicionar o componente Agent 

• No menu Agents, arraste o componente Agent. 

• Configure: 

• Modelo (Provider): OpenAI (por exemplo, GPT-3.5 ou GPT-4) 

• OpenAI Key 

• Instructions (Prompt com regras) 

• Tools (serão conectadas depois) 

• Input: conecte ao ChatInput 

4. Adicionar as tools personalizadas do SheetDB 

• Vá em Saved > seus componentes personalizados para SheetDB. 

• Arraste todos os componentes (get columns, search, insert, update…). 

• Conecte todos ao campo Tools do Agent. 

5. Instruções (Prompt) 

Adicione um prompt elaborado com as seguintes orientações: 

• Entender o pedido do usuário. 

• Verificar as colunas da planilha antes de buscar dados. 

• Usar a tool correta de acordo com a ação solicitada. 

• Ajudar o usuário a preencher corretamente os dados. 

• Responder de forma clara com tópicos, listas ou tabelas. 

6. Conectar a saída (ChatOutput) 

• Adicione o componente ChatOutput. 

• Conecte o Response do Agent ao ChatOutput. 

Conectando o Google Sheets ao SheetDB 

1. Torne sua planilha pública com permissão de edição. 

2. Copie o link compartilhável da planilha. 

3. Vá ao site do SheetDB e clique em “Criar nova API”. 

4. Cole o link e gere a API. 

5. Copie o API ID. 

6. Cole esse ID em todos os campos API ID das tools do SheetDB no Langflow. 

Testando o agente 

1. Clique em Playground no Langflow. 

2. Faça perguntas como: 

1. “Quais são os dados da planilha?” 

2. “Quais pedidos foram feitos pelo cliente Rafael Lima?” 

3. “Adicione um novo pedido para o cliente Ingrid Andrade.” 

O agente: 

• Identifica as colunas automaticamente. 

• Usa a tool correta para cada ação. 

• Insere novos dados com validação. 

• Formata a resposta em Markdown ou tabela. 

Casos de uso 

• Consultar status de pedidos em tempo real. 

• Atualizar registros como status de pagamento. 

• Registrar leads automaticamente via chat. 

• Consultar informações compartilhadas com equipes. 

• Gerar relatórios ou gráficos com outros agentes. 

Pontos de atenção 

• A planilha deve estar estruturada (sem mesclas, com cabeçalhos claros). 

• A API gratuita do SheetDB permite até 500 requisições/mês. 

• Limitações de segurança: não há controle granular de acesso a dados. 

• Operações complexas (como joins entre tabelas) não são suportadas com planilhas — nesse caso, use um banco SQL. 

Pronto! 

Com esse tutorial, você aprendeu a criar um agente inteligente que interage com o Google Sheets de forma simples, acessível e poderosa, usando apenas ferramentas no-code/low-code como Langflow e SheetDB. 

Você pode evoluir a solução criando multi-agentes para relatórios, gráficos e análise preditiva. Explore, adapte e compartilhe suas ideias com a comunidade.