Knowledge Base
A fonte de conhecimento narrativo do seu agente — como criar, organizar e manter documentos que fazem o agente responder bem
Knowledge Base 📚
A Knowledge Base (KB) é a "memória narrativa" do seu negócio. É onde você explica, em linguagem natural, tudo que o agente precisa saber para responder com qualidade: o que você faz, como funciona, o que está incluso, quais são as regras.
Regra de ouro
Não coloque preços aqui — use a aba Serviços.
A KB é para conteúdo explicativo. Preços e durações ficam nos Serviços. Se você colocar ambos na KB, o agente pode citar valores desatualizados ou conflitantes.
Categorias disponíveis
| Categoria | Exemplos de conteúdo |
|---|---|
| FAQ | Perguntas frequentes (aceita plano de saúde? tem estacionamento? como cancela?) |
| Serviço / Procedimento | O que é o serviço, como funciona, o que o cliente deve esperar |
| Protocolo | Passo a passo de um procedimento (ex: como é a avaliação inicial) |
| Política | Cancelamento, reembolso, horários, regras da casa |
| Promoção | Ofertas temporárias com prazo de validade |
Exemplos bons vs ruins
Clínica de Fisioterapia — documento sobre Pilates Solo:
✅ Bom:
"Nossa aula de Pilates Solo é realizada em turma de no máximo 4 pessoas, com foco em controle do movimento, postura e fortalecimento do core. Cada sessão dura 55 minutos. É indicada tanto para iniciantes quanto para quem já tem experiência — a intensidade é ajustada individualmente. Trazemos roupas confortáveis e meias antiderrapantes."
❌ Ruim:
"Pilates Solo custa R$ 120 avulsa ou R$ 380/mês. Dura 55 min."
O ruim vai na aba Serviços, não aqui.
Como o agente usa a KB
Quando um cliente faz uma pergunta, o agente usa a ferramenta buscar_knowledge_base — uma busca semântica que encontra os documentos mais relevantes mesmo que o cliente não use as palavras exatas. Por exemplo: "vocês trabalham com postura?" vai encontrar o documento sobre Pilates Solo mesmo sem a palavra "postura" no título.
Por isso, escreva como você explicaria para um cliente presencialmente — não como um manual técnico. Linguagem natural funciona melhor que bullets e jargões.
Quando reescrever vs criar documento novo
- Reescrever quando a informação existente ficou desatualizada (mudou o protocolo, novo endereço, nova regra de cancelamento)
- Criar novo quando for um assunto diferente do que já existe — mesmo que relacionado
Evite um único documento gigante com tudo misturado. Documentos focados funcionam melhor na busca semântica.
Avaliar a qualidade da KB
O botão ✨ Avaliar base de conhecimento gera uma pontuação de 0 a 100 com sugestões de melhoria. Use após criar os primeiros documentos para saber onde há lacunas.
Dicas de manutenção
- Revise a KB pelo menos uma vez por semana nas primeiras 4 semanas
- Olhe os handoffs: se clientes perguntam "como funciona a avaliação?" e o agente transfere, é sinal que falta um documento sobre isso
- FAQ é o documento mais vivo — adicione perguntas reais que os clientes fazem
- Promoções devem ter data de validade no texto para o agente não citar promoções encerradas
Limite de documentos: Starter suporta até 5 documentos. No plano Pro o limite sobe para 10 documentos. Saiba mais sobre o plano Pro
Um bom ponto de partida: responda por escrito as 10 perguntas que você mais ouve dos clientes. Isso já é uma KB funcional para começar.
Documentos muito longos (mais de 800 palavras) reduzem a precisão da busca semântica. Prefira criar dois documentos menores a um documento enorme.