docs: 更新 AgentRun 分页快照验收
This commit is contained in:
@@ -32,22 +32,25 @@ bun scripts/cli.ts agentrun create task \
|
||||
--prompt-stdin
|
||||
```
|
||||
|
||||
HWLAB Agent Observer 全量投影验收使用目标 node/lane HWLAB workspace 内的 typed CLI:
|
||||
HWLAB Agent Observer 分页快照验收使用目标 node/lane HWLAB workspace 内的 typed CLI:
|
||||
|
||||
```bash
|
||||
export HWLAB_RUNTIME_WEB_URL=<selected-public-origin>
|
||||
export HWLAB_RUNTIME_ENDPOINT_LOCKED=1
|
||||
bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --limit 100 --timeout-ms 45000
|
||||
bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --page 1 --page-size 25 --timeout-ms 30000
|
||||
bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --page 2 --page-size 25 --search <中文任务标题>
|
||||
```
|
||||
|
||||
- `HWLAB_API_KEY` 必须从选中 node/lane 的受控 sourceRef 加载;
|
||||
- 成功输出必须同时满足:
|
||||
- `phase=live`;
|
||||
- replay authority 为 `hwlab.event.v1`;
|
||||
- `runCount > 0`;
|
||||
- 验收 Artificer 时至少一个 `sessionId` 使用 `sess_artificer_` 前缀;
|
||||
- 该入口会在 retention-to-live handoff 后自动结束;
|
||||
- 禁止用无限 SSE 的 `client request GET /v1/agent-observer/events` 代替有界查询。
|
||||
- 列表 authority 固定为 `agentrun-manager-durable-store`:
|
||||
- `page`、`pageSize`、`total`、`totalPages` 和 `hasNextPage` 必须可见;
|
||||
- `items` 直接来自 AgentRun durable run、最新 command 和最新 runner job;
|
||||
- `taskId`、中文标题、workspace、lane、Agent/Profile、attempt、runner 和错误字段不得依赖 Kafka 历史 envelope 猜测;
|
||||
- Web 首屏先读取同一分页快照,再连接 `hwlab.event.v1` live 流;
|
||||
- Kafka retention replay 只用于显式事件历史下钻,不得阻塞列表首屏;
|
||||
- 验收 Artificer 时使用中文标题搜索,并确认对应 `sessionId` 使用 `sess_artificer_` 前缀;
|
||||
- `--limit` 只保留为旧 `--page-size` 别名,不再表示 Kafka replay 扫描上限;
|
||||
- 禁止用无限 SSE 的 `client request GET /v1/agent-observer/events` 代替有界分页查询。
|
||||
|
||||
资源命令的 Target 规则:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user