Skip to main content
Transition tools are simple tools whose only purpose is to transition to a new node.

Create a transition tool

Attach via JSON

Use a function with type: "transition" and set transition_to to the destination node.
{
  "function": {
    "name": "<transition_tool_name>",
    "description": "<description>",
    "type": "transition",
    "transition_to": "<TARGET_NODE_NAME>"
  }
}
For example:
{
  "function": {
    "name": "continue_to_verification",
    "description": "Use this tool after the prospect confirms their details to move to the appointment booking node",
    "type": "transition",
    "transition_to": "appointment_booking"
  }
}

Attach via UI

  1. Open your scenario and go to the target node.
  2. Click Add function.
  3. Select the Transition Tool tab in the pop up modal
  4. Create a transition function with a clear name and description.
  5. Drag the probe on the right side of the function to the node you wish to transition to
Add a transition function in the scenario UI (1.5x speed) Shown at 1.5x speed.

Make any tool a transition tool

Any tool can also be configured to transition after it is called, including HTTP endpoints, RAG tools, and vision tools. To do this in JSON, set transition_to on that tool function object.
{
  "function": {
    "name": "lookup_policy_and_continue",
    "description": "Search policy details, then move to verification.",
    "type": "rag",
    "corpus_id": "<KNOWLEDGE_BASE_ID>",
    "transition_to": "verification"
  }
}
In the UI, drag the function to the node you want to transition to after that tool is called. Drag a tool to set transition target in the scenario UI (1.5x speed) Shown at 1.5x speed.