Skip to content

使用平台工具包

“平台工具包”是智能体开发服务平台(AgentWorks)内置工具的选择入口,不是沙箱工具列表。选择平台工具包后,AgentWorks 负责执行对应操作;不需要另外部署 MCP Server,也不需要由调用方执行工具并返回结果。

根据任务选择工具包

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

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

平台工具包与沙箱是两项独立配置。添加平台工具包不会创建或关联沙箱;需要运行命令、处理文件或执行代码时,使用沙箱模板和实例

如果工具运行在外部 MCP Server 中,使用 MCP 实例或模板;如果工具由接入 Invoke API 或 WebSocket 的业务应用执行,使用用户工具包

选择工具包 中显示的是整个工具包的名称,不一定等于其中某个工具的可调用名称。需要排查调用或在智能体级 工具权限 中编写规则时,请从测试调用的 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. 要求智能体删除测试任务,再次查询并确认任务不再存在。

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

在渠道账号中查看和维护定时任务

渠道用户通过配置了 infini_cron 的智能体创建和查询定时任务;运营人员可以在 AgentWorks 管理控制台中查看已有任务、检查运行记录,并按需暂停、恢复或删除任务。AgentWorks 管理控制台中的 定时任务 不提供新建任务表单。

以下入口仅在租户已启用 AgentWorks 平台工具包能力时可用。

  1. 打开 渠道账号,进入一个飞书或 QQ 渠道账号的详情。

    按钮会在新标签页打开控制台。若先进入登录页,控制台目前不会在登录后自动返回目标页面;请登录后返回本文,再次选择按钮。

  2. 进入 定时任务

  3. 根据任务名称、Cron 表达式和状态找到目标任务。

    注意

    先确认目标定时任务

    列表可能同时显示同一租户内由其他渠道账号创建的定时任务。不要仅根据当前打开的渠道账号判断任务归属。执行暂停、恢复或删除前,请使用容易区分的任务名称,并核对 Cron 表达式和预期用途;无法确认时停止操作。

  4. 触发结果与预期不一致时,选择 运行记录,先核对实际执行时间和结果,再决定是否调整任务。

  5. 需要暂时停止后续调度时,选择 暂停并确认状态已经更新。准备继续运行时,选择 恢复,再核对状态和下一次实际触发结果。

  6. 确认任务不再需要,并保存仍需用于排查的任务配置和运行信息。

    危险

    删除定时任务不可撤销

    删除会移除定时任务定义。只是暂时阻止后续调度时,请使用 暂停

    确认完成后,选择 删除

需要从其他渠道管理任务、会话或用户绑定时,参见创建账号后继续管理消息、用户和任务

排查平台工具包

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