Skip to main content
A partir de v1.0.0-rc3, los agentes de IA pueden consultar Knowledge Nexus spaces directamente desde el prompt, usando la tool nativa knowledge_nexus_search. Esto permite responder con base en documentación interna, FAQs y bases de conocimiento mantenidas en Nexus, sin configurar tool personalizada.
Para la base de conocimiento incorporada del CRM (PDFs, archivos pegados manualmente), sigue usando el módulo Base de Conocimiento. Nexus es complementario — útil cuando tu organización ya mantiene una base de conocimiento separada y quiere reaprovecharla en el agente.

​
Prerrequisitos

  • Una instalación de Evo Nexus accesible por la red del CRM.
  • Al menos un space creado en Nexus con documentos indexados.
  • Permiso en tu rol para editar agentes (agents.manage).
La conexión entre CRM y Nexus es configurada por el operador de la instalación (ver documentación de Evo Nexus). Como usuario del CRM, consumes la integración sin configurar credencial.

​
Vinculando un Space al Agente

  1. Abre el detalle de un agente en Agentes → [nombre del agente].
  2. Ve hasta la sección Integraciones → Knowledge Nexus.
  3. Haz clic en el selector de spaces. El CRM consulta la API de Nexus (vía proxy del core-service) y lista los spaces disponibles.
  4. Marca los spaces que ese agente debe poder consultar.
  5. Guarda.
Puedes vincular múltiples spaces a un mismo agente — el agente decide cuál consultar en cada momento, con base en el contexto de la pregunta.

​
Cómo el agente usa Nexus

El agente recibe automáticamente una tool llamada knowledge_nexus_search en su vocabulario. Cuando el usuario hace una pregunta cuya respuesta plausiblemente está en la base, el LLM llama esa tool:
La tool devuelve los fragmentos más relevantes indexados en el space. El agente usa esos fragmentos para componer la respuesta, citando el contexto cuando apropiado.

​
Comportamiento esperado

  • Respuesta con base en la fuente: si el fragmento encontrado responde directamente, el agente cita la información textualmente.
  • Respuesta con gap: si la base no cubre el caso, el agente informa que no encontró información específica y pide más contexto, en vez de inventar (con prompt bien calibrado).
  • Respuesta de retorno vacío: si la búsqueda no devuelve nada, el agente sigue la conversación sin citar la base.

​
Cuándo usar Nexus vs Base de Conocimiento del CRM

No es exclusivo — puedes usar los dos al mismo tiempo en el mismo agente.

​
Diagnóstico

Si el agente no está usando Nexus a pesar de estar vinculado:
  1. Confirma la vinculación. Reabre el detalle del agente; el space debe aparecer marcado.
  2. Chequea permisos. El agente necesita tener agents.read sobre los recursos vinculados.
  3. Ve si el space tiene documentos indexados. Si el space está vacío o todavía procesando documentos, la tool devuelve vacío.
  4. Revisa el prompt. Si el system prompt del agente es muy rígido (ej.: “responde solo con base en lo que sabes”), puede no llamar la tool. Ajusta el prompt para dejar explícito cuándo consultar la base externa.
  5. Logs del processor. El servicio evo-ai-processor-community registra las llamadas a tools — útil cuando necesitas confirmar si la tool fue de hecho invocada.

​
Consideraciones Finales

La integración con Knowledge Nexus desacopla la gestión de conocimiento de la gestión del CRM. Mantén las bases actualizadas en el lugar donde naturalmente viven, y deja al agente hacer el puente en la hora de la conversación.