Skip to main content

定时部署

当工作流部署应自动运行(例如每日研究搜索或每周报告工作流)时,请使用定时任务。 定时任务在工作流部署详情页面中进行管理。打开一个部署,点击 Schedules,然后为某个部署变体创建或编辑定时任务。 每个工作区还有一个侧边栏中的 Schedules 页面,会列出该工作区的全部定时任务,包括 Copilot 在未保存工作流的情况下创建的一次性定时任务。 Dashboard Copilot 会在确认卡片上提出定时任务。Copilot 创建的重复定时任务先处于暂停状态:会先进行一次测试运行,然后你再点击 Enable schedule。Copilot 不会自动启用定时任务。

定时任务存储的内容

工作流定时任务会存储:
  • 要运行的部署变体
  • 定时任务名称
  • 活动或暂停状态
  • 重复设置
  • 时区
  • 用于签名完成投递的可选回调 URL
  • 已保存的 Start 输入值
定时任务运行的是已发布的部署变体,而不是可变的工作流草稿。每次定时任务触发时都使用已保存的输入值。 当 Start 输入配置为 Array 时,定时任务表单存储原生 JSON 数组。请以有效的 JSON 形式输入值,例如 ["one", "two"] 或 [{"url":"https://example.com"}]。

支持的重复方式

定时任务只使用结构化重复规则,不支持 cron 语法。
  • 每隔 N 天在本地时间运行
  • 每隔 N 周在所选工作日的本地时间运行
  • 每隔 N 个月在指定日历日运行(1–31 或该月最后一天)。较短的月份会钳位到最后一天(例如 31 日会变成 4 月 30 日或 2 月 28 日)。
  • 一次性,在本地日期和时间运行。该次运行后定时任务变为已完成,不会再触发。
Fetch Hive 会按定时任务时区计算下次运行时间。这样可以保持各账户的本地运行时间一致。

定时运行的行为

定时运行复用与普通工作流部署调用相同的执行路径。这意味着:
  • 部署版本快照保持不变
  • 工作流步骤设置(包括搜索语言设置)会被保留
  • 计费和托管 LLM 信用检查仍然适用
  • 个人凭据和已弃用模型检查仍然适用
  • 工作流并发限制仍然适用
  • 当定时任务完成或失败时,可选的回调投递会运行
  • 运行会出现在工作流日志中
定时运行包含将其标记为由定时任务触发的元数据,包括定时任务 ID、定时任务名称和定时时间。 在工作流日志中,它们归属到工作区的默认 API 密钥,并将已保存的定时任务输入包含在请求负载和追踪详情中。 如果定时执行因停机或 worker 恢复而延迟,Fetch Hive 只会运行最新一个已到期的触发点,而不会重放所有错过的触发点。

生命周期

定时任务也可以自行完成或暂停:
  • 到期时间 — 在该时间或之前的最后一次有效触发之后,定时任务完成。
  • 最大运行次数 — 达到该次数的计划触发后,定时任务完成。
  • 连续失败 — 连续三次启动失败会暂停定时任务。部署未激活或额度封顶会立即暂停。
已完成的定时任务无法恢复。如果还需要同样的自动化,请创建新的定时任务。

立即运行

使用 立即运行 会通过与真实触发相同的路径立刻执行定时任务。对活动或已暂停的定时任务都有效。它不会更改下次运行时间、运行次数或状态。该次运行仍会在工作流日志中显示为定时任务触发。 由 Copilot 创建的定时任务带有来源标签,便于区分是 Copilot 创建还是 Studio 对话框创建。

暂停、恢复与删除

当定时任务应停止启动新运行但不希望删除其配置时,请暂停该定时任务。 恢复时会从当前时间重新计算下次运行时间。 删除定时任务会将其归档,因此过去的定时运行历史仍可在内部进行审计。

注意事项

定时任务目前仅适用于已发布的工作流部署。此版本不包括草稿工作流的定时任务以及已保存输入的动态日期变量。