Skip to content

使用平台工具包

平台工具包提供由一体化智能体运行与协同平台(AgentWorks)实现的现成工具能力。选择平台工具包后,不需要另外部署 MCP Server,也不需要由调用方处理中断来执行工具。

根据任务选择工具包

选择工具包 中显示当前租户可以使用的平台工具包。可选项取决于平台版本和租户能力配置,应以控制台中的列表为准。

工具包适用任务使用前提
channel_media在当前聊天渠道发送图片、视频、音频或文件智能体已配置并接入支持相应媒体类型的聊天渠道;媒体 URL 可由平台访问
infini_cron创建、查询或删除定时任务,并在触发时把预设输入交给智能体渠道用户已经获得可用的智能体实例;模板绑定用户先发送 /init

平台工具包适用于平台已经提供并执行对应工具的任务。如果工具运行在外部 MCP Server 中,使用 MCP 模板和实例;如果工具由接入 Invoke API 的业务应用执行,使用用户工具包

选择工具包 中的名称表示整个工具包,不一定等于其中某个工具的可调用名称。只有目标工具调用进入确认型审批时,模板审批处理规则才参与。先通过该工具包的使用说明和测试调用确认审批方式;需要填写规则时,从 Trace 中核对实际工具名称和顶层参数。参见找到工具名称和参数名

将平台工具包添加到智能体模板

  1. 创建或编辑智能体模板。
  2. 打开 插件配置
  3. 单击 添加插件
  4. 类型 中选择 平台工具包
  5. 选择工具包 中选择所需工具包。
  6. 保存智能体模板。
  7. 在智能体模板详情页打开 插件,确认平台工具包已经关联。
  8. 创建或更新用于测试的智能体实例,再通过已绑定渠道验证工具。

平台工具包直接关联到智能体模板,不需要选择能力模板或能力实例。

验证媒体发送

channel_media 准备一个测试文件 URL,然后通过已绑定渠道发送一条明确要求智能体发送该文件的消息。验证:

  1. 渠道收到实际媒体消息,而不只是包含 URL 的文本回复。
  2. 图片、视频、音频和文件分别只使用渠道支持的格式。
  3. 无法访问或已过期的 URL 不会被当作发送成功。

如果智能体实例只返回文本,检查智能体模板是否保存了 channel_media、测试实例是否已经更新、智能体实例是否接入了当前渠道,以及提示词是否明确要求发送媒体。

验证定时任务

infini_cron 使用五字段 cron 表达式,字段顺序为“分、时、日、月、周”。例如,0 8 * * * 表示每天 08:00。

通过已绑定渠道完成以下闭环测试:

  1. 模板绑定用户先发送 /init,确认已创建专属智能体实例。
  2. 要求智能体创建一个名称明确、触发时间容易核对的测试任务。
  3. 要求智能体列出定时任务,确认名称、表达式和任务输入。
  4. 等待一次触发,确认智能体在同一渠道收到预设输入并返回结果。
  5. 要求智能体删除测试任务,再次查询并确认任务不再存在。

生产任务上线前,应先确认平台运行时采用的时区,并用短周期测试核对实际触发时间。

排查平台工具包

  • 看不到目标工具包:确认租户是否开放该能力,并以 选择工具包 中的可见选项为准。
  • 插件列表中没有工具包:重新保存智能体模板,并在 插件 中核对关联。
  • 测试实例没有新能力:编辑并保存智能体实例,使其使用最新智能体模板配置后再测试。
  • channel_media 发送失败:检查媒体 URL、格式、渠道配置和渠道自身的媒体限制。
  • infini_cron 提示实例未初始化:模板绑定用户先发送 /init,再重新创建任务。
  • 定时任务没有按预期触发:检查五字段表达式、时区和任务是否仍存在。