Skip to main content
The subagent node holds a conversation with the user while letting the agent call tools (also called functions) during the dialogue. The LLM decides whether and when to use each attached tool based on what the user says. If you only need dialogue without tool calling, use a conversation node. For example, a customer-support agent can use one subagent node to handle order questions: it chats with the caller, and only when the caller provides an order number does it invoke the order-lookup tool — no separate flow branch needed for callers who never ask.

​
How it works

When a subagent node has tools attached, the LLM receives both the node instruction and the list of available tools. During the conversation, the LLM determines when a tool should be called based on context, extracts the required parameters, and invokes it while maintaining the dialogue with the user.
  • Multiple tools can be added to a single subagent node.
  • The agent can continue talking while a tool executes.
  • Tool results are available to the LLM for generating follow-up responses.

​
Write the instruction

Subagent nodes only support Prompt instructions. Unlike a conversation node, Static Sentence is not supported. Write the instruction to define the task, what information the agent should gather, and when it should use the available tools.

​
Subagent node vs function node

Subagent nodes and function nodes serve different purposes: Use function nodes when you want guaranteed execution every time the flow reaches that step. Use subagent nodes when the agent should decide whether and when to call a tool based on what the user says.

​
Add tools

1

Select a subagent node

Click a subagent node to open its settings panel on the right side.
2

Add a tool

In the settings panel, find the Tools section and click + Add, then select the tool type from the dropdown.
3

Configure the tool

Configure the tool based on its type — see the table below for each type’s configuration guide.
4

Update the node instruction

Update the node prompt to guide the LLM on when to use the tool.

​
Available tool types

​
Execution speech settings

Each tool has settings that control what the agent says while it runs and after it completes.

​
Speak During Execution

When enabled, the agent says a message while the tool is executing, for example One moment, let me check that for you. This is recommended when the tool takes over 1 second, including network latency, so the agent remains responsive. You can configure how the message is generated:
  • Prompt: The LLM dynamically generates what to say based on a description you provide.
  • Static Sentence: The agent speaks the exact text you provide.

​
Speak After Execution

When enabled (the default), the agent calls the LLM after the tool returns a result so it can speak about the outcome to the user. Turn it off to run the tool silently.
  • Speak During Execution is available on: Custom Function, Code Tool, End Call, Transfer Call, Transfer Agent, Send SMS, and MCP Tool.
  • Speak After Execution is available on: Custom Function, Code Tool, and MCP Tool.

​
When transitions happen

  • After the user finishes speaking, following the evaluation order.
  • When Skip Response is enabled: as soon as the agent finishes speaking.
Tool execution happens within the subagent node, so the node can stay active across multiple turns and tool calls before it transitions.

​
Node settings

  • Tools: Attach the tools this subagent can use during the conversation.
  • Skip Response: The node gets a single edge and transitions through it when the agent finishes speaking, without waiting for a reply.
  • Knowledge Base: Attach node-level knowledge bases to combine topic-specific knowledge with the agent-level knowledge base. Read more at knowledge base.
  • Global Node: Make this node reachable from anywhere in the flow when its condition is met. Read more at global node.
  • LLM: Choose a different model for this node only. It’s used for response generation, tool selection, and tool argument generation.
  • Speech overrides: Override the agent-level speech settings for this node only — interruption sensitivity (0–1), responsiveness (0–1), voice speed (0.5–2), and whether keypad presses can interrupt the agent (DTMF interruption).
  • Fine-tuning examples: Add example transcripts to improve this node’s responses and transition decisions. Read more at finetune examples.

​
Best practices

  • Be explicit in your node instruction. Tell the agent when each tool should be used.
  • Use function nodes for guaranteed execution. If a tool must always run at a certain point in the flow, use a function node instead.
  • Avoid stacking too many tools on one subagent node. There’s no hard limit, but the more tools the LLM can choose from, the more likely it picks the wrong one. Split them across multiple subagent nodes.