🎓 Edu - Educador Financeiro Inteligente

Agente de IA Generativa que ensina conceitos de finanças pessoais de forma simples e personalizada, usando os próprios dados do cliente como exemplos práticos.

💡 O Que é o Edu?

O Edu é um educador financeiro que ensina, não recomenda. Ele explica conceitos como reserva de emergência, tipos de investimentos e análise de gastos usando uma abordagem didática e exemplos concretos baseados no perfil do cliente.

O que o Edu faz:

• ✅ Explica conceitos financeiros de forma simples
• ✅ Usa dados do cliente como exemplos práticos
• ✅ Responde dúvidas sobre produtos financeiros
• ✅ Analisa padrões de gastos de forma educativa

O que o Edu NÃO faz:

• ❌ Não recomenda investimentos específicos
• ❌ Não acessa dados bancários sensíveis
• ❌ Não substitui um profissional certificado

🏗️ Arquitetura

flowchart TD
    A[Usuário] --> B[Streamlit]
    B --> C[Ollama - LLM Local]
    C --> D[Base de Conhecimento]
    D --> C
    C --> E[Resposta Educativa]

Loading

Stack:

• Interface: Streamlit
• LLM: Ollama (modelo local gpt-oss)
• Dados: JSON/CSV mockados

📁 Estrutura do Projeto

├── data/                          # Base de conhecimento
│   ├── perfil_investidor.json     # Perfil do cliente
│   ├── transacoes.csv             # Histórico financeiro
│   ├── historico_atendimento.csv  # Interações anteriores
│   └── produtos_financeiros.json  # Produtos para ensino
│
├── docs/                          # Documentação completa
│   ├── 01-documentacao-agente.md  # Caso de uso e persona
│   ├── 02-base-conhecimento.md    # Estratégia de dados
│   ├── 03-prompts.md              # System prompt e exemplos
│   ├── 04-metricas.md             # Avaliação de qualidade
│   └── 05-pitch.md                # Apresentação do projeto
│
└── src/
    └── app.py                     # Aplicação Streamlit

🚀 Como Executar

1. Instalar Ollama

# Baixar em: ollama.com
ollama pull gpt-oss
ollama serve

2. Instalar Dependências

pip install streamlit pandas requests

3. Rodar o Edu

streamlit run src/app.py

🎯 Exemplo de Uso

Pergunta: "O que é CDI?"
Edu: "CDI é uma taxa de referência usada pelos bancos. Quando um investimento rende '100% do CDI', significa que ele acompanha essa taxa. Hoje o CDI está próximo da Selic. Quer que eu explique a diferença entre os dois?"

Pergunta: "Onde estou gastando mais?"
Edu: "Olhando suas transações de outubro, sua maior despesa é moradia (R$ 1.380), seguida de alimentação (R$ 570). Juntas, representam quase 80% dos seus gastos. Isso é bem comum! Quer que eu explique algumas estratégias de organização?"

📊 Métricas de Avaliação

Métrica	Objetivo
Assertividade	O agente responde o que foi perguntado?
Segurança	Evita inventar informações (anti-alucinação)?
Coerência	A resposta é adequada ao perfil do cliente?

🎬 Diferenciais

• Personalização: Usa os dados do próprio cliente nos exemplos
• 100% Local: Roda com Ollama, sem enviar dados para APIs externas
• Educativo: Foco em ensinar, não em vender produtos
• Seguro: Estratégias de anti-alucinação documentadas

📝 Documentação Completa

Toda a documentação técnica, estratégias de prompt e casos de teste estão disponíveis na pasta docs/.