功能定位
自由转交是基于模型驱动的任务转交方式，其基础功能可覆盖大部分任务场景。创建 Multi-Agent 模式应用时，协同方式默认选择为自由转交，并默认创建一个主 Agent。
自由转交的主要优势在于配置简单，设置转交关系即可让模型自主判断何时转交，模型自由度极高；主要缺陷在于高自由度导致的不稳定，对 Agent 提示词配置要求较高。
在自由转交协同方式下，支持创建一个 Agent 或者多个 Agent，多 Agent 通过转交协同共同完成任务。
设置方式
第一步：配置 Agent
1. 配置名称
切换为 Multi-Agent 模式应用后，系统默认创建一个主 Agent。主 Agent 的名称与应用名称保持一致，用户可通过点击编辑图标修改和编辑 Agent 名称。
注意：
如果仅配置单个 Agent，可使用无明确含义的名称。在多 Agent 协同场景中，Agent 名称和描述都是判断转交时的关键信息，需要通过简洁、含义明确的名称来描述 Agent 功能。例如：旅行规划助手、网页分析 Agent、文案优化 Agent 等。
2. 配置模型
3. 配置转交描述
Agent 描述用于简要说明该 Agent 的功能和应用场景，帮助其他 Agent 判断何时将任务转交至该 Agent。
注意：
如果仅配置单个 Agent 的使用场景，可以简单填写转交描述。但在多 Agent 协作场景中，清晰的描述对于确保正确转交至关重要。
支持点击 AI一键生成 自动生成转交描述。此操作将消耗 Agent 模型的 token。
4. 配置提示词
支持在提示词中补充当前 Agent 的任务目标、任务流程和限制说明。
可以参考模板根据实际需求填写，或使用 AI 一键优化 功能快速补充相关提示词，完善内容。
5. 配置插件
工具是一个 API，通过调用这个 API 完成某一项需求。插件是工具的集合，一个插件里面包含了若干个工具（相当于是工具组）。Agent 中实际上选择的是插件里面包含的工具。模型调用工具，是通过把工具的名称和描述信息注册在大模型的系统提示词中，让模型了解哪些工具可用以及具体的使用场景。当用户输入问题时，大模型根据对于问题的理解和拆分，和工具的描述说明，选择一个或多个合适的工具来解决问题。
因此，对于 Agent，需要选择好需要的工具，并且提供容易理解的工具描述说明（在自定义插件时需要注意），对于工具的成功调用至关重要。
工具支持进行参数配置。在添加插件后，点击工具设置。
在工具设置的输入参数中，支持输入或引用参数默认值，同时支持切换单个参数模型是否可见。如果设置为可见，则由模型在对话中收集该参数；如果设置为不可见，则按照传入或输入的参数调用该工具。
除了支持输入参数值，也可以通过引用 API 参数值的方式，通过接口动态传入参数。
在高级配置中，支持配置 API 参数。单击新建配置 API 参数的参数名称、参数描述以及参数类型。配置好的参数可以在工具参数中被引用。
您在调用腾讯云智能体开发平台 API 时，通过 custom_variables 字段（该参数的使用详情请参见 对话端接口文档（HTTP SSE）、对话端接口文档（WebSocket））传入变量，在工具参数中引用该变量执行后续业务逻辑。
说明：
例如，在“权限查询”Agent中，您可以在调用腾讯云智能体开发平台 API 时，将 userID（假设该字段表示员工ID）放入 custom_variables 字段中通过自定义插件传入 Agent，以实现不同 userID 对应的权限范围不同。在高级设置的 API 参数中配置 userID 字段，该字段名称和数据类型与您在接口中传入的保持一致。在插件配置时，您可以直接引用该变量。在 Agent 运行时，系统会自动解析并使用 custom_variables 中的 userID 字段，调用对应插件。
调试对话框右上角的调试参数支持在调试过程中直接设置自定义 API 参数的具体值，便于进行 Agent 功能调试。
在调试过程中，需在插件的工具设置中，将对应的参数默认值修改为引用，选择自定义的 API 参数，并设置模型不可见。
6. Agent 高级设置（按需选择）
调试 Agent 效果时，可配置高级设置，根据业务场景调整参数以优化Agent表现。在 Agent 卡片右上角的"..."菜单中可找到高级设置入口。
点击出现高级设置弹窗。
具体配置建议如下：
高级设置 | 配置建议 |
澄清询问 | 澄清询问用于控制 Agent 是否主动与用户沟通以收集缺失信息，默认开启。 开启：Agent 会在缺乏必要信息时，自动向用户提问以补充必要信息，适合需要多轮交互的复杂任务。 关闭：Agent 将不与用户交互，直接使用已有信息执行任务，适合单流程、自动化任务场景。 |
思考模式 | 思考模式用于配置Agent的思考过程，支持在效果优先或速度优先之间进行选择。 效果优先模式下，Agent会先进行充分思考再调用工具，表现更稳健，适合绝大多数场景； 速度优先模式下，Agent会跳过思考过程直接调用工具，节省token消耗和时间消耗，但效果会有所下降，适合处理简单任务。 注意： 如果选择类似 DeepSeek-R1 的推理模型（Reasoning Model），则不支持速度优先模式。 |
最大推理轮数 | 最大推理轮数用于控制 Agent 在执行任务时 「思考 + 工具调用」循环的最大次数，可根据业务场景中大多数任务调用工具的次数进行设置。 数值越大：表示 Agent 的“思考深度”更高，更适合复杂任务，但会增加 token 消耗与执行时间。 数值越小：可提升执行效率，更适合简单任务或对时延敏感的场景。 |
上下文轮数 | 用于设置输入给大模型的上下文轮数，从而控制 Agent 的对话记忆长度。默认5轮。 数值较大：保留更多历史对话，便于处理多轮复杂任务，但会增加 token 消耗。 数值较小：只保留最近的对话，提升执行效率，更适合短任务或对时延敏感的场景。 |
结构化输出 | Agent支持配置 JSON Schema，输出结果按照指定格式输出，降低上层系统集成对接复杂度。同时，在工作流场景中的 Agent 节点的输出支持标准化，更方便后续节点引用。 |
同义词设置
支持配置同义词，以满足业务问答表达和知识库不一致，或者业务问答多样的场景。对于 query 中的同义词，在调用知识库问答插件检索前将统一替换为知识库中知识的统一名称，提高检索的准确率。
第二步：添加 Agent
在应用中支持添加多个 Agent，通过多 Agent 响应对话。如果仅需要单 Agent 场景，无需额外添加 Agent。
可添加的 Agent 范围包括其他“Multi-Agent模式”应用中的所有 Agent。
单击添加后，支持编辑 Agent 再添加至应用。
第三步：转交关系配置
在应用中添加两个或以上的 Agent 时，系统支持配置多个 Agent 之间的转交关系。请注意，默认创建多个 Agent 后，这些 Agent 不会立即生效，必须与主 Agent 配置转交关系后，主 Agent 才能根据“Agent 描述”准确地将对话分配到特定的子 Agent。若子 Agent 未通过转交关系（可为单层或多层）与主 Agent 建立关联，则该 Agent 视为游离状态，无法被激活使用。
建议配置为主 Agent 转交任务给多个子 Agent，同时每个子 Agent 也转交回主 Agent 的中心化架构。
