> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Handoffs

**Not sure where to begin?** Explore our [Getting started](/docs/welcome/getting-started) guidelines to set up your first AI Agent, review [Key concepts](/docs/welcome/key-concepts) to understand the essentials, or check out [Improvement tactics](/docs/welcome/improvement-tactics) to resolve issues and keep things running smoothly.

Your AI Agent learns from [Knowledge](/docs/knowledge) and can also use features like [Actions](/docs/automation/tools/api-tools), [Processes](/docs/automation/processes), [Coaching](/docs/optimization/coaching), and more to automate and refine its responses. You can also define the AI Agent’s [personality](/docs/setup/persona).

After setting up these core components, you can configure your AI Agent's handoffs. Each Handoff defines how your AI Agent escalates customer conversations to human agents or support systems. It ensures a smooth transition by passing along relevant context.

This section covers how to manage handoffs in your AI Agent. You’ll learn about different [handoff scenarios](/docs/handoffs/handoff-management#situations), [how variables work within handoffs](/docs/handoffs/handoff-management#variables), and [how to edit them as needed](/docs/handoffs/handoff-management#edit). Additionally, you’ll see [how to view and manage handoff versions](/docs/handoffs/handoff-management#versions) to keep conversations running smoothly when transferring to human agents or external systems.

![Handoffs](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/ada.docs.buildwithfern.com/81372fbd93f3a99ee7d68aec10807be2b3bcde0d4f774bffbcef6f513497a258/versions/assets/images/handoffs.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260921T040004Z&X-Amz-Expires=604800&X-Amz-Signature=4e627fc6ffbc7494c13b44c412f8642bbdedf2a7834e7de3ede6b15f3a3df2d1&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

---

Have any questions? Contact your Ada team, or email us at [](mailto:help@ada.cx?subject=Help%20Docs%20inquiry).