Knowledge Base Search Tool

A Knowledge Base (KB) Search Tool permite que seu Agente consulte repositórios estruturados de documentos, FAQs, guias ou políticas criados dentro do Zaia Endless.
É a forma mais eficiente de garantir que seu Agente sempre tenha acesso a informações atualizadas e confiáveis sem sobrecarregar o Prompt principal.

🔎 O que é uma Knowledge Base?

Uma Knowledge Base no Endless é um contêiner estruturado onde você armazena informações como:

Políticas e procedimentos da empresa
Documentação de produtos
Descrições de preços e planos
Perguntas frequentes (FAQs)
Materiais de treinamento e onboarding

Diferente do Prompt do Agente, as Knowledge Bases são otimizadas para busca e recuperação, permitindo que o Agente acesse apenas o que é relevante para cada pergunta.

⚙️ Como a tool funciona

O campo Description define quando o Agente deve usar essa tool.
Você deve vincular a tool a uma Knowledge Base existente usando seu ID.
Quando acionada, o Agente busca na Knowledge Base e integra os resultados mais relevantes à sua resposta.

🆕 Opções de execução

A Knowledge Base Search Tool inclui dois toggles de execução que controlam como a busca se comporta:

🔁 Execute Always

Quando ativado, a busca na Knowledge Base é executada em toda resposta do Agente, independentemente da pergunta do usuário.

Use quando a Knowledge Base contiver contexto crítico que sempre deve influenciar as respostas.
Quando desativado, o Agente decide dinamicamente se a KB é relevante.

📄 Preselect Documents

Quando ativado, o Agente primeiro seleciona o documento mais relevante antes de buscar em seu conteúdo.

A seleção é baseada no campo Description de cada documento na Knowledge Base.
Após escolher o documento mais adequado, o Agente busca apenas nos blocos gerados a partir desse documento.

Isso melhora a precisão e o desempenho, especialmente em Knowledge Bases com muitos documentos.

📐 Quando usar uma Knowledge Base

Use uma Knowledge Base quando:

A informação muda com frequência (preços, políticas, documentação)
O conteúdo é longo demais para o Prompt do Agente
É necessária uma recuperação estruturada

Dica:
Mantenha regras de comportamento estáveis no Prompt e armazene informações longas ou em constante evolução nas Knowledge Bases.

🛠️ Exemplo de configuração

Cenário: Seu Agente precisa responder perguntas sobre preços.

Crie uma Knowledge Base
- Nome: Pricing and Plans
- Envie a documentação de preços ou FAQs
Configure a Tool
- Description:
  “Use esta tool quando o usuário perguntar sobre preços, planos, cobrança ou upgrades.”
- Knowledge Base ID: Pricing and Plans
- Execute Always: Desativado
- Preselect Documents: Ativado

Se um usuário perguntar “O que está incluído no Pro Plan?”, o Agente recupera a informação de preço correta diretamente da Knowledge Base.

✅ Boas práticas

Escreva descrições de tool claras e orientadas à ação
Use descrições relevantes para cada documento na Knowledge Base
Ative Preselect Documents para KBs grandes ou diversas
Mantenha as Knowledge Bases atualizadas para evitar respostas desatualizadas
Evite duplicar o mesmo conteúdo no Prompt e na KB

🎯 Resumo

A Knowledge Base Search Tool dá ao seu Agente conhecimento estruturado e atualizado sob demanda.
Com o Preselect Documents, a recuperação se torna mais rápida e precisa, restringindo a busca ao documento mais relevante antes de ler seu conteúdo.

Usada corretamente, ela mantém os Agentes precisos, escaláveis e fáceis de manter.