Skip to main content

Documentation Index

Fetch the complete documentation index at: https://documentation.uponai.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Agent Transfer lets you hand off a call from one AI agent to another mid-conversation — instantly, over a single phone number, with full conversation context preserved.

​
Why Agent Transfer vs. Transfer Call

Agent TransferTransfer Call
SpeedNear-instantRequires new phone connection
ReliabilityNo telephony failuresDependent on carrier
ContextFull chat history carried overNo context passed
Phone numbersOne number for all agentsMay require multiple numbers

​
Setup

1

Add the tool

In your agent’s Functions section, select Agent Transfer from the dropdown.
2

Configure the destination

Specify the destination agent ID and version. Choose whether the current agent should announce the transfer to the caller before handing off.
3

Update your prompt

Tell the agent when to trigger a transfer:
If the user asks to book an appointment, use the agent_transfer tool to hand off to the scheduling agent.
4

Test

Validate using the web call interface or playground.

​
Settings Behavior During Transfer

SettingBehavior
Opt-in/out preferencesPersist across the full call
Webhook URLsPersist across the full call
LanguageSwitches to match the receiving agent
Voice selectionSwitches to match the receiving agent
Voice modelSwitches to match the receiving agent