Vinculando uma Knowledge Base a um Agente

Criar uma Knowledge Base é o primeiro passo. O Agente só consulta essa base quando tem uma Knowledge Base Search Tool apontando para ela.

Você pode criar a base e anexar essa tool no mesmo envio, pelo campo Quais agentes devem usar isto? — ver Vincular a Agentes. Também dá para adicionar a tool depois, na configuração do Agente.

---

🧠 Como Funciona o Vínculo

Todo Agente tem sua própria lista de Tools.
Quando você adiciona a Knowledge Base Search Tool, escolhe qual Knowledge Base esse Agente vai consultar.

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.

---

⚙️ Vinculando na criação da base

1. Abra Builder → Conhecimento (ou Conhecimento no submenu do Agente).
2. Clique em Nova Base de Conhecimento.
3. Preencha Nome.
4. Em Quais agentes devem usar isto?, ligue os Agentes.
5. Clique em Criar base de conhecimento.

A plataforma cria a tool {nome} Search e a anexa aos Agentes selecionados. Toast: Base de conhecimento criada e vinculada aos agentes selecionados.

⚙️ Vinculando pelo Agente

1. Vá até Builder → Agentes → [Selecione seu Agente] → Ferramentas
2. Clique em Nova Ferramenta ou Vincular Ferramenta
3. Escolha a Knowledge Base Search Tool
4. Na janela de configuração:
   • Selecione a Knowledge Base
   • Ajuste os parâmetros de recuperação (se disponíveis)
   • Salve as mudanças

Depois de vinculada, o Agente passa a consultar esses dados no raciocínio e nas respostas.

---

🧩 Vinculando a um Squad

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

---

💬 Cenário de Exemplo

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.

---

🧭 Boas Práticas

• 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.