Pular para o conteúdo principal

Módulo 5 — AI Agent

Requisitos: RF-FC-066 a RF-FC-090

Fluxo de processamento​

1. Mensagem recebida
2. Canal tem AI Agent ativo?
3. Agrupa mensagens rápidas (delay_seconds)
4. Busca RAG: chunks relevantes (pgvector, similaridade ≥ 0.75)
5. Monta prompt: instruções + dados da loja + RAG + histórico
6. Chama Claude Sonnet 4.6
7. Analisa resposta:
   - Keyword de handoff? → escala para humano
   - Condição de sucesso? → executa ação configurada
8. Envia resposta ao contato
9. Salva métricas (tokens, custo, latência)

Base de conhecimento (RAG)​

Cada AI Agent pode ter uma ou mais bases de conhecimento:

  • Texto livre
  • Upload de PDFs (divididos em chunks automaticamente)
  • Busca semântica via pgvector (OpenAI text-embedding-3-small)

Handoff bot → humano​

Ativado quando:

  • Contato usa keyword de handoff (configurável: "humano", "atendente", etc.)
  • Contato demonstra frustração (detecção automática)
  • Condição de saída configurada é atingida

Modelo de IA​

  • Padrão: Claude Sonnet 4.6
  • Custo reduzido: Claude Haiku 4.5
  • Custom: qualquer endpoint compatível com OpenAI API

Requisitos principais​

  • RF-FC-069 — Base de conhecimento com RAG (pgvector, threshold 0.75)
  • RF-FC-070 — Dados da loja injetados automaticamente no contexto
  • RF-FC-072 — Detecção de frustração e pedido de humano
  • RF-FC-078 — Extração de dados da conversa para campos customizados
  • RF-FC-085 — Fallback: modelo secundário → escala para humano
  • RF-FC-088 — Sempre se identifica como IA quando questionado
Última atualização em