tencent cloud

Tencent Cloud Agent Development Platform

Release Notes and Announcements
Release Notes
Product Announcement
Product Introduction
Product Overview
Advantages
Use Cases
Model Introduction
Purchase Guide
Package Subscription
Previous Version
Getting Started
Agent Application and Its Three Modes
Creating a "Content Summary Assistant" in Standard Mode
Creating a “Webpage Scraping Assistant” in Single Workflow Mode
Creating a “Stand-up Comedy Content Creation Assistant” in Multi-Agent Mode
Operation Guide
Application Development
Workflow
Multi-Agent
Knowledge Base
Widget
Plugin Marketplace
Model List 
Prompt Templates
Application Templates
Platform Management
Business, Workspace and Permissions
API Documentation
History
API Category
Making API Requests
Atomic Capability APIs
Operation Optimization APIs
Document Library APIs
Q&A Database APIs
Knowledge Tag APIs
Application Management APIs
Enterprise Management APIs
Billing APIs
Release Management APIs
Dialogue Endpoint APIs
Data Statistics APIs
Data Types
Error Codes
Application API Documentation
Dialogue API Overview
Dialog API Documentation (WebSocket)
Dialog API Documentation (HTTP SSE)
Image Chat or File Chat (Real-time Document Parsing + Chat)
Offline Document Upload
Tencent Cloud Agent Development Platform Operation COS Guide
ADP Document Parsing Protocol
FAQs
Product FAQs
Technical FAQs
Related Agreements
Tencent Cloud Agent Development Platform Service Level Agreement
Tencent Cloud Agent Development Platform Service Specific Terms
Tencent Cloud Agent Development Platform Privacy Policy
Tencent Cloud Agent Development Platform Data Processing and Security Agreement
Open-Source License Statement
Lighthouse OpenClaw Connector Plugin Service Agreement
Contact Us
Glossary

Free Handoff

PDF
Focus Mode
Font Size
Last updated: 2026-02-04 11:45:35

Function Positioning

Free Handoff is a model-driven task transfer method. Its basic feature can cover most task scenes. When creating a Multi-Agent Mode application, the collaboration method is selected by default as Free Handoff, and a primary Agent is created by default.
The main advantage of Free Handoff is its simple configuration. By setting the transfer relationship, the model can autonomously judge when to transfer, with extremely high freedom. The primary defect is the instability caused by high freedom, requiring relatively high configuration requirements for Agent prompt content.
In Free Handoff collaboration mode, it supports creating one Agent or more. Multiple agents complete tasks through transfer collaboration.

Setting Method

Step 1: Add and Configure Agents

The Agent collaboration method defaults to Free Handoff. You can create or add necessary Agents within the application according to business needs. If only a single Agent scenario is required, no need to add extra Agents. For configuration method, refer to Agent Creation, Configuration and Deletion.

Step 2: Configure Transfer Relationship

When two or more Agents are added in application, the system supports configuring transfer relationships between multiple Agents. Please note, by default, these Agents will not take effect immediately after creation. The Main Agent can accurately allocate dialogue to specific Sub-Agents based on "Agent description" only after establishing transfer relationships with them. If a Sub-Agent fails to establish an association with the Main Agent through transfer relationships (single-layer or multi-layer), it will be deemed as free status with the incapability of Activation Use.



The recommended configuration is a centralized architecture where the Main Agent transfers tasks to multiple Sub-Agents, and each Sub-Agent also transfers back to the Main Agent.

Advanced Settings

Transfer Relationship Settings- Advanced Settings supports configuring the starting Agent for each round of dialogue: after the task ends, the next round of dialogue can be received by the Agent that replied last time or the Main Agent.


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback