Conectando a Agentes

Criar a base não conecta automaticamente ao agente. Para o agente passar a consultar o conteúdo, você precisa ativar a ferramenta nativa Consultar Base de Conhecimento no agente e marcar quais bases ele pode usar.

Ativando a ferramenta

1. Abra Admin → Agentes e clique em Editar no agente.
2. Vá para a aba Ferramentas.
3. Clique em Adicionar Ferramenta.
4. Em Ferramentas Nativas, selecione Consultar Base de Conhecimento.

O painel de configuração abre à direita:

Configurando

• Toggle no topo — ativa/desativa a ferramenta para este agente.
• Descrição para o agente (opcional) — instrução curta que aparece para o modelo quando ele decide se usa a ferramenta. Exemplo: “Use para consultar informações sobre nossos produtos, preços e políticas internas.”
• Selecione as bases de conhecimento disponíveis — lista com checkbox de todas as bases da organização. Marque uma ou mais.

Sem nenhuma base marcada, o aviso amarelo aparece e o agente não terá acesso a base alguma — a ferramenta fica ligada mas inútil. Marque pelo menos uma base antes de Salvar e Fechar.

Quando conectar mais de uma base

Use várias bases quando o agente cobre domínios diferentes — por exemplo, suporte técnico + políticas comerciais + catálogo de produtos. O agente recebe trechos relevantes de qualquer base marcada e responde com base no que vier.

Se as bases tiverem conteúdo muito parecido, ele pode receber trechos redundantes. Nesse caso, reorganize o conteúdo ou consolide em uma base só.

Orientando o prompt

A descrição da ferramenta ajuda o modelo a decidir quando chamar a busca, mas o prompt do agente continua sendo o lugar para deixar a política clara:

Use a base de conhecimento para responder perguntas sobre planos, políticas e configurações.
Se a base não trouxer informação suficiente, diga que não encontrou a resposta e faça uma pergunta de esclarecimento.

AutoLearn — capturando o que falta

Se você também ativar a ferramenta AutoLearn no mesmo agente, toda vez que ele não encontrar resposta na base a pergunta vai parar em Admin → Bases de Conhecimento → AutoLearn, prontinha para virar conteúdo novo. Detalhes em Oportunidades de Aprendizado (AutoLearn).

Validando

Depois de conectar, teste no chat:

• perguntas com resposta presente na base;
• perguntas parecidas, mas não idênticas, ao texto indexado;
• perguntas fora do escopo (para ver se o agente sabe dizer “não tenho essa informação”);
• perguntas que exigem combinar prompt e base.