Skip to content

About

Chatbot com IA para a AURA SEGUROS — RAG, acessibilidade total (cego/surdo/mudo), assinatura eletrônica e análise multimodal via NVIDIA Llama + Gemini.

Resources

Accessibility

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Assistente-Virtual-Inteligente: Chatbot com RAG que atende também quem não vê, não ouve ou não fala.

Node.js 18+ NVIDIA Llama 3.3 70B Gemini fallback Licença MIT

Funcionalidades · Arquitetura · Setup Rápido · Acessibilidade

AURA SEGUROS — Assistente Virtual

Chatbot inteligente com RAG, suporte multimodal e acessibilidade total

Exemplo real — trecho da base que o RAG consulta (FAQ_DB em server.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.


Índice


Visão Geral

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)

Funcionalidades

🤖 Chat Inteligente

  • 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)

♿ Acessibilidade

  • 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

📁 Análise Multimodal

  • Imagens: descrição detalhada do conteúdo
  • Áudio: transcrição automática de gravações
  • Vídeo: descrição de cenas, objetos e textos

✍️ Assinatura Eletrônica

  • Canvas interativo com suporte a mouse e touch
  • Geração de hash único para verificação de integridade
  • Armazenamento local dos documentos assinados

📋 FAQ Integrada

  • 15 perguntas frequentes em 7 categorias
  • Sidebar com acesso rápido
  • Modal completo para consulta

Arquitetura

                   ┌──────────────────┐
                   │   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│   │
                  │  └───────────┘   │
                  └──────────────────┘

Pré-requisitos

  • 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)

Setup Rápido

# 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 start

Acesse: http://localhost:3000


Configuração

Variáveis de Ambiente (.env)

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)

Chaves de API

  1. NVIDIA API: https://build.nvidia.com/ → Criar conta → API Keys
  2. Gemini API: https://aistudio.google.com/ → Get API Key

Uso

Iniciar o servidor

npm start          # Produção
npm run dev        # Desenvolvimento (com watch)

Navegador

Abra http://localhost:3000 e comece a conversar!

Exemplos de Perguntas

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

API Endpoints

GET /api/health

Health check do servidor.

GET /api/faq

Retorna todas as FAQs agrupadas por categoria.

POST /api/chat

Envia mensagem para o LLM com contexto RAG.

Body:

{
  "message": "O que é o scAura?",
  "history": []
}

POST /api/analyze-media

Analisa arquivos de mídia (imagem, áudio, vídeo).

Multipart: file (arquivo), prompt (instrução opcional)

POST /api/sign-document

Registra assinatura eletrônica.

Body:

{
  "signatureData": "data:image/png;base64,...",
  "documentName": "Contrato AURA SEGUROS",
  "userName": "João Silva"
}

Acessibilidade

O chatbot foi projetado seguindo as diretrizes WCAG 2.1 AA:

Para Cegos (Leitores de Tela)

  • ARIA labels em todos os elementos interativos
  • role="log" com aria-live="polite" para mensagens dinâmicas
  • Skip link para pular navegação
  • HTML semântico (header, main, aside, role="complementary")

Para Surdos

  • Respostas visuais com formatação rica
  • Feedback visual para todas as ações
  • Indicadores de status visuais

Para Mudos

  • Entrada por texto
  • Entrada por voz (STT): clique no microfone para ditar
  • Upload de arquivos com descrição

Comandos de Acessibilidade

Botão Função
♿ Abrir barra de acessibilidade
🔊 Ler Ativar leitura em voz alta
🎤 Falar Ativar entrada por voz
✍️ Assinar Abrir painel de assinatura

Estrutura do Projeto

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

Tecnologias

Backend

  • Node.js + Express — Servidor web
  • Multer — Upload de arquivos
  • Axios — Requisições HTTP para as APIs

LLM

  • NVIDIA API — meta/llama-3.3-70b-instruct (motor principal)
  • Gemini API — gemini-2.0-flash (fallback + visão)

RAG

  • TF-IDF simplificado — Busca por similaridade textual
  • FAQ DB — 15 entradas em 7 categorias

Frontend

  • HTML5 + CSS3 — Design minimalista e futurista
  • Web Speech API — TTS (leitura) e STT (voz)
  • Canvas API — Assinatura eletrônica
  • ARIA — Acessibilidade total

Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.



Feito com ❤️ para a AURA SEGUROS


About

Chatbot com IA para a AURA SEGUROS — RAG, acessibilidade total (cego/surdo/mudo), assinatura eletrônica e análise multimodal via NVIDIA Llama + Gemini.

Resources

Accessibility

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages