rajveer100704/carbolo-whatsapp-ai-agent

O que carbolo-whatsapp-ai-agent faz?

Assistente de IA para concessionárias no WhatsApp, pronto para produção, com RAG fundamentado, agendamento no Google Calendar, lembretes via APScheduler, orquestração FSM, suporte a Hinglish e barreiras anti-alucinação.

Visão Geral

Este skill implementa um agente de IA para WhatsApp que funciona como um assistente de vendas para concessionárias de automóveis. Ele é capaz de:

• Responder perguntas sobre veículos com base em documentos de inventário (RAG fundamentado)
• Agendar test drives e eventos no Google Calendar
• Enviar lembretes automáticos para clientes e vendedores
• Orquestrar conversas usando uma máquina de estados finitos (FSM)
• Suportar Hinglish (Hindi + Inglês) para comunicação natural
• Prevenir alucinações com barreiras de validação

Plataformas Suportadas

• Claude Code
• Cursor
• Codex
• Qualquer agente que suporte execução de código Python

Como Funciona

1. O agente recebe mensagens do WhatsApp via webhook do Twilio
2. A mensagem é processada por uma FSM que determina o estado da conversa (saudação, consulta de veículos, agendamento, confirmação)
3. Perguntas sobre veículos são respondidas usando RAG com embeddings armazenados em um banco vetorial local (FAISS)
4. Agendamentos são criados no Google Calendar via API
5. Lembretes são disparados via APScheduler em horários configurados
6. Respostas são validadas contra alucinações antes de serem enviadas

Configuração

Variáveis de ambiente necessárias:

TWILIO_ACCOUNT_SID=seu_sid
aTWILIO_AUTH_TOKEN=seu_token
aTWILIO_WHATSAPP_NUMBER=seu_numero
aOPENAI_API_KEY=sua_chave
aGOOGLE_CALENDAR_CREDENTIALS=caminho_para_credenciais.json
a

Execução

pip install -r requirements.txt
python app.py

Use ngrok para expor o servidor local:

ngrok http 5000

Estrutura do Projeto

• app.py - Servidor Flask principal
• fsm.py - Lógica da máquina de estados finitos
• rag.py - Módulo de RAG fundamentado
• calendar_utils.py - Integração com Google Calendar
• reminder.py - Sistema de lembretes com APScheduler
• hinglish.py - Suporte a Hinglish
• guardrails.py - Barreiras anti-alucinação
• data/ - Documentos de veículos para RAG

Licença

MIT