🤖 IA para Consultas SQL com LangChain + OpenAI + MySQL

Este projeto executa uma inteligência artificial capaz de responder perguntas em linguagem natural sobre os dados armazenados em um banco de dados MySQL. Utiliza o framework LangChain e a API da OpenAI para interpretar e transformar as perguntas em comandos SQL automaticamente.

---

🧠 O que o projeto faz?

• Interpreta perguntas como:
  • “Quantas vendas eu fiz este mês?”
  • “Qual foi o valor total vendido em 2023?”
  • “Quais os clientes ativos com plano acima de R$ 500?”
• Traduz as perguntas para SQL usando a OpenAI.
• Executa a consulta diretamente no banco de dados.
• Retorna a resposta formatada para o usuário.

---

📁 Estrutura do Projeto

.
├── app/
│   ├── db_agent.py              # Código que conecta LangChain ao banco
│   ├── main.py                  # Interface CLI (perguntas e respostas)
│   ├── requirements.txt         # Dependências Python
│   └── wait-for-mysql.sh        # Script de espera pelo MySQL
├── Dockerfile                   # Build do container da IA
├── docker-compose.yml           # Orquestração com MySQL + IA
├── .env                         # Variáveis de ambiente (chave da OpenAI, etc)
└── README.md                    # Documentação do projeto

---

⚙️ Tecnologias utilizadas

• Python 3.11
• LangChain
• OpenAI GPT (gpt-3.5-turbo, gpt-4, etc.)
• SQLAlchemy
• MySQL 8
• Docker e Docker Compose

---

🛠️ Pré-requisitos

• Docker e Docker Compose instalados
• Chave da API do OpenAI (crie em https://platform.openai.com/account/api-keys)

---

🚀 Como rodar o projeto

1. Clone o repositório

git clone https://github.com/seu-usuario/ia-sql-openai.git
cd ia-sql-openai

2. Crie o arquivo .env

# .env
DB_URI=mysql+pymysql://ai_user:ai_pass@mysql-db/ai_database
OPENAI_API_KEY=sua-chave-openai-aqui
OPENAI_MODEL=gpt-3.5-turbo

3. Suba os containers

docker-compose build
docker-compose up -d

4. Execute o agente da IA

docker-compose run --rm ai-agent

Você verá no terminal algo como:

Pergunte algo sobre seus dados:

Faça perguntas como:

quantas vendas eu fiz no mês passado?
qual o valor médio dos planos vendidos?

---

🧼 Limpar containers e volumes

docker-compose down -v

---

📄 Licença

MIT © 2025 Celso Romão