Como Funciona a Conexão
Criar uma base de conhecimento não é suficiente para que o agente a utilize — é necessário conectar explicitamente a base ao agente. Essa conexão é estabelecida na aba de treinamento do agente e ativa o pipeline de retrieval para todas as conversas atendidas por ele. Quando a conexão está ativa, o agente executa automaticamente uma busca semântica na base a cada mensagem recebida. Os chunks com similaridade acima do threshold configurado são incluídos no contexto enviado ao LLM junto com a mensagem do usuário. A resposta é então formulada com base nesses trechos recuperados. Um agente pode ter múltiplas bases conectadas simultaneamente. Nesse caso, a busca é executada em todas as bases ao mesmo tempo. Os resultados são ordenados por similaridade e os melhores chunks do conjunto total são selecionados — não um top-k por base.Conectando uma Base de Conhecimento
Abra o agente
No menu lateral, acesse Agentes e clique no agente que receberá a base de conhecimento.
Acesse a aba Treinamento
Dentro da tela do agente, clique na aba Treinamento (ou Knowledge). Esta aba centraliza todas as fontes de conhecimento do agente.
Adicione a base
Na seção Bases de conhecimento, clique em + Adicionar base. Uma lista das bases disponíveis no workspace será exibida. Selecione a base desejada e confirme.
Configure os parâmetros de retrieval
Após adicionar, os parâmetros ficam disponíveis para edição:
- Top-k — número máximo de chunks retornados por consulta. Padrão:
5. Valores maiores trazem mais contexto, mas aumentam o tamanho do prompt enviado ao LLM. - Threshold — limiar mínimo de similaridade coseno (0 a 1). Padrão:
0.7. Chunks com similaridade abaixo desse valor são descartados automaticamente.
Conectando a um Squad
Um squad é um grupo de agentes especializados que colaboram numa mesma conversa. Quando uma base de conhecimento é conectada ao squad (em vez de a um agente específico), todos os agentes do squad passam a consultá-la durante suas interações. Acesse a configuração do squad, abra a aba de Bases de conhecimento e adicione a base da mesma forma que faria para um agente individual. A base fica compartilhada entre todos os membros do squad sem duplicação — o conteúdo é indexado uma única vez e consultado por todos. Use essa abordagem quando o conhecimento é transversal a todos os agentes do squad (ex.: políticas gerais da empresa). Para conhecimento especializado de um agente específico (ex.: catálogo de produtos consultado apenas pelo agente de vendas), conecte a base diretamente ao agente, não ao squad.Cenário de Exemplo
Uma empresa de e-commerce tem três agentes: Suporte, Vendas e Financeiro. Cada um usa bases específicas:- Suporte: base “Perguntas Frequentes” + base “Políticas de Troca e Devolução”
- Vendas: base “Catálogo de Produtos 2025” + base “Promoções Vigentes”
- Financeiro: base “Condições de Parcelamento” + base “FAQ Pagamentos”
Boas Práticas
- Antes de conectar a base ao agente, verifique se os documentos estão com status Indexado. Documentos em Processando ainda não contribuem para as buscas e podem gerar a impressão de que a base não funciona.
- Ajuste o threshold de forma incremental: reduza em 0.05 por vez e reavalie o comportamento do agente após cada ajuste. Mudanças drásticas tornam difícil isolar o efeito.
- Separe conhecimentos com propósitos muito distintos em bases diferentes. Uma base “FAQ de Suporte” e uma base “Catálogo de Produtos” devem ser bases separadas — facilita a manutenção e permite desconectar uma sem afetar a outra.
- Para bases com conteúdo técnico e denso, aumente o top-k para 7 a 10. Para bases de Q&A com respostas curtas, top-k de 3 é suficiente e reduz o custo de tokens.