第1章 Agent模块解耦设计原则

模块解耦是Agent系统架构设计的核心挑战。当感知、决策、执行、记忆、工具调用等模块耦合在一起时，任何一个模块的变更都可能引发连锁故障，导致系统难以维护、测试和扩展。本章立足四大经典设计原则——单一职责、接口隔离、依赖倒置、最小知识——建立一套可评审、可落地的解耦设计基准。每个原则不仅是一种“编码风格”，更是一种架构边界契约，直接决定了Agent系统的可演进性。

1.1 原则体系概述

四个原则分别对应解耦设计的四个关键维度：

• 单一职责（SRP） — 界定边界，回答“一个模块应该承担多少职责”。
• 接口隔离（ISP） — 定义分层，回答“模块之间如何最小化通信契约”。
• 依赖倒置（DIP） — 治理信任链路，回答“高层模块是否应该依赖低层模块”。
• 最小知识（LoD） — 控制信息流，回答“一个模块应该知道其他模块的多少细节”。

四个原则并非孤立存在，它们在Agent架构中形成互补：SRP划定模块边界，ISP约束跨层通信的粒度，DIP反转依赖方向以避免底层变更向上传导，LoD则限制模块间的信息暴露面，最终共同构建高内聚、低耦合的Agent系统。

1.2 边界界定：单一职责原则

在Agent系统中，单一职责原则要求每个模块只承载一类核心能力。例如，感知模块只负责多源信息采集与标准化，不参与决策逻辑；执行模块只负责动作调度与反馈采集，不存储历史状态。职责的合理粒度是解耦的首要前提。

1.3 分层通信：接口隔离原则

接口隔离原则强调“不强迫模块依赖它不需要的接口”。在Agent架构中，这意味着模块之间的通信契约应该按角色拆分，而非提供一个“大而全”的中间件总线。例如，记忆模块对外提供store和retrieve两个独立接口，而不是一个包含增删改查所有操作的MemoryService接口——这样执行模块只需要绑定store接口，无需感知retrieve的实现细节。

• 数据流控制：按消费者角色拆分接口，避免一个接口被多个不同用途的模块依赖。
• 分层约束：上层模块只依赖下层模块的“最小必要接口”，下层模块不反向依赖上层接口。
• 演进代价：接口越臃肿，变更影响面越大。接口隔离直接降低重构时的回归范围。

1.4 依赖治理：依赖倒置原则

依赖倒置原则的核心是“抽象不应依赖细节，细节应依赖抽象”。在Agent系统中，这意味着高层策略模块（如决策模块）不应直接依赖低层实现模块（如具体的LLM客户端或工具调用器），而是通过抽象接口交互。这种反转构建了一条稳定的信任链路：高层模块定义“契约”，低层模块实现“契约”。

• 信任链路设计：决策模块依赖LLMService抽象接口，而非具体的OpenAILLM或ClaudeLLM，使得模型替换不冲击决策逻辑。
• 选型权衡：引入抽象层会增加初始设计复杂度，但能显著降低后期模型升级或供应商切换的迁移成本。
• 评审焦点：检查依赖方向是否一致指向稳定层，是否存在“循环依赖”或“反向依赖”的坏味道。

1.5 信息隐蔽：最小知识原则

最小知识原则（Law of Demeter）要求模块只与直接的、有限的“朋友”通信，不穿透调用链去访问间接对象。在Agent场景中，最常见的违规是“链式调用”：agent.decision().context().history()——这种调用暴露了从决策到上下文再到历史存储的完整内部路径，任何一个内部结构变化都会导致调用方失效。

• 信息边界：每个模块只暴露完成其职责所必需的最小数据集合，不暴露内部状态或中间数据。
• 风险控制：链式调用和不必要的公开属性是耦合的温床。评审时应当标记所有跨越2层以上的间接调用。
• 控制流影响：最小知识原则同时限制了控制流的传播路径，避免一个模块的内部逻辑变更波及远端的消费者。

1.6 原则协同与架构权衡

四个原则在Agent架构中形成“边界—契约—方向—信息”四层协同关系。下面的SVG图展示了它们如何共同支撑起解耦后的模块层：

四个原则在架构权衡中并非总是“越多越好”，而是需要根据系统规模和演进阶段做取舍：

1.7 落地步骤与验收标准

将四大原则落地到Agent模块解耦评审中，建议遵循以下渐进式步骤：

1. 现状盘点：绘制当前Agent模块依赖图，标记出职责过载、接口臃肿、反向依赖和链式调用的位置。
2. 原则排序：根据系统痛点，确定优先应用的原则（通常先从单一职责和最小知识入手，再引入接口隔离和依赖倒置）。
3. 接口契约重定义：按ISP拆分大接口，按DIP为不稳定的底层依赖引入抽象层。
4. 边界重组：按SRP合并或拆分模块，确保每个模块的职责描述不超过一句话。
5. 信息流审计：逐模块检查public方法和属性的调用链，删除不必要的“朋友”关系。
6. 自动化检查：配置架构评审规则（如依赖方向检查、接口扇入扇出阈值、链式调用检测），集成到CI流水线。