Agent 工程里的经典架构

从 做 Agent，绕不开过去那些架构问题 出发，逐个理解原文提及的 18 份技术资料。系列围绕软件开发中的具体问题展开，保留来源，并加入独立设计的业务案例、可运行代码和机制图。

文章按 2026 年 11 月 14 日至 12 月 2 日每天一篇的顺序编排，本系列已一次性公开，可直接连续阅读。

日期文章关注的问题
11-14做 Agent，绕不开过去那些架构问题高并发架构经验如何延续到长期任务
11-15预写日志：程序说“成功”之前，应该先留下什么把持久化的边界放在成功响应之前，才能讨论故障恢复。
11-16事件溯源：除了现在是什么，还要知道怎么走到这里用业务事件重建状态，让任务历史成为可解释的依据。
11-17快照：历史越来越长，恢复不能越来越慢保存带版本和位置的状态，缩短历史重建路径。
11-18Actor 模型：把并发问题放回业务实体里面同一实体顺序处理消息，不同实体并行推进。
11-19幂等接收者：请求可以重试，业务不能重复发生用稳定操作标识与原子记录识别重复请求。
11-20Saga：流程做到一半失败，已经做的事情怎么办拆分长事务，并为已完成的业务动作设计补偿。
11-21乐观离线锁：审批等了三天，提交前还要再看一眼把并发校验与最终写入放进同一原子操作。
11-22企业应用架构：给 Agent 接工具，也是在设计业务入口把入口、业务规则和数据访问分开，让约束能被复用。
11-23规则分派：今天收到的事件，应该按哪一天的规则处理显式选择业务规则版本，避免晚到事件被新规则误算。
11-24已发布接口：存下来的日志，也是给未来代码的接口把持久数据当作跨版本契约，显式处理兼容性。
11-25并行变更：让新旧版本有一段共同工作的时间先扩展兼容能力，再迁移，最后删除旧契约。
11-26没有银弹：先分清复杂度来自业务，还是来自实现用业务结果评估自动化，而不只比较模型或代码速度。
11-27类型化决策：让模型选动作，程序负责判断能不能做分开模型建议、置信判断与业务授权三个边界。
11-28MemGPT 的启发：长期记忆需要管理，不能只靠更长上下文区分工作上下文与外部记忆，按当前任务选择证据。
11-29从 Letta 看有状态 Agent：记住用户之后，还要管理记忆给记忆稳定身份、版本和来源，明确跨会话状态的归属。
11-30Agent 安全：读到一句话，不等于获得一项权限让外部内容停留在数据边界内，由可信服务执行授权。
12-01数据产品：先把业务事实整理好，再让 Agent 做判断用清楚的边界、质量目标和接口契约交付可用数据。
12-02从 Agent/works 看治理：Agent 多了以后，谁来管权限和成本在执行入口统一管理策略、用量和可追踪记录。

每篇专题中的 example.py 均可下载，使用 Python 3.9 或以上版本运行，只依赖标准库。示例不连接真实模型、支付或采购服务；产品相关篇目会明确说明哪些是概念演示，哪些是官方能力。