使用平台工具包
平台工具包提供由一体化智能体运行与协同平台(AgentWorks)实现的现成工具能力。选择平台工具包后,不需要另外部署 MCP Server,也不需要由调用方处理中断来执行工具。
根据任务选择工具包
选择工具包 中显示当前租户可以使用的平台工具包。可选项取决于平台版本和租户能力配置,应以控制台中的列表为准。
| 工具包 | 适用任务 | 使用前提 |
|---|---|---|
channel_media | 在当前聊天渠道发送图片、视频、音频或文件 | 智能体已配置并接入支持相应媒体类型的聊天渠道;媒体 URL 可由平台访问 |
infini_cron | 创建、查询或删除定时任务,并在触发时把预设输入交给智能体 | 渠道用户已经获得可用的智能体实例;模板绑定用户先发送 /init |
平台工具包适用于平台已经提供并执行对应工具的任务。如果工具运行在外部 MCP Server 中,使用 MCP 模板和实例;如果工具由接入 Invoke API 的业务应用执行,使用用户工具包。
选择工具包 中的名称表示整个工具包,不一定等于其中某个工具的可调用名称。只有目标工具调用进入确认型审批时,模板审批处理规则才参与。先通过该工具包的使用说明和测试调用确认审批方式;需要填写规则时,从 Trace 中核对实际工具名称和顶层参数。参见找到工具名称和参数名。
将平台工具包添加到智能体模板
- 创建或编辑智能体模板。
- 打开 插件配置。
- 单击 添加插件。
- 在 类型 中选择 平台工具包。
- 在 选择工具包 中选择所需工具包。
- 保存智能体模板。
- 在智能体模板详情页打开 插件,确认平台工具包已经关联。
- 创建或更新用于测试的智能体实例,再通过已绑定渠道验证工具。
平台工具包直接关联到智能体模板,不需要选择能力模板或能力实例。
验证媒体发送
为 channel_media 准备一个测试文件 URL,然后通过已绑定渠道发送一条明确要求智能体发送该文件的消息。验证:
- 渠道收到实际媒体消息,而不只是包含 URL 的文本回复。
- 图片、视频、音频和文件分别只使用渠道支持的格式。
- 无法访问或已过期的 URL 不会被当作发送成功。
如果智能体实例只返回文本,检查智能体模板是否保存了 channel_media、测试实例是否已经更新、智能体实例是否接入了当前渠道,以及提示词是否明确要求发送媒体。
验证定时任务
infini_cron 使用五字段 cron 表达式,字段顺序为“分、时、日、月、周”。例如,0 8 * * * 表示每天 08:00。
通过已绑定渠道完成以下闭环测试:
- 模板绑定用户先发送
/init,确认已创建专属智能体实例。 - 要求智能体创建一个名称明确、触发时间容易核对的测试任务。
- 要求智能体列出定时任务,确认名称、表达式和任务输入。
- 等待一次触发,确认智能体在同一渠道收到预设输入并返回结果。
- 要求智能体删除测试任务,再次查询并确认任务不再存在。
生产任务上线前,应先确认平台运行时采用的时区,并用短周期测试核对实际触发时间。
排查平台工具包
- 看不到目标工具包:确认租户是否开放该能力,并以 选择工具包 中的可见选项为准。
- 插件列表中没有工具包:重新保存智能体模板,并在 插件 中核对关联。
- 测试实例没有新能力:编辑并保存智能体实例,使其使用最新智能体模板配置后再测试。
channel_media发送失败:检查媒体 URL、格式、渠道配置和渠道自身的媒体限制。infini_cron提示实例未初始化:模板绑定用户先发送/init,再重新创建任务。- 定时任务没有按预期触发:检查五字段表达式、时区和任务是否仍存在。