feat(agentcli): 运行结果 incomplete 语义与契约文档

RunResult 增加 Outcome/Reason;触顶标记 incomplete:max_steps;
WebSocket finish 区分 incomplete 与 fatal error。补充 ai-agent docs 13 与挂点索引。
This commit is contained in:
Logan.Li committed 2026-10-19 03:53:09 +08:00
1 parent f3a4fb569f
commit 1c98c25c74
9 files changed
+249 -6

No files matched your search

@@ -142,3 +142,17 @@ OpenAI Agents 的 guardrail 思路也强调:输入、输出和工具调用都
| 输出 Guardrail | 防敏感信息泄露、错误修复建议、不可执行总结 |
| Trace ID | 把一次运行串起 LLM、工具、确认、审计 |
| Eval 数据集 | 固化典型主机/K8s 排障任务,回归测试 Agent 质量 |
---
## 理论 vs 运行时(2026-09-18 增补)// Logan.Li
| 层次 | 含义 | aiops 现状(摘要) | 目标 |
|------|------|-------------------|------|
| 工程 Harness | 文档、评审、测试、发布门禁 | 随仓库既有实践 | 持续 Steering Loop |
| 运行时 Harness | 主循环预算、完整性、续跑、可观测状态 | MaxIterations=16 硬停;续聊链路已有;integrity 较好 | 统一 [13-契约](13-运行结果状态与可续跑契约.md):`incomplete` 一等公民 |
| 反馈回路 | 失败可纠正、未完成可续 | 续聊可用;缺统一 incomplete 语义 | API/事件暴露 reason + resumable |
共同缺口:长时间任务的任务级 checkpoint、触顶后的诚实 `incomplete`(而非仅 error)。
借鉴:Anthropic long-running harness;oh-my-pi(retry 与 compaction 分轨、resume 重建 context)。