Skip to content

Nexus Agent Tools

Nexus Agent Tools gives a Voice Agent the tools of one Nexus agent. It is the piece behind Nexus voice agents: the agent is created in Nexus (what it does and which tools it may use) and NappAI gives it a voice, in the browser or by phone.

Every time the voice agent uses a tool, the call goes to Nexus and runs there, exactly as for any Nexus agent: with the tools its owner chose, with that owner’s permissions and with its autonomy. An action it may not do on its own waits in the owner’s For you, and the agent says so on the call.

When to use it

Usually you do not build it yourself: it is used by the template of the Nexus voice agents, a flow in your account with a Voice Agent and this component on its tools. When someone creates a voice agent in Nexus (My Copilots › Voice agents), Nexus registers it on that template with its name, prompt, greeting and channel key.

All the Nexus voice agents of your account share that single flow. Each call knows which agent it belongs to and uses that agent’s settings. So the agents do not use up one flow of your plan each, and what you change in the template reaches all of them.

What you do set up in NappAI is the template: the model, the speech-to-text, the voice and the rest of the call behaviour of every agent.

Configuration

FieldWhat it does
Nexus URL (required)The Nexus address as NappAI reaches it, e.g. https://nexus.your-company.com. /api/v1/agent-mcp is appended.
Voice channel key (required)The key of the agent’s voice channel. Nexus sets it and rotates it on every publish; it only opens that agent’s tools.
Nexus agent (advanced)The Nexus agent key. Nexus checks it matches the channel’s.
Only these tools (advanced)Optional. Narrows the tools further, comma-separated.

In the template leave the first three empty: each call uses those of the agent that answers it.

Output

Connect the Tools output to the Voice Agent’s Tools connector. Nexus provides the tools and their descriptions on every call.

Example: the voice agent template

  1. Create a flow with a Voice Agent, its model, its STT and its TTS.
  2. Add Nexus Agent Tools and connect Tools to the Voice Agent’s Tools connector. If the agent should be able to hang up, add Voice Hangup too.
  3. If the agents should be able to pass the call to their owner, also add a Transfer Call connected to Tools. See Passing the call to the owner.
  4. Save the flow and give its id to your Nexus administrator (NAPPAI_VOICE_TEMPLATE_FLOW_ID), together with an API key of your account.
  5. From then on the voice agents created in Nexus answer with this template. If it had no deployed version, it is deployed automatically with the first agent.

Passing the call to the owner

If the owner of an agent asks in Nexus for the agent to pass calls to them, Nexus sends their phone number to NappAI. On that agent’s calls, the template’s Transfer Call passes the call to that number and is named «Pasar la llamada a» followed by the owner’s name. The number is fixed: the model cannot change it or pass the call to anyone else.

For agents that do not ask for it, the Transfer Call disappears from their calls. If the template has no Transfer Call, the agents are published anyway, without transfer, and Nexus tells their owner what is missing.

Good practices

  • Change in the template what is common to all the agents and deploy it: the agents answer with the deployed version, so the change reaches them on the next call.
  • Do not put anything specific to one agent in the template: Nexus sets the name, prompt and greeting on every call.
  • All the calls of the Nexus agents are in the template’s history. Nexus imports each agent’s calls into its inbox with transcript and cost.

Security and limitations

  • The channel key gives access to that agent’s tools, with its owner’s permissions. Nexus rotates it on every publish and stops accepting the previous one.
  • If an agent is paused in Nexus, only that agent is switched off: the others keep answering. If it is deleted, its tools stop answering.
  • Nexus MCP: a person’s Nexus tools, for a chat agent.
  • Voice Agent: the agent that answers the calls.