适用读者:读过 J19–J21,想补齐"工程侧"细节的人:token 账本、卡死形态、脚手架、权限光谱、脑手分离、审查分离。
前置:S21-J19(补全机器)、J21(Harness 与多 Agent)、J22(安全)、S22-J05(生产循环)。
覆盖旧文:5068–5104(另一部教材卷零–卷五,37 章)。其中卷二的 8 章(5075–5082上下文策展)与 J19/J20 高度重合,登记为duplicate_ref,本篇不复述;其余 29 章主讲。
扩展点:E-S21-052(token 账本:词表税、I/O 比与账单结构)、E-S21-053(卡死形态学与防呆三层网)、E-S21-054(脚手架工程:80/20 法则的四个子工程)、E-S21-055(权限光谱五档与"脑手分离/审查分离"两种结构)。
下一篇:待写(J25 · 卷六到卷十:记忆、成本、优化与评估基建)。
1. 一句话结论
Agent 工程质量 = 账本能算、卡死能停、脚手架能改、权限能收。这四条都跟模型能力无关——模型再强,账本不清就是烧钱,卡死不停就是失控。
出处:
A-5068(0.1 总纲)、A-5071(1.3 Token 经济学)、A-5097(5.2 卡死形态学)、A-5098(5.3 脚手架工程)、A-5099(5.4 权限光谱)。
2. token 账本(E-S21-052,卷一)
成本 = 输入 token × 输入单价 + 输出 token × 输出单价(+ 缓存命中折扣)
输入 token 通常远多于输出:Agent 场景 I/O 比可达数十比一(原文举例 62:1)
词表税(1.3):同一段中文,不同 tokenizer 的 token 数可能差 20–40%;换模型要重算预算,不是换个 URL 就完事。
采样与温度(1.4):低温稳定、高温发散;Agent 决策低温,创意高温。
知识观(1.5):模型知识有截止日期与数据边界;"开源"不等于无限制,蒸馏有法律与质量代价(原文观点,具体合规按各地法规待核)。
训练全景(1.6):预训练→mid-training→SFT→RL;四段各改什么,决定你遇到问题时该动哪段(见 J22 §5)。
判据:"先记账,再优化"——没有按任务维度的成本归因,优化只能靠猜。
3. 上下文策展(卷二,duplicate_ref)
5075–5082 讲的是总论 / KV Cache / 压缩决策 / 状态栏 / 结构化笔记 / 分层 System Prompt / 子 Agent 隔离 / 溢出救火,与 J19 §3(四层策展) 和 J20 §2(四失效) 同题。
本篇只保留两条不重复的补充:
| 补充 | 内容 |
|---|---|
| 状态栏(2.4) | 三行常驻:目标 / 进度 / 硬约束;每轮开头重述,防"遗忘型漂移" |
| 分层 System Prompt(2.6) | 不用的东西别给 AI 看:基础规则常驻、领域规则按需、示例按需 |
4. 提示与交互(卷三)
| 章 | 结论 | 与 J19 的关系 |
|---|---|---|
| 3.1 提示主干 | 角色 + 三块骨架(任务/约束/样例)+ 四技巧(分解/对比/格式锚定/反例) | J19 已提,此处补技巧清单 |
| 3.2 输出格式 | Markdown 人读、JSON 机读、混合分两段 | 同 J19 |
| 3.3 流式体验 | 首字时间决定"感觉快";等待期的劳动错觉 | 同 S22-J05 |
| 3.4 交互工程 | 状态三件套 + 防错(可撤销、二次确认、边界) | 同 J19 |
| 3.5 审美工程 | AI 味可量化:禁用词表、句长分布、视觉预算、规格书 | 新增:把"审美"变成可检查项 |
判据:"审美要求的可执行形式是清单,不是形容词"。
5. 工具全谱(卷四,补 J19 未覆盖部分)
| 章 | 结论 |
|---|---|
| 4.3 多工具编排 | 并发(独立)/ 串行(依赖)/ 智能分批(限流下最大化吞吐);能并发的不串行 |
| 4.5 工具爆炸与主动发现 | 全量注入 → 按需声明 + 工具检索;单次可见工具建议 ≤ 10 |
| 4.6 Skill | 经验封装 + 渐进式披露(同 J21 §3) |
| 4.7 Think Tool | 只思考、无副作用的工具;多约束权衡时用,简单查询不用 |
| 4.8 执行流水线 | 三段瀑布:参数校验 → 权限/审批 → 执行;单调 Guard:护栏只增不减 |
单调 Guard 的含义:不允许某条代码路径"跳过"某项检查——检查必须是数据流上的必经节点,而不是可选的 if。
6. 本体与卡死(E-S21-053,卷五前半)
螃蟹图(5.1):一个"大脑"(模型)+ 两个"钳子"(工具与记忆)+ 循环。判据:任何 Agent 都能拆成这四块,出问题先定位是哪一块。
卡死形态学(5.2):四种形态(重复调用、乒乓、等待幻觉、长尾工具)与防呆三层网:
第一层 硬上限:步数 / token / 时间 / 成本
第二层 无进展检测:tool+args 哈希、结果哈希
第三层 结构化终止:status=continue|done|blocked
与 S22-J05 同源;本篇补充"形态学"视角:先分类再防护,防护要打类型日志。
7. 脚手架工程(E-S21-054,5.3)
"80% 脚手架 + 20% 模型"的四个子工程:
| 子工程 | 内容 | 失败表现 |
|---|---|---|
| 上下文工程 | 选材、压缩、注入顺序 | 溢出、漂移 |
| 工具工程 | 定义、校验、执行、裁剪 | 选错、参数错 |
| 状态工程 | 持久化、续跑、幂等 | 无法恢复、重复副作用 |
| 观测工程 | 轨迹、指标、告警 | 无法归因 |
判据:"换模型只影响 20%,改脚手架影响 80%"——所以优化顺序应先脚手架后模型。
8. 权限光谱与两种结构(E-S21-055,卷五后半)
五档权限(5.4):
① 只读建议(不执行)
② 执行可逆动作(写草稿、建分支)
③ 执行不可逆但可补偿(发通知,可撤回)
④ 执行不可逆(下单、删除)→ 必须审批
⑤ 长期授权(后台常驻、定时任务)→ 必须有预算与审计上限
两种结构:
| 结构 | 机制 | 适合 |
|---|---|---|
| 脑手分离(5.6 Managed Agent) | 决策者(脑)与执行者(手)分开,手是"牛群"可并行受管 | 大量重复执行、需集中策略 |
| 提议者-审核者(5.7) | 一个生成、一个审查,审查者不看生成者的理由(防附和) | 高风险输出、需独立校验 |
判据:"审查者必须独立取证"——让审查者读生成者的推理,它只会附和(认知投降,见 J23 §7)。
长任务交接(5.5):交接五行(目标/已完成/未完成/约束/下一步),与 J20 §3 一致。
可观测性与审计(5.9):轨迹(每步摘要)、指标(步数/延迟/成本)、审计(五字段:谁/何时/对什么/做什么/结果)。
9. 反例:八种"工程侧失控"
| 做法 | 后果 |
|---|---|
| 不按任务记成本 | 无法定位烧钱环节 |
| 换 tokenizer 不重算预算 | 预算全线失真 |
| Guard 写成可选 if | 某路径绕过检查 |
| 权限长期停在最高档 | 一次误操作即不可逆损失 |
| 审查者读生成者理由 | 附和式通过 |
| 状态不持久化 | 长任务永远跑不完 |
| 不做轨迹 | 失败无法归因 |
| 把"审美"写成形容词 | 无法验收 |
10. 自测
- token 账本怎么算?词表税为何重要?
- 卡死四形态与三层网?为什么要打类型日志?
- 脚手架的四个子工程?为什么"先脚手架后模型"?
- 权限五档?脑手分离与提议者-审核者各适合什么?
- 为什么审查者不能看生成者的推理?
答案
- 输入/输出分别计价,Agent 输入占大头;换 tokenizer 后同文本 token 数变化。
- 重复/乒乓/等待幻觉/长尾;硬上限、无进展检测、结构化终止;日志区分"高效"与"打转"。
- 上下文/工具/状态/观测;模型只占 20%,脚手架决定上限。
- 只读、可逆、可补偿、不可逆、长期授权;大量重复执行用脑手分离,高风险输出用审查分离。
- 会附和(认知投降),失去独立校验意义。
11. 下一篇
待写(J25 · 卷六到卷十)—— 记忆守门员与结构化索引、Contextual Retrieval、成本四陷阱与熔断、七层优化(语法/语义/架构/输出)、评估基建与后训练实践。
本篇属于系列《S21 · Agent 与工具协议》。旧文来源:A-5068–5104(卷零–卷五 37 章,卷二 8 章登记为 duplicate_ref → J19/J20);扩展点 E-S21-052…055。