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.