在 Forward Session 中使用自然语言创建、查询和删除 Schedule。
除了调用 Schedule API,终端用户也可以在 Web 或 IM Channel 会话中描述任务内容和执行时间,由 Agent 创建 Schedule。创建后,任务会按约定时间自动运行,无需保持当前会话在线。
当前会话使用的 Template 必须启用对应的 Schedule 托管工具:
Template 默认不启用这些工具。
创建 Template 时,将
为已有 Template 启用或调整托管工具时,只需更新该字段:
更新时,
在会话中说明以下信息:
对于监控类任务,请同时说明检查频率、业务日期、年份、开始时间、结束时间和触发条件;缺少这些关键信息时,Agent 会先尝试向你确认。
Schedule 创建成功后,Agent 会在当前会话中返回创建结果。你可以继续询问 Agent 查看该 Schedule,确认任务名称、执行规则和时区是否符合预期。
可以查询当前用户可见的 Schedule,也可以通过名称、任务内容或状态缩小范围。
可以通过 Schedule ID 精确删除,也可以通过任务名称或内容描述。
如果描述匹配多个 Schedule,系统不会执行删除,而会返回候选项供你指定具体的 Schedule ID。自然语言“删除”实际会归档 Schedule:任务不再运行,历史 Schedule Run 仍可查询。
使用前提
当前会话使用的 Template 必须启用对应的 Schedule 托管工具:
| 能力 | 托管工具 |
|---|---|
| 创建 Schedule | create_forward_schedule |
| 查询 Schedule | list_forward_schedules |
| 删除 Schedule | delete_forward_schedule |
managed_tool_config 是 Template 请求体的顶层字段,可通过以下接口配置:
| 场景 | 接口 |
|---|---|
| 创建 Template 时启用 | POST /api/v1/forward/templates |
| 为已有 Template 启用或调整 | POST /api/v1/forward/templates/{template_id} |
managed_tool_config 与 name、model、environment_id 等字段放在同一层:
enabled_tools 会整体替换当前已启用的 Schedule 托管工具集合。详细参数见 创建 Template 和 更新 Template。
如果 Agent 无法执行 Schedule 管理操作,可以询问“你当前有哪些工具?”,确认其回答中是否包含上述 Schedule 托管工具。
创建 Schedule
在会话中说明以下信息:
- 什么时候执行:例如“每天上午 9 点”、“每周一 10 点”或“2 小时后”。
- 执行什么任务:说明要处理的对象和目标。
- 输出要求:例如条目数、格式、筛选条件或是否需要附带来源。
- 时区:涉及跨时区协作时,建议明确说出时区,例如“北京时间”或“美国太平洋时间”。未指定时区时,默认按
Asia/Shanghai解释。
周期执行
单次执行
固定间隔检查
查询 Schedule
可以查询当前用户可见的 Schedule,也可以通过名称、任务内容或状态缩小范围。
删除 Schedule
可以通过 Schedule ID 精确删除,也可以通过任务名称或内容描述。
查看执行结果
- 在普通 Web 会话中创建的 Schedule,执行结果会回到创建任务的原会话。即使执行时会话不在线,下次打开该会话时仍可接收尚未展示的结果。
- 在 IM Channel 会话中创建的 Schedule,执行结果会投递到对应的 Channel 会话。
- 也可以通过 列出 Schedule Runs 和 获取 Schedule Run API 查看执行记录、状态与错误信息。
使用限制
cron和interval类型的触发粒度或执行间隔不得小于 1 分钟。once类型的相对延迟任务不受该频率下限限制,但延迟时长必须大于 0。- Schedule 运行期间不能再创建、查询或删除其他 Schedule,以避免定时任务自我复制或循环管理。