Por que conectar uma Base de Conhecimento?
A Base de Conhecimento (KB) é o cérebro informacional do seu agente. Sem ela, o agente só consegue responder com base no prompt do sistema. Com a KB conectada:| Sem KB | Com KB |
|---|---|
| Respostas genéricas | Respostas específicas do seu negócio |
| Inventa informações | Consulta dados reais |
| Limitado ao prompt | Acesso a documentos completos |
| Não atualiza facilmente | Atualização via plataforma |
Como funciona a integração
Tecnologia RAG
O Flow Builder usa RAG (Retrieval-Augmented Generation):- Retrieval: Busca os trechos mais relevantes na KB
- Augmented: Adiciona o contexto encontrado ao prompt
- Generation: Gera resposta baseada no contexto
Vinculando KB ao Agente
Vá em Base de Conhecimento
No painel do agente, acesse a seção “Base de Conhecimento” ou “Knowledge Base”.
Selecione as bases disponíveis
Você verá as KBs criadas na sua conta Make Talk:
Selecione as bases que o agente deve consultar.
| Base | Conteúdo | Documentos |
|---|---|---|
| KB Produtos | Catálogo, preços, especificações | 15 docs |
| KB Políticas | Trocas, garantia, entregas | 8 docs |
| KB FAQ | Perguntas frequentes | 25 docs |
Configure a prioridade
Se houver múltiplas KBs, defina a ordem de busca:
- KB Produtos (prioridade alta)
- KB FAQ (prioridade média)
- KB Políticas (prioridade baixa)
Configurações avançadas
Limite de resultados
Configure quantos trechos da KB são recuperados por consulta:| Configuração | Uso | Performance |
|---|---|---|
| 3 trechos | Respostas focadas | Rápido |
| 5 trechos | Respostas completas | Moderado |
| 10 trechos | Respostas detalhadas | Mais lento |
Mais trechos significam respostas mais completas, mas também aumentam o tempo de resposta e custo de processamento.
Threshold de relevância
Defina o quão relevante um resultado deve ser para ser usado:| Threshold | Comportamento |
|---|---|
| Alto (0.8+) | Só usa resultados muito relevantes |
| Médio (0.5-0.8) | Usa resultados razoavelmente relevantes |
| Baixo (<0.5) | Usa qualquer resultado encontrado |
Fallback quando não encontrar
Configure o que acontece quando a KB não tem a informação:- Resposta honesta
- Solicitar mais detalhes
- Oferecer alternativas
Boas práticas para a KB
Estrutura do conteúdo
Para melhores resultados, organize sua KB:- Estrutura ideal
- O que evitar
Tipos de conteúdo recomendados
Produtos/Serviços: Nome, descrição, preço, especificações
Políticas: Trocas, devoluções, garantia, prazos
FAQ: Perguntas e respostas diretas
Horários: Funcionamento, atendimento, entregas
Contatos: Telefones, emails, endereços por departamento
Manutenção da KB
Checklist de manutenção:| Frequência | Ação |
|---|---|
| Semanal | Verificar promoções e preços |
| Mensal | Revisar FAQ e adicionar novas perguntas |
| Trimestral | Auditoria completa do conteúdo |
| Conforme necessário | Novos produtos, mudanças de política |
Testando a integração com KB
Perguntas de teste
Faça perguntas que exigem consulta à KB:| Categoria | Pergunta de teste |
|---|---|
| Produto específico | ”Quanto custa o [produto X]?” |
| Política | ”Qual o prazo de troca?” |
| Horário | ”Vocês abrem no sábado?” |
| Processo | ”Como faço para devolver?” |
Validando respostas
Para cada resposta, verifique:Informação está correta e atualizada?
Fonte foi a KB (não inventou)?
Resposta é clara e completa?
Tom está adequado à marca?
Debug de problemas
Se as respostas não estiverem corretas:- Verifique se a KB está vinculada - Configuração do agente
- Confira o conteúdo da KB - Informação existe e está correta?
- Teste a busca - A pergunta encontra o documento certo?
- Ajuste o threshold - Talvez esteja muito alto ou baixo
Exemplos por segmento
- E-commerce
- Imobiliária
- Clínica
KB Produtos:
- Catálogo completo com preços
- Especificações técnicas
- Disponibilidade e prazos
- Troca e devolução (30 dias)
- Frete grátis acima de R$X
- Parcelamento sem juros
- “Tem frete grátis?”
- “Posso parcelar em quantas vezes?”
- “Qual o prazo de entrega?”
Solução de problemas
Agente não encontra informações que existem na KB
Agente não encontra informações que existem na KB
Possíveis causas:
- Conteúdo mal estruturado
- Threshold muito alto
- Pergunta muito diferente do conteúdo
- Reformule o conteúdo com palavras-chave claras
- Reduza o threshold de relevância
- Adicione variações de perguntas ao FAQ
Agente responde com informação errada
Agente responde com informação errada
Possíveis causas:
- KB desatualizada
- Informações conflitantes
- Conteúdo ambíguo
- Atualize a KB com dados corretos
- Remova conteúdo duplicado ou conflitante
- Seja específico e direto no conteúdo
Respostas muito genéricas mesmo com KB
Respostas muito genéricas mesmo com KB
Possíveis causas:
- Limite de trechos muito baixo
- Conteúdo pouco detalhado
- Prompt não orienta a usar KB
- Aumente o número de trechos recuperados
- Enriqueça o conteúdo da KB
- Adicione no prompt: “Sempre consulte a base de conhecimento”
Documentação Relacionada
Treinamento da IA
O que é RAG
Entenda a tecnologia por trás da busca inteligente.
Documento de Treinamento
A base principal para ensinar a IA sobre seu negócio.
Criar Base Eficiente
Aprenda a estruturar sua KB para melhores resultados.
Perguntas e Respostas
Configure FAQs para respostas mais precisas.
Manutenção e Boas Práticas
Manter Atualizado
Boas práticas de manutenção da KB.
Checklist de Ingestão
Verificações antes de publicar conteúdo.
Modelo de Documento
Templates prontos para sua KB.
Erros Comuns
Evite problemas frequentes na criação da base.