Nexus Agent Tools
Nexus Agent Tools da a un Voice Agent las herramientas de un agente de Nexus. Es la pieza de los agentes de voz de Nexus: en Nexus se crea el agente (qué hace y qué herramientas puede usar) y NappAI le pone la voz, en el navegador o por teléfono.
Cada vez que el agente de voz usa una herramienta, la llamada va a Nexus y se ejecuta allí, igual que para cualquier agente de Nexus: con las herramientas que eligió su dueño, con los permisos de ese dueño y con su autonomía. Una acción que no puede hacer solo queda pendiente en Para ti del dueño, y el agente lo dice en la llamada.
Cuándo usarlo
Normalmente no lo montas tú: lo usa la plantilla de los agentes de voz de Nexus, un flujo de tu cuenta con un Voice Agent y este componente en sus herramientas. Cuando alguien crea un agente de voz en Nexus (Mis Copilotos › Agentes de voz), Nexus lo da de alta en esa plantilla con su nombre, su prompt, su saludo y la clave de su canal.
Todos los agentes de voz de Nexus de tu cuenta comparten ese único flujo. Cada llamada sabe de qué agente es y usa lo de ese agente. Así los agentes no gastan un flujo de tu plan cada uno, y lo que cambias en la plantilla les llega a todos.
Lo que sí haces en NappAI es preparar la plantilla: el modelo, el oído (STT), la voz (TTS) y el resto del comportamiento de la llamada de todos los agentes.
Configuración
| Campo | Qué hace |
|---|---|
| Nexus URL (obligatorio) | La dirección de Nexus tal como la alcanza NappAI, por ejemplo https://nexus.tu-empresa.com. Se le añade /api/v1/agent-mcp. |
| Voice channel key (obligatorio) | La clave del canal de voz del agente. La pone Nexus y la cambia en cada publicación; solo abre las herramientas de ese agente. |
| Nexus agent (avanzado) | La clave del agente de Nexus. Nexus comprueba que coincide con la del canal. |
| Only these tools (avanzado) | Opcional. Restringe todavía más las herramientas, separadas por comas. |
En la plantilla deja los tres primeros vacíos: en cada llamada se usan los del agente que la atiende.
Resultado
La salida Tools se conecta al conector Tools del Voice Agent. Las herramientas y su descripción las da Nexus en cada llamada.
Ejemplo: la plantilla de los agentes de voz
- Crea un flujo con un Voice Agent, su modelo, su STT y su TTS.
- Añade Nexus Agent Tools y conecta Tools al conector Tools del Voice Agent. Si quieres que el agente pueda colgar, añade también Voice Hangup.
- Si quieres que los agentes puedan pasar la llamada a su dueño, añade también un Transfer Call conectado a Tools. Ver Pasar la llamada al dueño.
- Guarda el flujo y da su id a quien administra Nexus (variable
NAPPAI_VOICE_TEMPLATE_FLOW_ID), junto con una API key de tu cuenta. - Desde ese momento, los agentes de voz que se crean en Nexus contestan con esta plantilla. Si no tenía ninguna versión desplegada, se despliega sola con el primer agente.
Pasar la llamada al dueño
Si en Nexus el dueño de un agente pide que el agente le pase las llamadas, Nexus manda su teléfono a NappAI. En las llamadas de ese agente, el Transfer Call de la plantilla pasa la llamada a ese número y se llama «Pasar la llamada a» seguido del nombre del dueño. El número es fijo: el modelo no puede cambiarlo ni pasar la llamada a otro.
En los agentes que no lo piden, el Transfer Call desaparece de sus llamadas. Si la plantilla no tiene Transfer Call, los agentes se publican igual, sin transferencia, y Nexus avisa a su dueño de que falta.
Buenas prácticas
- Cambia en la plantilla lo que sea común a todos los agentes y despliégala: los agentes contestan con la versión desplegada, así que el cambio les llega en la siguiente llamada.
- No pongas en la plantilla nada propio de un agente: el nombre, el prompt y el saludo los pone Nexus en cada llamada.
- Todas las llamadas de los agentes de Nexus quedan en el historial de la plantilla. Nexus importa a su bandeja las de cada agente, con la transcripción y el coste.
Seguridad y limitaciones
- La clave del canal da acceso a las herramientas de ese agente, con los permisos de su dueño. Nexus la rota en cada publicación y deja de aceptar la anterior.
- Si un agente se pausa en Nexus, solo se apaga ese agente: los demás siguen contestando. Si se borra, sus herramientas dejan de responder.
Componentes relacionados
- Nexus MCP: las herramientas de Nexus de una persona, para un agente de chat.
- Voice Agent: el agente que atiende las llamadas.