Pular para o conteúdo

Vinculando uma Knowledge Base a um Agente

Criar uma Knowledge Base é apenas o primeiro passo — para torná-la funcional, você precisa vinculá-la a um Agente ou Squad.
Essa conexão é estabelecida através do Knowledge Tool, disponível dentro da configuração de cada Agente.


Todo Agente tem sua própria lista de Tools.
Quando você adiciona o Knowledge Tool, pode escolher quais Knowledge Bases esse Agente vai usar como fontes de referência.

Um Agente pode:

  • Usar múltiplas Knowledge Bases simultaneamente.
  • Compartilhar a mesma Knowledge Base com outros Agentes ou Squads.
  • Recuperar dados relevantes dinamicamente com base no contexto.

Essa flexibilidade permite construir ecossistemas complexos, nos quais informações compartilhadas potencializam múltiplos Agentes inteligentes.


  1. Vá até Builder → Agentes → [Selecione seu Agente] → Tools
  2. Clique em Add Tool +
  3. Escolha o Knowledge Tool na lista
  4. Na janela de configuração:
    • Selecione uma ou mais Knowledge Bases para vincular
    • Ajuste os parâmetros de recuperação (se disponíveis)
    • Salve as mudanças

Depois de vinculada, o Agente vai automaticamente começar a usar esses dados para raciocínio contextual e respostas.


Quando Agentes pertencem a um Squad, qualquer Knowledge Base conectada a esses Agentes por meio do Knowledge Tool fica disponível para todo o contexto do Squad.
Isso permite ambientes de conhecimento compartilhado para times de Agentes que colaboram no mesmo workflow.


Knowledge Base: Zaia Commercial Knowledge
Vinculada via: Knowledge Tool
Usada por:

  • Agente Ju da Zaia → Atende dúvidas de clientes
  • Agente Alfred → Constrói workflows personalizados
  • Squad da Zaia → Combina os dois agentes em operações colaborativas

As três entidades referenciam a mesma Knowledge Base.
Se a base for atualizada ou retreinada, as mudanças se propagam imediatamente para todos os Agentes e Squads que a utilizam.


  • Mantenha uma única fonte de verdade. Reutilize Knowledge Bases entre Agentes sempre que possível.
  • Modularize o conteúdo. Crie bases separadas para tópicos como Vendas, Produto e Suporte.
  • Teste os limites do contexto. Garanta que os Agentes não estejam recuperando dados em excesso de fontes não relacionadas.
  • Monitore o desempenho. Retreine ou limpe o conteúdo periodicamente para manter a consistência.