使用平台工具包
“平台工具包”是智能体开发服务平台(AgentWorks)内置工具的选择入口,不是沙箱工具列表。选择平台工具包后,AgentWorks 负责执行对应操作;不需要另外部署 MCP Server,也不需要由调用方执行工具并返回结果。
根据任务选择工具包
选择工具包 中显示当前租户可以使用的平台工具包。可选项取决于平台版本和租户能力配置,应以控制台中的列表为准。
| 工具包 | 可以完成的操作 | 是否需要 AgentWorks 沙箱 | 使用前提 |
|---|---|---|---|
channel_media | 在当前聊天渠道发送图片、视频、音频或文件 | 不需要 | 智能体已配置并接入支持相应媒体类型的聊天渠道;媒体 URL 可由平台访问 |
infini_cron | 创建、查询或删除定时任务,并在指定时间把预设输入交给智能体 | 不需要 | 渠道用户已经获得可用的智能体实例;模板绑定用户先发送 /init |
平台工具包与沙箱是两项独立配置。添加平台工具包不会创建或关联沙箱;需要运行命令、处理文件或执行代码时,使用沙箱模板和实例。
如果工具运行在外部 MCP Server 中,使用 MCP 实例或模板;如果工具由接入 Invoke API 或 WebSocket 的业务应用执行,使用用户工具包。
选择工具包 中显示的是整个工具包的名称,不一定等于其中某个工具的可调用名称。需要排查调用或在智能体级 工具权限 中编写规则时,请从测试调用的 Trace 中核对实际工具名称和顶层参数。除始终自动通过的内置工具外,其他工具调用按拒绝规则、允许规则和默认行为的顺序处理。参见找到工具名称和参数名。
将平台工具包添加到智能体模板
- 创建或编辑智能体模板。
- 打开 插件配置。
- 单击 添加插件。
- 在 类型 中选择 平台工具包。
- 在 选择工具包 中选择所需工具包。
- 保存智能体模板。
- 在智能体模板详情页打开 插件,确认平台工具包已经关联。
- 创建或更新用于测试的智能体实例,再通过已绑定渠道验证工具。
平台工具包直接关联到智能体模板,不需要选择能力模板或能力实例。
验证媒体发送
为 channel_media 准备一个测试文件 URL,然后通过已绑定渠道发送一条明确要求智能体发送该文件的消息。验证:
- 渠道收到实际媒体消息,而不只是包含 URL 的文本回复。
- 图片、视频、音频和文件分别只使用渠道支持的格式。
- 无法访问或已过期的 URL 不会被当作发送成功。
如果智能体实例只返回文本,检查智能体模板是否保存了 channel_media、测试实例是否已经更新、智能体实例是否接入了当前渠道,以及提示词是否明确要求发送媒体。
验证定时任务
infini_cron 使用五字段 cron 表达式,字段顺序为“分、时、日、月、周”。例如,0 8 * * * 表示每天 08:00。
通过已绑定渠道完成以下闭环测试:
- 模板绑定用户先发送
/init,确认已创建专属智能体实例。 - 要求智能体创建一个名称明确、触发时间容易核对的测试任务。
- 要求智能体列出定时任务,确认名称、表达式和任务输入。
- 等待一次触发,确认智能体在同一渠道收到预设输入并返回结果。
- 要求智能体删除测试任务,再次查询并确认任务不再存在。
生产任务上线前,应先确认平台运行时采用的时区,并用短周期测试核对实际触发时间。
在渠道账号中查看和维护定时任务
渠道用户通过配置了 infini_cron 的智能体创建和查询定时任务;运营人员可以在 AgentWorks 管理控制台中查看已有任务、检查运行记录,并按需暂停、恢复或删除任务。AgentWorks 管理控制台中的 定时任务 不提供新建任务表单。
以下入口仅在租户已启用 AgentWorks 平台工具包能力时可用。
打开 渠道账号,进入一个飞书或 QQ 渠道账号的详情。
按钮会在新标签页打开控制台。若先进入登录页,控制台目前不会在登录后自动返回目标页面;请登录后返回本文,再次选择按钮。
进入 定时任务。
根据任务名称、Cron 表达式和状态找到目标任务。
注意
先确认目标定时任务
列表可能同时显示同一租户内由其他渠道账号创建的定时任务。不要仅根据当前打开的渠道账号判断任务归属。执行暂停、恢复或删除前,请使用容易区分的任务名称,并核对 Cron 表达式和预期用途;无法确认时停止操作。
触发结果与预期不一致时,选择 运行记录,先核对实际执行时间和结果,再决定是否调整任务。
需要暂时停止后续调度时,选择 暂停并确认状态已经更新。准备继续运行时,选择 恢复,再核对状态和下一次实际触发结果。
确认任务不再需要,并保存仍需用于排查的任务配置和运行信息。
危险
删除定时任务不可撤销
删除会移除定时任务定义。只是暂时阻止后续调度时,请使用 暂停。
确认完成后,选择 删除。
需要从其他渠道管理任务、会话或用户绑定时,参见创建账号后继续管理消息、用户和任务。
排查平台工具包
- 看不到目标工具包:确认租户是否开放该能力,并以 选择工具包 中的可见选项为准。
- 插件列表中没有工具包:重新保存智能体模板,并在 插件 中核对关联。
- 测试实例没有新能力:编辑并保存智能体实例,使其使用最新智能体模板配置后再测试。
channel_media发送失败:检查媒体 URL、格式、渠道配置和渠道自身的媒体限制。infini_cron提示实例未初始化:模板绑定用户先发送/init,再重新创建任务。- 定时任务没有按预期触发:检查五字段表达式、时区和任务是否仍存在。