Como criar um agente de IA que consulta seu banco de dados

Por que um agente que consulta o banco muda o jogo

A maioria dos pequenos negócios já tem dados valiosos guardados em algum lugar: um banco PostgreSQL, uma planilha, o sistema de pedidos ou o CRM. O problema é que consultar esses dados exige alguém que saiba mexer no sistema ou escrever SQL. E aí surge a pergunta clássica no fim do dia: "quanto vendemos hoje?" — e ninguém sabe responder na hora.

Um agente de IA conectado ao seu banco de dados resolve isso. Você pergunta em português ("quais os 5 produtos mais vendidos essa semana?") e ele traduz a pergunta em uma consulta, executa e devolve a resposta pronta. Neste artigo, mostro como montar isso na prática com o n8n.

A arquitetura do agente

O fluxo é mais simples do que parece. Ele tem quatro peças:

1. Gatilho de entrada — pode ser o WhatsApp, um chat interno ou um formulário.
2. Nó de IA (AI Agent) — o cérebro que interpreta a pergunta.
3. Ferramenta de consulta — um nó que executa SQL ou lê a planilha.
4. Resposta formatada — devolve o resultado em linguagem clara.

No n8n, o nó AI Agent aceita "tools" (ferramentas). A grande sacada é conectar um nó de banco (Postgres, MySQL) como ferramenta do agente. Assim, a IA decide quando e qual consulta rodar, sozinha.

Passo a passo no n8n

1. Configure a conexão com o banco

Adicione as credenciais do seu banco em Credentials. Para um Postgres, você vai precisar de host, porta, usuário, senha e nome do banco. Teste a conexão antes de seguir.

2. Monte o nó AI Agent

Use o nó AI Agent com um modelo como GPT-4o-mini (bom custo-benefício) ou Claude. No campo de instrução do sistema (system prompt), seja específico:

"Você é um assistente que responde perguntas sobre vendas. Você tem acesso a uma ferramenta que executa consultas SQL na tabela pedidos (colunas: id, cliente, produto, valor, data). Sempre gere SQL seguro, apenas de leitura (SELECT). Responda em português, de forma curta e objetiva."

Descrever o esquema das tabelas no prompt é o passo mais importante. Sem isso, a IA "chuta" nomes de colunas e erra.

3. Conecte a ferramenta de SQL

No AI Agent, adicione uma tool do tipo Postgres Tool (ou execute via nó de código). Configure para aceitar a query gerada pela IA. O agente vai montar o SELECT, passar para a ferramenta e receber os dados de volta.

4. Devolva a resposta

O próprio agente transforma o resultado bruto (linhas do banco) em uma frase legível. Se o gatilho foi o WhatsApp, adicione o nó de envio da mensagem no final.

Um exemplo real

Imagine uma loja que recebe no WhatsApp interno a pergunta: "faturamos mais essa semana ou na passada?"

O agente interpreta, gera duas consultas de soma por período, compara os valores e responde:

"Essa semana o faturamento foi R$ 12.480, contra R$ 9.750 da semana passada. Um crescimento de 28%. 📈"

Tudo isso em segundos, sem ninguém abrir o sistema.

Cuidados essenciais de segurança

Dar acesso ao banco para uma IA exige responsabilidade:

• Use um usuário somente leitura. Crie um usuário de banco que só pode fazer SELECT. Assim, mesmo que algo dê errado, nada é apagado ou alterado.
• Limite as tabelas expostas. Não dê acesso a dados sensíveis (senhas, dados de cartão) desnecessariamente.
• Valide as queries. Adicione uma verificação para bloquear comandos como DELETE, UPDATE ou DROP antes de executar.
• Registre tudo. Guarde um log das perguntas e consultas geradas para auditar depois.

Quando vale a pena

Esse tipo de agente brilha quando você faz as mesmas perguntas o tempo todo e depende de outra pessoa para respondê-las. Vendas, estoque, clientes ativos, tickets em aberto — qualquer métrica que hoje mora num sistema pode virar uma resposta imediata no WhatsApp.

Para volumes pequenos, o custo de IA é irrisório: cada consulta custa centavos. E o ganho de agilidade na tomada de decisão é enorme.

Conclusão

Um agente de IA que conversa com seu banco de dados tira a informação da "caixa preta" dos sistemas e coloca na palma da mão de quem toma decisões. Com n8n, você monta isso sem precisar de um time de desenvolvedores.

Se você tem dados espalhados e quer transformá-los em respostas rápidas, a GRS Automações pode desenhar esse agente sob medida para o seu negócio — com toda a segurança que o assunto exige. Fale com a gente quando quiser dar esse próximo passo.