Saltar al contenido principal

​
Integración del Nexo de Conocimiento

A partir de v1.0.0-rc3, los agentes de IA pueden consultar espacios de Knowledge Nexus directamente desde el mensaje, utilizando la herramienta nativa knowledge_nexus_search. Esto permite responder basándose en documentación interna, preguntas frecuentes y bases de conocimiento mantenidas en Nexus, sin configurar una herramienta personalizada.
Para la base de conocimientos integrada de CRM (PDF, archivos pegados manualmente), siga usando el módulo Base de conocimientos. Nexus es complementario: útil cuando su organización ya mantiene una base de conocimientos separada y desea reutilizarla en el agente.

​
Requisitos previos

  • Una instalación WTO Nexus accesible desde la red CRM.
  • Al menos un espacio creado en Nexus con documentos indexados.
  • Permiso en su rol para editar agentes (agents.manage).
La conexión CRM-Nexus la configura el operador de instalación (consulte la documentación de WTO Nexus). Como usuario de CRM, consume la integración sin configurar credenciales.

​
Vincular un espacio al agente

  1. Abra los detalles de un agente en Agents → [agent name].
  2. Vaya a Integraciones → Knowledge Nexus.
  3. Haga clic en el selector de espacio. El CRM consulta el Nexus API (a través del proxy del servicio principal) y enumera los espacios disponibles.
  4. Marque los espacios que este agente debería poder consultar.
  5. Guardar.
Puedes vincular múltiples espacios al mismo agente: el agente decide cuál consultar en cada momento según el contexto de la pregunta.

​
Cómo utiliza el agente Nexus

El agente recibe automáticamente una herramienta denominada knowledge_nexus_search en su vocabulario. Cuando el usuario hace una pregunta cuya respuesta es plausible en la base, el LLM llama a esta herramienta:
La herramienta devuelve los fragmentos más relevantes indexados en el espacio. El agente utiliza estos fragmentos para redactar la respuesta, citando el contexto cuando sea apropiado.

​
Comportamiento esperado

  • Respuesta de la fuente: si el fragmento encontrado responde directamente, el agente cita la información.
  • Respuesta con vacío: si la base no cubre el caso, el agente informa que no encontró información específica y pide más contexto, en lugar de inventar (con un mensaje bien calibrado).
  • Retorno vacío: si la búsqueda no arroja nada, el agente continúa la conversación sin citar la base.

​
Base de conocimientos sobre cuándo utilizar Nexus frente a CRM

No es exclusivo: puedes utilizar ambos en el mismo agente.

​
Diagnóstico

Si el agente no utiliza Nexus a pesar de estar vinculado:
  1. Confirma el enlace. Vuelve a abrir los detalles del agente; el espacio debería aparecer marcado.
  2. Verifique los permisos. El agente debe tener agents.read en los recursos vinculados.
  3. Vea si el espacio tiene documentos indexados. Si el espacio está vacío o aún procesa documentos, la herramienta regresa vacío.
  4. Revise el mensaje. Si el mensaje del sistema del agente es demasiado rígido (por ejemplo, “responda solo según lo que sabe”), es posible que no llame a la herramienta. Ajuste el mensaje para hacer explícito cuándo consultar la base externa.
  5. Registros del procesador. Las llamadas a la herramienta de registros de servicio wto-ai-processor-community son útiles cuando necesita confirmar si la herramienta realmente se invocó.

​
Consideraciones finales

La integración de Knowledge Nexus desacopla la gestión del conocimiento de la gestión de CRM. Mantenga actualizadas las bases donde viven naturalmente y permita que el agente las conecte durante el momento de la conversación.