Agent 系统设计的核心思想
一套面向 Agent 应用设计者的系统化设计原则、架构模式与实战指南。
基于对 WorkBuddy（CodeBuddy Code）工作空间源码、系统提示词、文档与架构的深度分析提炼而成。
目录
- 概述：从 Chatbot 到 Agent 的范式跃迁
- 原则一：闭环执行架构
- 原则二：人格化身份体系
- 原则三：分层记忆系统
- 原则四：纵深防御安全模型
- 原则五：渐进式能力扩展
- 原则六：多模态工作模式
- 原则七：上下文精细管理
- 原则八：可组合的工具哲学
- 系统架构全景图
- 可复用的设计模式清单
- 设计决策框架
- 常见反模式
1. 概述：从 Chatbot 到 Agent 的范式跃迁
1.1 Chatbot 和 Agent 的本质区别
| 维度 | Chatbot | Agent |
|---|---|---|
| 核心能力 | 理解并回答 | 理解、计划、执行、验证 |
| 与环境的交互 | 被动接收文本 | 主动感知文件系统、网络、工具 |
| 输出的性质 | 文本回答 | 实际行动（文件变更、API 调用、部署） |
| 正确性保障 | 依赖训练数据 | 通过执行测试、编译、对比等方式自我验证 |
| 会话生命周期 | 一问一答，无持续性 | 跨多轮持久化，可中断恢复 |
| 用户角色 | 提问者 | 协作者/监督者 |
设计 Agent 系统，首先要完成这个认知跃迁：Agent 不是"更强的 Chatbot"，而是一种全新的交互范式。
1.2 Agent 设计的核心张力
在设计 Agent 系统时，始终面临以下四对核心张力：