← Playbook 索引
Playbook阶段 7可泛化原则
智能体架构设计（Agent Architecture Design）
交付
把已经冻结的验收标准和真实数据事实，落成责任清楚、可以演进的 Agent 架构。重点不是画一张漂亮的图，而是确定模型、工具、确定性代码、权限、守卫和可观测性分别对什么负责。
什么时候拿出来用
- 准备从需求与 Probe 进入首版建设，或现有 Agent 开始出现规则堆叠和改 A 坏 B
- 需要引入长任务、多轮上下文、模型切换或更严格的权限控制
开始前先拿到
- 冻结的验收 Case
- 已经确认的数据、接口和权限契约
- 待支持的场景优先级与运行约束
操作主线
怎么推进
公开的是判断与动作骨架。客户数据、私有模板和内部示例不在其中。
- 01
先立最小循环
用一条端到端主链验证模型能按工具描述选择动作，不先堆分类器和预取分支。
- 02
钉住契约与守卫
把字段、指标、工具参数、输出格式和禁止行为放进确定性责任层。
- 03
补运行边界
设计时间预算、认证续期、上下文继承、长任务恢复和遥测，不让失败静默降级。
- 04
记录架构决定
为重大取舍写清背景、备选、责任层、验证方法和回滚方式。
会留下什么
- 责任层清楚的参考架构
- 数据、工具和输出契约
- 关键架构决策记录
过关前再看一遍
- 每个硬要求都有唯一执行责任层
- 关键决策有验证与回滚方式
- 架构能直接承接下一阶段的最小原型
Exit Gate · 放行条件
责任层与契约落位、决策有记录
容易做错的地方
- 主链未跑通就引入复杂流水线
- 用提示词承担必须永远成立的规则
- 守卫未经观察就直接拦截生产回答
这套方法怎么落到你的项目
这是我们交付生产级 AI Agent 的公开、脱敏方法骨架。真正落地时，从 AI Agent 生产就绪审查与路线图 入手，或先用 生产上线前深检 定位薄弱环节。