自由转交

最近更新时间:2025-08-18 12:17:41

我的收藏

功能定位

自由转交是基于模型驱动的任务转交方式,其基础功能可覆盖大部分任务场景。创建 Multi-Agent 模式应用时,协同方式默认选择为自由转交,并默认创建一个主 Agent。



自由转交的主要优势在于配置简单,设置转交关系即可让模型自主判断何时转交,模型自由度极高;主要缺陷在于高自由度导致的不稳定,对 Agent 提示词配置要求较高。
在自由转交协同方式下,支持创建一个 Agent 或者多个 Agent,多 Agent 通过转交协同共同完成任务。

Agent 配置

1. 名称
切换为 Multi-Agent 模式应用后,系统默认创建一个主 Agent。主 Agent 的名称与应用名称保持一致,用户可通过点击编辑图标修改和编辑 Agent 名称。
注意:
如果仅配置单个 Agent,可使用无明确含义的名称。但在多 Agent 协作场景中,使用具有明确语义的名称对于确保正确交接至关重要,请避免使用诸如“智能应用01”或“agent123”等无意义的名称。



修改后,单击确定保存名称。



在多 Agent 协同场景中,Agent 名称和描述都是判断转交时的关键信息,需要通过简洁、含义明确的名称来描述 Agent 功能,例如:旅行规划助手、网页分析Agent、文案优化 Agent 等。
2. 模型
Agent 中的模型用于任务规划和工具选择,支持按需选择模型。



调低:减少 token 消耗与推理时间,适合简单任务。
调高:支持更复杂的工具调用场景,但会增加 token



最大推理轮数表示模型「思考+工具调用」的最大次数,建议根据任务复杂度合理设置,以平衡性能与资源消耗。
调低:减少 token 消耗与推理时间,适合简单任务。
调高:支持更复杂的工具调用场景,但会增加 token 消耗。
3. 转交描述
Agent 描述用于简要说明该 Agent 的功能和应用场景,帮助其他 Agent 判断何时将任务转交至该 Agent。
注意:
如果仅配置单个 Agent 的使用场景,可以简单填写转交描述。但在多 Agent 协作场景中,清晰的描述对于确保正确转交至关重要。



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 参数,并设置模型不可见

添加 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 的中心化架构。