docs: streamline AgentRun canary verification

2026-07-19 20:10:54 +02:00
parent 3daa5d718e
commit 66d08a0b19
1 changed files with 8 additions and 0 deletions
@@ -70,6 +70,14 @@ Artificer 内部执行边界：

 `agentrun events` 是高频渐进披露入口：

+- 短只读 canary 使用固定三步闭环：
+  1. 用 `agentrun create task` 创建并自动派发。
+  2. 只调用一次 `agentrun events run/<runId> --after-seq 0 --expect <高于预期事件总数的值> --timeout <有界时长> --limit 20`。
+  3. 看到 `completionReason=run-terminal` 后，只调用一次 `agentrun result run/<runId> --command <commandId>` 获取权威终态和最终回复。
+- 短 canary 不按固定小批事件连续翻页：
+  - `expect` 只是等待上限条件；
+  - run 或 command 进入终态时，manager 必须提前返回；
+  - `items` 因默认分页未包含最终 assistant message 时，不继续翻页找正文，直接使用 `result`。
 - active run 的推荐观察入口是：
  - `bun scripts/cli.ts agentrun events run/<runId> --after-seq <cursor> --expect 10 --timeout 120s --limit 20`；
  - manager 在单个请求内等待 after-seq 后新增事件达到 `expect`，或目标 run/command 进入终态；