Base de conhecimento
A base de conhecimento é a fonte de verdade do Agente IA. Sem ela, o agente só sabe o que está no System Prompt — o que é pouco.
Como funciona
- Você sobe documentos (markdown, PDF, URLs).
- A plataforma "fatia" cada documento em trechos de ~500 tokens.
- Cada trecho vira um vetor de embedding (pgvector).
- Quando uma mensagem chega, a plataforma busca os trechos mais semanticamente próximos da pergunta.
- Esses trechos vão como contexto para o LLM gerar a resposta.
Resultado: o agente "fala" usando seu conteúdo, não inventa.
Adicionar conteúdo
Em Configurações → Bots → seu bot → Knowledge Base:
Por upload
- Arquivos suportados:
.md,.txt,.pdf,.docx. - Tamanho máximo por arquivo: 10 MB.
- Suba quantos quiser. Cada upload é indexado em segundos.
Por URL
- Cole a URL de uma página pública.
- A plataforma rastreia e converte para markdown.
- Não indexa páginas que exigem login.
Por colagem direta
- Para conteúdo curto (políticas, FAQs), use o editor inline.
- Salva como markdown nativo.
Manter atualizado
A base de conhecimento não se atualiza sozinha. Se você mudou um preço ou política, precisa:
- Encontrar o documento na lista.
- Substituir (re-upload) ou editar.
- Salvar — re-indexação é automática.
Boa prática: agende uma revisão mensal. Use a aba Analytics → Top intents para ver o que clientes mais perguntam e garantir que essas perguntas estão cobertas.
O que NÃO colocar
- Dados pessoais de clientes (nomes, e-mails, CPFs). Vão para outros clientes em respostas.
- Senhas, chaves de API, tokens.
- Conteúdo sigiloso interno que clientes não deveriam ver.
A regra: se você não publicaria isso no seu site, não coloca aqui.
Limites por plano
| Plano | Documentos | Tamanho total |
|---|---|---|
| Rocket | 50 | 50 MB |
| Spaceship | 500 | 500 MB |
| Enterprise | Ilimitado | 5 GB (acima disso, fala com a gente) |
Diagnosticar respostas ruins
Se o agente está respondendo mal:
- Veja o que ele recuperou. Em Analytics → Sessions, abra uma conversa ruim. A aba Trace mostra quais trechos foram usados.
- Se os trechos certos não aparecem → falta conteúdo na base, ou ele está em formato ruim (PDF escaneado em vez de texto, por exemplo).
- Se os trechos aparecem mas a resposta ignorou → ajuste o System Prompt para "use APENAS o conteúdo fornecido".
- Se ainda assim → talvez o caso precise de Cosmoflow (resposta determinística).