Funcionalidades · Arquitetura · Setup Rápido · Acessibilidade
Chatbot inteligente com RAG, suporte multimodal e acessibilidade total
Exemplo real — trecho da base que o RAG consulta (
FAQ_DBemserver.js, 15 perguntas):O que é o scAura? O scAura é um sistema de pontuação gamificado que reflete seu nível de bem-estar e engajamento com o AURA SEGUROS.
- Visão Geral
- Funcionalidades
- Arquitetura
- Pré-requisitos
- Setup Rápido
- Configuração
- Uso
- API Endpoints
- Acessibilidade
- Estrutura do Projeto
- Tecnologias
- Licença
O AURA SEGUROS — Assistente Virtual é um chatbot inteligente projetado para a seguradora AURA SEGUROS, focado no público jovem brasileiro (Geração Z e Millennials). O sistema utiliza LLM (Large Language Model) com RAG (Retrieval-Augmented Generation) para responder perguntas sobre produtos, benefícios e serviços da seguradora.
Diferenciais:
- Motor principal: NVIDIA API com
meta/llama-3.3-70b-instruct - Fallback automático: Gemini API (
gemini-2.0-flash) - RAG com 15 FAQs categorizadas
- Análise multimodal (imagem, áudio, vídeo)
- Assinatura eletrônica de documentos
- Acessibilidade total (cego, surdo, mudo)
- Respostas contextuais baseadas na FAQ oficial da AURA SEGUROS
- RAG (Retrieval-Augmented Generation) com similaridade textual
- Fallback automático entre NVIDIA API e Gemini API
- Histórico de conversação (últimas 20 mensagens)
- Leitura em voz alta (TTS): navegador lê as respostas automaticamente
- Entrada por voz (STT): ditado de mensagens com Web Speech API
- ARIA Labels: compatibilidade total com leitores de tela (NVDA, VoiceOver, TalkBack)
- Skip Link: navegação por teclado
- Contraste: design de alto contraste para baixa visão
- Imagens: descrição detalhada do conteúdo
- Áudio: transcrição automática de gravações
- Vídeo: descrição de cenas, objetos e textos
- Canvas interativo com suporte a mouse e touch
- Geração de hash único para verificação de integridade
- Armazenamento local dos documentos assinados
- 15 perguntas frequentes em 7 categorias
- Sidebar com acesso rápido
- Modal completo para consulta
┌──────────────────┐
│ Navegador │
│ (index.html) │
└────────┬─────────┘
│ HTTP/REST
┌────────▼─────────┐
│ Node.js │
│ (server.js) │
│ │
┌────┤ ┌───────────┐ ├────┐
│ │ │ RAG │ │ │
│ │ │ (FAQ DB) │ │ │
▼ │ └───────────┘ │ ▼
┌────────┐ │ │ ┌────────┐
│NVIDIA │ │ ┌───────────┐ │ │ Gemini │
│LLaMA │◄──┼──┤ Análise │ │ │ Vision │
│3.3-70B │ │ │ Multimodal│ │ │ (media)│
└────────┘ │ └───────────┘ │ └────────┘
│ │
│ ┌───────────┐ │
│ │ Assinatura│ │
│ │ Eletrônica│ │
│ └───────────┘ │
└──────────────────┘
- Node.js 18+ (recomendado: 20 LTS)
- NPM 9+
- Python 3.10+ (apenas para scripts auxiliares)
- Conta na NVIDIA API (gratuita)
- Conta no Google AI Studio (gratuita, para fallback Gemini)
# 1. Clone o repositório
git clone https://github.com/seu-usuario/aura-seguros-chatbot.git
cd aura-seguros-chatbot
# 2. Configure as variáveis de ambiente
cp .env.example .env
# Edite o .env com suas chaves de API
# 3. Instale as dependências
npm install
# 4. (Opcional) Crie o ambiente virtual Python
python -m venv .venv
source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate # Windows
pip install -r requirements.txt
# 5. Inicie o servidor
npm startAcesse: http://localhost:3000
| Variável | Obrigatória | Descrição |
|---|---|---|
NVIDIA_API_KEY |
Sim | Chave da API NVIDIA para o modelo Llama 3.3-70B |
GEMINI_API_KEY |
Opcional | Chave da API Gemini (fallback + análise de mídia) |
PORT |
Não | Porta do servidor (padrão: 3000) |
- NVIDIA API: https://build.nvidia.com/ → Criar conta → API Keys
- Gemini API: https://aistudio.google.com/ → Get API Key
npm start # Produção
npm run dev # Desenvolvimento (com watch)Abra http://localhost:3000 e comece a conversar!
| Pergunta | Categoria |
|---|---|
| "O que é o AURA SEGUROS?" | Sobre |
| "Como funciona o cashback?" | Cashback |
| "O que é scAura?" | scAura |
| "Como contratar?" | Contratação |
| "Quem pode participar do sorteio?" | Sorteio |
Health check do servidor.
Retorna todas as FAQs agrupadas por categoria.
Envia mensagem para o LLM com contexto RAG.
Body:
{
"message": "O que é o scAura?",
"history": []
}Analisa arquivos de mídia (imagem, áudio, vídeo).
Multipart: file (arquivo), prompt (instrução opcional)
Registra assinatura eletrônica.
Body:
{
"signatureData": "data:image/png;base64,...",
"documentName": "Contrato AURA SEGUROS",
"userName": "João Silva"
}O chatbot foi projetado seguindo as diretrizes WCAG 2.1 AA:
- ARIA labels em todos os elementos interativos
role="log"comaria-live="polite"para mensagens dinâmicas- Skip link para pular navegação
- HTML semântico (header, main, aside, role="complementary")
- Respostas visuais com formatação rica
- Feedback visual para todas as ações
- Indicadores de status visuais
- Entrada por texto
- Entrada por voz (STT): clique no microfone para ditar
- Upload de arquivos com descrição
| Botão | Função |
|---|---|
| ♿ | Abrir barra de acessibilidade |
| 🔊 Ler | Ativar leitura em voz alta |
| 🎤 Falar | Ativar entrada por voz |
| ✍️ Assinar | Abrir painel de assinatura |
aura-seguros-chatbot/
├── public/ # Frontend (estático)
│ └── index.html # Aplicação SPA completa
├── docs/ # Documentação
│ └── assets/ # Recursos visuais
│ └── logo.svg # Logo do projeto
├── uploads/ # Uploads temporários (gitignored)
├── signed_docs/ # Documentos assinados (gitignored)
├── scripts/ # Scripts auxiliares
│ ├── setup.py # Setup automatizado
│ └── seed_faq.py # Importação de FAQs
├── server.js # Servidor Node.js (Express)
├── package.json # Dependências Node.js
├── requirements.txt # Dependências Python (auxiliares)
├── .env.example # Template de variáveis de ambiente
├── .gitignore # Arquivos ignorados pelo Git
└── README.md # Este arquivo
- Node.js + Express — Servidor web
- Multer — Upload de arquivos
- Axios — Requisições HTTP para as APIs
- NVIDIA API —
meta/llama-3.3-70b-instruct(motor principal) - Gemini API —
gemini-2.0-flash(fallback + visão)
- TF-IDF simplificado — Busca por similaridade textual
- FAQ DB — 15 entradas em 7 categorias
- HTML5 + CSS3 — Design minimalista e futurista
- Web Speech API — TTS (leitura) e STT (voz)
- Canvas API — Assinatura eletrônica
- ARIA — Acessibilidade total
Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
Feito com ❤️ para a AURA SEGUROS