Case

Enterprise Analytics Copilot (Text-to-SQL)

Agente de IA que transforma perguntas de negócio em consultas SQL seguras, com LangGraph e LLM local.

Visão geral

Copiloto analítico text-to-SQL que converte perguntas em linguagem natural em consultas SQL validadas, executa no PostgreSQL e devolve respostas de negócio em português.

Desafio

Times de negócio dependem de analistas para responder perguntas simples sobre os dados, criando gargalos. Abrir consultas SQL diretamente a um LLM traz risco de injeção, operações destrutivas e respostas desconectadas dos dados reais.

Solução

Foi desenvolvido um pipeline orquestrado em LangGraph (geração de SQL → validação de segurança → execução → formatação → resposta), com contexto de schema real, bloqueio de operações de escrita e modelo local Llama 3.2 via Ollama, containerizado com Docker.

Impacto

  • Consultas em linguagem natural sobre um data warehouse dimensional
  • Validação multicamada de segurança (apenas SELECT/WITH, anti-injeção)
  • Stack 100% local e reproduzível, sem custo de API externa

Tecnologias

PythonLangGraphLangChainOllama / Llama 3.2PostgreSQLSQLAlchemyDocker
GitHub Repository