在线配套资料¶
在线配套资料保存那些需要独立于纸质书稿进行版本管理、验证和更新的内容。
书中保留论证、决策标准和最小契约形式;这里保留完整的命令行演练、运行时配置、追踪与事件目录、评估数据集、资料来源和参考演练。
主要入口¶
- 运行时配置与 MCP 边界
- 运行时命令行
- 评估数据集
- 追踪与事件
- 模板
- 检查清单
- 变更日志
- 勘误
- 示例工件:
artifacts/trace-demo.jsonl、artifacts/trace-failed-tool-timeout.jsonl、artifacts/trace-post-dispatch-timeout.jsonl、artifacts/session-failed-tool-timeout.json、artifacts/eval-failed-run-timeout.json、artifacts/eval-unknown-effect-reconciliation.json - 已填写示例:
examples/capability-contract-support-ticket.md、examples/release-decision-record-support-ticket.md、examples/incident-record-support-ticket-timeout.md、examples/production-readiness-support-ticket.md、examples/context-manifest-support-ticket.yaml、examples/threat-map-negative-tests.yaml、examples/slo-card-support-ticket.yaml、examples/adlc-transition-support-ticket.yaml、examples/readiness-rubric-support-ticket.yaml - 完整参考包演练
- 完整资料来源列表
安全智能体实践路径¶
希望亲手复现材料的读者应从完整参考包演练开始。它把各章与 agent_runtime_ref 文件、命令行命令、配套工件和测试连接起来。最短实践路径是:用 inspect-agent 检查清单,用 simulate-run 执行受控运行,用 dump-events 和 inspect-trace 获取证据,用 inspect-approvals 检查人工闸门,用 export-eval-dataset 导出评估数据,再用 check-rollout 和 check-controls 做发布决策。
哪些内容应放在这里¶
- 完整的 YAML 配置和评审表单。
- 命令行命令及预期 JSON 接口。
- 追踪、事件及验证消息目录。
- 评估数据集、验证器契约和发布判断示例。
- 较长的资料目录、变更日志、勘误和更新规则。
哪些内容应留在书中¶
- 为什么需要某个架构决策。
- 它控制什么风险。
- 谁对动作及其证据负责。
- 团队如何判断运行时、策略、追踪、评估闸门和发布已经就绪。
章节地图¶
这张地图把每一章纸质书稿与在线书中的对应主题,以及最接近的可执行或参考工件连接起来。链接名称比网站内部编号更重要:即使在线结构调整,读者仍可按主题和可验证工件查找,而不必猜测哪一章编号相同。
| 纸质书章号 | 在线主题 | 实践与参考 |
|---|---|---|
| 1 | 为什么智能体需要平台 | 参考包 |
| 2 | 执行形式、管理者与交接 | 实用请求模式 |
| 3 | 安全智能体架构 | 技术栈地图 |
| 4 | 信任边界 | 策略模板 |
| 5 | 策略层与能力目录 | 策略包模式 |
| 6 | 工具网关与审批 | 审批模式 |
| 7 | 记忆风险 | 记忆评估模式 |
| 8 | 记忆类型与生命周期 | 记忆检索模式 |
| 9 | 上下文检索与压缩 | 连续性信封 |
| 10 | 执行模型与工具 | 配置参考 |
| 11 | 沙箱与 MCP、MCP 与 A2A 边界 | 工具故障恢复 |
| 12 | 重试、限制与回滚 | 工具故障恢复 |
| 13 | 追踪与事件 | 追踪与事件目录 |
| 14 | 智能体系统 SLO | 已填写的 SLO 卡片 |
| 15 | 评估与回归闸门 | 评估数据集 |
| 16 | 端到端证据链 | 变更评审与发布模式 |
| 17 | 平台团队与产品团队 | 能力契约模板 |
| 18 | 受支持的黄金路径 | 已填写的黄金路径契约 |
| 19 | 智能体清单与注册表 | 注册表运维手册 |
| 20 | 从 SDLC 到 ADLC、变更管理 | ADLC 转换示例 |
| 21 | 来源与可信工件 | 生命周期工件模式 |
| 22 | 可观测性与检测遥测 | 追踪模式 |
| 23 | 目标错位与内部风险、行为评估 | 威胁模型负面场景 |
| 24 | 保障与响应 | 事件响应手册 |
| 25 | 退役与替换 | 生命周期工件模式 |
| 26 | 基础运行时 | 命令行参考 |
| 27 | 策略与能力目录 | 可执行轨迹策略场景 |
| 28 | 生产发布检查清单 | 生产就绪检查清单 |