限制、监控与恢复运行
配置并发、总 Agent 数、活动时长和近似额度,并理解暂停与取消的区别。
This page has not been translated into English yet. The original Chinese version is shown below.
先用小范围运行观察消耗,再为完整任务设置限制。工作流可以有多个 Agent;只控制并发数量,并不能限制整次运行的 Agent 总数或 AI credits。
四类限制
| 限制 | 个人设置键 | 达到限制后的行为 |
|---|---|---|
| 同时活动的工作流所属 Agents | workflows.defaultLimits.maxConcurrentSubagents | 额外 Agent 等待,不因此停止工作流 |
| 整次启动的工作流所属 Agents 总数 | workflows.defaultLimits.maxTotalSubagents | 可停止运行并保留状态和已保存结果 |
| 活动执行时长 | workflows.defaultLimits.timeoutSeconds | 暂停时间不计,暂停前活动时间仍计入 |
| 近似 AI credits 总量 | workflows.defaultLimits.maxAiCredits | 达到后停止新工作,进行中的消耗可能超出 |
AI credits 限制覆盖工作流 Agents 及其 subagents 的消耗。用量发生后才上报,所以它不是绝不超出的硬上限。前三项的 Agent 范围或活动时间口径,也不要直接替换成主会话的全部历史消耗。
每一类限制单独按“本次提示 → 工作流代码 → 个人默认值”的优先级取值。CLI 可用 /settings 配置个人默认值,时长单位为秒:
/settings workflows.defaultLimits.timeoutSeconds 3600官方没有在这两篇工作流说明中给出统一默认数值;不要把示例的一小时写成产品默认。
查看进度与停止
| 操作 | CLI 交互会话 | Copilot app 本地会话 |
|---|---|---|
| 打开列表 | /workflows | 提示框上方的 Workflows 按钮 |
| 查看详情 | 方向键选中,Enter | 点击具体运行 |
| 暂停 | 活动运行内按 P | Pause |
| 取消 | 活动运行内按 X | Cancel |
| 恢复 | 选中可恢复运行,按 R | Ready to resume 中选择,再点 Resume |
列表包含正在运行和近期结束的工作流;详情显示活动时长、工作流报告的阶段、活动/累计 subagents 和已用 AI credits。app 的运行监控目前只适用于本地会话;当前会话运行过工作流后才会显示对应按钮。
终端直接运行时,进度随命令输出;按 Ctrl+C 中断,未完成时可获得状态和 run ID,详见脚本执行。不要把中断命令、暂停和取消当作同一种恢复操作。
恢复检查点
只有列表中标为可恢复的暂停或达到限额的运行才能恢复。已完成步骤及 subagents 的保存结果可以复用,未保存的工作可能重做。已取消的运行不能恢复。
达到限制后恢复,需要提高该限制的整次运行总额;停止前用量仍计入新总额,恢复不是再获得一份相同额度。在 app 中使用 Resume with limit…;CLI 则按提示输入更高的总限制并确认。
定时与观测
当前 CLI 会话可用 /every 或 /after 安排包含工作流请求的提示,作用域和生命周期仍遵守会话内定时规则。
启用 OpenTelemetry 后,每次执行或恢复会创建 invoke_workflow span,并关联 Agent 活动;配置入口见 CLI OTel。查看 trace 不能代替检查最终结果和运行状态。