Documentos do agente (RAG)

Status: em breve

A funcionalidade de documentos do agente — tambem conhecida como RAG (Retrieval-Augmented Generation) — esta em desenvolvimento. A estrutura de dados (tabela agent_documents e document_chunks com pgvector) ja existe, mas o pipeline de upload e indexacao ainda nao foi liberado aos usuarios.

Esta pagina descreve o comportamento planejado para que voce ja entenda o que esperar.

O que RAG vai permitir

Voce podera enviar arquivos (PDF, TXT, Markdown) ao seu agente. O UltronChat quebra o conteudo em pedacos (chunks), gera embeddings vetoriais via OpenAI, e armazena em document_chunks.

A cada mensagem do cliente, o agente busca os chunks mais relevantes (por similaridade vetorial) e inclui no prompt. O modelo entao responde usando esse conteudo como fonte.

Casos de uso

• FAQ extensa — anexe seu manual de FAQ em PDF. O agente responde com base nele.
• Politicas — devolucao, garantia, privacidade. O agente cita exatamente o que esta escrito.
• Catalogo de produtos — descricoes detalhadas, especificacoes.
• Scripts de atendimento — fluxos de qualificacao, tracking de vendas.

Por que ainda nao esta liberado

A extensao pgvector no Supabase precisa ser habilitada no painel, e o pipeline de chunking + embedding precisa ser implementado no backend. Isso faz parte do escopo da proxima release.

Alternativa hoje

Enquanto a funcionalidade nao sai, voce tem duas alternativas para "alimentar" o agente com conhecimento:

1. System instruction grande — cole informacoes chave no prompt do sistema. Funciona para ate ~2000 tokens de conteudo; acima disso fica caro por mensagem.
2. Dados guiados (JSON) — o campo Dados guiados no form do agente aceita um JSON que fica acessivel ao modelo. Ideal para listas estruturadas (produtos, horarios, precos).

Exemplo de dados guiados:

{
  "produtos": [
    {"nome": "Plano Start", "preco": 97, "recursos": ["100 leads", "2 usuarios"]},
    {"nome": "Plano Pro", "preco": 297, "recursos": ["ilimitado", "10 usuarios"]}
  ],
  "horarios": {
    "segunda_sexta": "09:00 - 18:00",
    "sabado": "09:00 - 13:00",
    "domingo": "fechado"
  },
  "contatos": {
    "whatsapp_humano": "+55 11 99999-9999",
    "email": "contato@exemplo.com"
  }
}

No system instruction, voce instrui: "Use os dados em 'dados_guiados' para responder. Nao invente informacoes alem do que esta listado."

Quando a funcionalidade for liberada

Voce vera um novo campo Documentos no form do agente, permitindo upload de arquivos. Quando isso acontecer, esta pagina sera atualizada com o passo a passo completo.