为什么写
Agent 领域变化很快，概念越来越多。真正能复用的，往往不是某个新名词，而是一些朴素的工程问题：任务边界怎么定、工具怎么给、状态存在哪、如何判断改动有效。
我把这些问题写下来，一是逼自己把逻辑讲清楚，二是希望给正在搭第一个 Agent 的人一个可运行的起点。
关注什么
- Agent 的架构与状态管理；
- 工具、权限和副作用设计；
- 记忆、检索和上下文控制；
- 评估、失败分类与回归测试；
- 多 Agent 协作的真实收益与成本。
不写什么
不追热点评测，不写“万能提示词”，也不把未经验证的框架推荐包装成结论。这里的内容来自实际搭建和复盘，会随着实践继续修正。
一个约定
文章里的代码是骨架，不是可直接上线的完整系统。上线前请按自己的权限、数据和失败场景补齐边界。
联系
这是个人技术记录，暂不提供在线服务、账号、评论或投稿。若你也在搭 Agent，欢迎带着具体问题交流。