For the complete documentation index, see llms.txt. This page is also available as Markdown.

transfer call to live agent

The Transfer Call to Live Agent tool lets your AI agent hand a voice call over to a person on your team. You add it on the Prompt & Tools page, choose which actions the agent may use, and tell the agent when to use it. It works on voice calls.

Prerequisites

  • An AI agent. See Create your first AI Agent.

  • Voice bots turned on for your account. Without them the tool is not added and you see "Enable Voice Bots to use this tool".

  • Edit access to AI Agents. [CHECK: permissions are not part of the PRD. Confirm the role needed.]

Key definitions

Term
Meaning

Tool

Something your agent can use to take an action.

Action

One thing a tool can do. You turn each action on or off with Allowed.

Usage instructions

Your words that tell the agent when to use the tool and what to do.

What the Transfer Call to Live Agent tool can do

Action
What it does

Transfer call

Transfers the call to a live agent.

Steps

  1. Open Prompt & Tools under Setup in the AI Agent sidebar. Click Add tool. In the Add tools window, find Transfer Call to Live Agent. You can search for it, or look under Internal tools. Click it.

Find Transfer Call to Live Agent in the Add tools window
  1. Under "How should the agent use Transfer Call to Live Agent?", write when the agent should use the tool and what it should do. This is required.

Turn on actions and write the usage instructions for Transfer Call to Live Agent
  1. Click Add tool. The tool now shows under Connected tools with an Active label. Click Done to close the window, then click Update to save the page.

Example usage instructions

Transfer the call to a live agent when the caller asks for help with billing.

Write your own in the same way: say when to use the tool, then what to do.

Change or remove the tool

Under Connected tools, click the gear icon to open the tool's settings again. Click the delete icon to remove it. You are asked to confirm. Deleting removes the tool and its usage instructions from the agent.

Common errors

The agent does not use the tool

Check that the tool shows Active under Connected tools. Check that the action you need is allowed. Make your usage instructions clearer about when to use the tool.

I cannot save the tool

The usage instructions are required. Fill them in.

It says "Enable Voice Bots to use this tool"

Voice bots are not turned on for your account, so the tool is not added. Turn on voice bots, or ask your account owner.

What happens if I delete the tool?

The agent can no longer use it, and its usage instructions are removed. Text about the tool in your prompt stays, so remove it too.

[CHECK: the PRD lists the actions and inputs of this tool but not its screen text, limits or error messages. Confirm these with the dev team before publishing.]

[CHECK: existing customers have the old settings of this tool moved into the agent prompt, with the right action turned on. Confirm what customers should know about this move.]

Support

Still not working? Write to us at support@botpenguin.com. We will reach out to you within 24 hours.