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