Pular para o conteúdo principal

​
Integração do Nexus de Conhecimento

A partir de v1.0.0-rc3, os agentes de IA podem consultar espaços do Knowledge Nexus diretamente no prompt, usando a ferramenta nativa knowledge_nexus_search. Isso permite responder com base em documentação interna, perguntas frequentes e bases de conhecimento mantidas no Nexus, sem configurar uma ferramenta customizada.
Para a base de conhecimento integrada do CRM (PDFs, arquivos colados manualmente), continue usando o módulo Base de Conhecimento. Nexus é complementar — útil quando sua organização já mantém uma base de conhecimento separada e deseja reutilizá-la no agente.

​
Pré-requisitos

  • Uma instalação WTO Nexus acessível pela rede CRM.
  • Pelo menos um espaço criado no Nexus com documentos indexados.
  • Permissão na sua função para editar agentes (agents.manage).
A conexão CRM-Nexus é configurada pelo operador de instalação (ver documentação WTO Nexus). Como usuário do CRM, você consome a integração sem configurar credenciais.

​
Vinculando um Espaço ao Agente

  1. Abra os detalhes de um agente em Agents → [agent name].
  2. Acesse Integrações → Knowledge Nexus.
  3. Clique no seletor de espaço. O CRM consulta o Nexus API (por meio do proxy de serviço principal) e lista os espaços disponíveis.
  4. Verifique os espaços que este agente deverá poder consultar.
  5. Salve.
Você pode vincular vários espaços ao mesmo agente — o agente decide qual deles consultar em cada momento com base no contexto da pergunta.

​
Como o agente usa o Nexus

O agente recebe automaticamente em seu vocabulário uma ferramenta chamada knowledge_nexus_search. Quando o usuário faz uma pergunta cuja resposta está plausível na base, o LLM chama essa ferramenta de:
A ferramenta retorna os snippets mais relevantes indexados no espaço. O agente utiliza esses trechos para redigir a resposta, citando o contexto quando apropriado.

​
Comportamento Esperado

  • Resposta da fonte: se o snippet encontrado responder diretamente, o agente cita a informação.
  • Resposta com lacuna: caso a base não cubra o caso, o agente informa que não encontrou informações específicas e pede mais contexto, em vez de inventar (com um prompt bem calibrado).
  • Retorno vazio: se a busca não retornar nada, o agente continua a conversa sem citar a base.

​
Quando usar a base de conhecimento Nexus vs CRM

Não é exclusivo – você pode usar ambos no mesmo agente.

​
Diagnosticando

Se o agente não estiver usando o Nexus apesar de estar vinculado:
  1. Confirme o link. Reabra os dados do agente; o espaço deve aparecer marcado.
  2. Verifique as permissões. O agente deve ter agents.read nos recursos vinculados.
  3. Veja se o espaço possui documentos indexados. Caso o espaço esteja vazio ou ainda processando documentos, a ferramenta retorna vazia.
  4. Revise o prompt. Se o prompt do sistema do agente for muito rígido (por exemplo, “responda apenas com base no que você sabe”), ele poderá não chamar a ferramenta. Ajuste o prompt para deixar explícito quando consultar a base externa.
  5. Logs do processador. O serviço wto-ai-processor-community registra chamadas de ferramenta — útil quando você precisa confirmar se a ferramenta foi realmente chamada.

​
Considerações Finais

A integração do Knowledge Nexus separa o gerenciamento do conhecimento do gerenciamento de CRM. Mantenha as bases atualizadas onde elas residem naturalmente e deixe o agente conectá-las na hora da conversa.