Agent-to-agent handoff - Vobiz

Transfer an active call from one LiveKit AI agent to another specialized agent mid-conversation - without dropping the call.

View on GitHub

Clone and run the full working example

Getting started

git clone https://github.com/vobiz-ai/Vobiz-Livekit-Agent-to-Agent-Handoff-Example.git
cd Vobiz-Livekit-Agent-to-Agent-Handoff-Example
pip install -r requirements.txt
python agent.py dev

Overview

A front-line agent handles the initial greeting and intent detection. When the caller needs specialized help (billing, support, etc.), the front-line agent passes control to a specialist agent. The handoff is seamless - the caller stays in the same room and hears no interruption.

How it works

The reception agent greets the caller and determines their intent.
Based on intent, the agent calls pass_control_to_billing or a similar tool.
The reception agent leaves the room.
The specialist agent joins the same room and takes over the conversation.
The specialist receives context from the handoff payload.

Agent function tools

Tool	Description
`pass_control_to_billing`	Hand off to the Billing department specialist
`pass_control_to_support`	Hand off to the Technical Support specialist
`pass_control_to_sales`	Hand off to the Sales specialist

Environment variables

.env

LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=APIxxxxxxxxxxxxx
LIVEKIT_API_SECRET=secretxxxxxxxxxx
OPENAI_API_KEY=sk-...