Ferramenta de Base de Conhecimento
A ferramenta de Base de Conhecimento conecta seu agente às suas coleções de documentos, habilitando-o a buscar e recuperar informações relevantes durante conversas. Esta técnica, conhecida como RAG (Retrieval-Augmented Generation), fundamenta as respostas do seu agente no seu conteúdo real ao invés de depender apenas dos dados de treinamento.
Como Funciona
Usuário: "Qual é a política de devolução de vocês?"
↓
Agente busca: Base de conhecimento por "política de devolução"
↓
Sistema recupera: Trechos relevantes dos seus documentos
↓
Agente responde: Baseado no documento real da sua políticaO Processo RAG
- Entendimento da Consulta - Agente interpreta a pergunta do usuário
- Busca Semântica - Sistema encontra trechos de documentos por significado, não apenas palavras-chave
- Injeção de Contexto - Conteúdo recuperado é adicionado ao contexto do agente
- Resposta Fundamentada - Agente responde baseado nas informações recuperadas
Por Que RAG Importa
Sem RAG, um agente só sabe o que está nos dados de treinamento dele (que tem uma data de corte e não inclui informações da sua empresa). Com RAG, o agente pode responder perguntas sobre seus produtos, políticas e procedimentos específicos.
Configurando a Ferramenta de Base de Conhecimento
Pré-requisitos
Antes de configurar esta ferramenta, você precisa de uma Base de Conhecimento com documentos indexados. Veja Base de Conhecimento para instruções de configuração.
Configuração
- Navegue para Configuração do Agente > Ferramentas
- Encontre a seção Base de Conhecimento
- Selecione a base de conhecimento para conectar
- Configure parâmetros de busca
- Salve as mudanças
Parâmetros de Busca
| Parâmetro | Descrição | Padrão |
|---|---|---|
| Número de resultados | Quantos trechos de documento recuperar | 5 |
| Limite de similaridade | Pontuação mínima de relevância (0-1) | 0.7 |
| Incluir metadados | Retornar títulos de documentos e fontes | Sim |
Ajustando Resultados
- Mais resultados = Mais contexto mas maior uso de tokens
- Limite maior = Mais preciso mas pode perder conteúdo relevante
- Comece com os padrões e ajuste baseado na qualidade das respostas
Melhores Práticas
1. Qualidade Entra = Qualidade Sai
As respostas do agente são tão boas quanto seus documentos indexados:
| Qualidade do Documento | Resultado |
|---|---|
| Conteúdo claro, bem escrito | Respostas precisas e úteis |
| Informações desatualizadas | Respostas incorretas |
| Formatação inconsistente | Resultados imprevisíveis |
| Tópicos faltando | Respostas "Não sei" |
Mantenha Documentos Atualizados
Quando políticas ou informações de produtos mudam, atualize sua Base de Conhecimento imediatamente. O agente continuará citando informações antigas até que os documentos sejam atualizados.
2. Estruture Documentos Efetivamente
O sistema divide documentos em trechos para recuperação. Ajude este processo:
✅ Boa estrutura:
# Política de Devolução
## Prazo
Você pode devolver itens dentro de 30 dias da compra.
## Requisitos de Condição
Itens devem estar sem uso e na embalagem original.
## Processo de Reembolso
Reembolsos são processados em 5-7 dias úteis.❌ Estrutura ruim:
Nossa política de devolução permite devoluções em 30 dias itens
devem estar sem uso na embalagem original reembolsos levam 5-7 dias
também oferecemos trocas contate suporte para ajuda...3. Oriente o Comportamento do Agente
Configure como seu agente usa a Base de Conhecimento nas instruções:
## Usando Base de Conhecimento
- Sempre busque na base de conhecimento antes de dizer que não sabe algo
- Se a base de conhecimento não tiver informações relevantes, diga:
"Não tenho informações específicas sobre isso nos meus recursos.
Gostaria que eu conectasse você com um membro da equipe?"
- Cite fontes quando útil: "De acordo com nossa política de devolução..."
- Não invente informações não encontradas na base de conhecimento4. Trate "Não Encontrado" Graciosamente
Quando a base de conhecimento não tem uma resposta:
## Quando Informação Não Está Disponível
Se você não conseguir encontrar informações relevantes:
1. Reconheça honestamente: "Não tenho essa informação específica."
2. Ofereça alternativas: "Posso ajudar você com X, Y ou Z."
3. Forneça escalação: "Gostaria que eu conectasse você com suporte?"
Nunca invente respostas. É melhor dizer "Não sei" do que fornecer
informações incorretas.5. Combine com Outras Ferramentas
Base de Conhecimento funciona bem junto com outras ferramentas:
| Cenário | Ferramentas Combinadas |
|---|---|
| Info de produto + preços | Base de Conhecimento + API (busca de preço) |
| FAQ + promoções atuais | Base de Conhecimento + API (serviço de promoções) |
| Política + status do pedido | Base de Conhecimento + API (sistema de pedidos) |
Limitações
Limitações de Recuperação
- Semântico vs. correspondência exata - Pode não encontrar conteúdo que requer correspondência exata de palavras-chave
- Limites de trechos - Informação dividida entre trechos pode perder contexto
- Qualidade de embedding - Terminologia incomum pode não ser bem representada
Limitações de Resposta
- Risco de alucinação - Agente pode extrapolar além do conteúdo recuperado
- Tratamento de contradições - Pode ter dificuldade com informações conflitantes
- Raciocínio complexo - Deduções lógicas de múltiplos passos podem não ser confiáveis
Mitigando Limitações
- Use terminologia clara e consistente nos documentos
- Mantenha informações relacionadas juntas
- Adicione instruções explícitas de "não alucinar"
- Teste com perguntas reais de usuários
Monitoramento e Melhoria
Acompanhe Perguntas Comuns
Revise logs de conversas para identificar:
- Perguntas com respostas ruins → Adicione melhor conteúdo
- Perguntas não respondidas → Adicione tópicos faltantes
- Perguntas mal interpretadas → Melhore terminologia
Itere nos Documentos
- Lance com conjunto inicial de documentos
- Monitore qualidade das conversas
- Identifique lacunas e problemas
- Atualize documentos conforme necessário
- Re-indexe quando documentos mudam
- Repita o ciclo de melhoria
Solução de Problemas
Agente Ignora Base de Conhecimento
- Verifique se a ferramenta está habilitada
- Verifique se a base de conhecimento tem documentos indexados
- Revise descrição da ferramenta—está claro quando usar?
- Teste com uma pergunta direta que você sabe estar nos documentos
Resultados Irrelevantes
- Diminua o número de resultados
- Aumente o limite de similaridade
- Verifique qualidade e estrutura dos documentos
- Garanta que consultas de busca correspondam à terminologia dos documentos
Respostas Desatualizadas
- Verifique se documentos fonte estão atuais
- Re-indexe após atualizar documentos
- Verifique se versões antigas não ainda estão presentes
Informação Faltando
- Confirme que o tópico está nos seus documentos
- Verifique tamanho dos trechos—informação pode estar dividida estranhamente
- Tente reformular a pergunta de teste
- Considere adicionar cobertura explícita do tópico
Documentação Relacionada
- Base de Conhecimento - Criando e gerenciando bases de conhecimento
- Visão Geral de Ferramentas - Entendendo ferramentas de agentes
- Integração com API - Busca de dados em tempo real
- Scraping de Website - Importe conteúdo web para base de conhecimento