Agent 系统架构
核心结论:本文出自 davidahmann 创建的 fde-guide 项目,专门为前线部署工程师(FDE)提供 Agent 系统架构指南。核心主张是将 Agent 视为运营软件中的组件,而非系统本身,通过显式边界和持久化状态来构建可控的系统。架构按 Harness、Loop、Graph 三层组织:Harness 层负责模型运行的安全上下文、工具、权限和沙箱;Loop 层管理目标、证据、反馈和重试等改进闭环;Graph 层定义节点、路由、审批和恢复等工作流逻辑。智能选择遵循“最小充分机制”原则,只在非结构化解释能带来可量化价值时才调用基础模型,否则优先使用确定性代码或经典 ML。指南还提供了 11 种参考蓝图,例如用于证据路径多变的 Bounded Retrieval Agent、需要策略约束与回滚的 Transactional Write Agent、以及处理多专业上下文的 Multi-Agent Coordinator 等。安全方面采用神经符号护栏,将概率模型推断与确定性领域逻辑结合,并强制实施最小权限、隔离和显式工具契约。对于多智能体系统,仅在数据权限、上下文或组织归属不相交时才被允许,协调通过 handoff-envelope 绑定身份、权限与预算。整个方案旨在将 Agent 架构从模型中心转向工程化、可验证的系统实践。
- Agent 系统被视为运营软件中的组件,而非系统的全部,架构强调显式边界、持久化状态和分层决策机制。
- Harness/Loop/Graph 三层模型分别回答安全运行环境、工作检验与改进、工作流下一步控制的问题。
- 最小充分机制原则要求优先使用确定性代码、优化或经典 ML,仅在非结构化解释能带来可量化价值时调用基础模型。
- 指南提供 11 种参考蓝图,包括 Bounded Retrieval Agent、Transactional Write Agent、Multi-Agent Coordinator 和 Computer-Use Action Boundary 等。
- 安全与可靠性通过神经符号护栏实现,将概率模型解释与确定性领域逻辑结合,并强制实施最小权限、隔离和显式工具契约。
- 多智能体系统仅在工人需要非重叠的受限数据、实质不同的上下文或不同的组织归属时才被引入,协作通过绑定身份、权限和预算的 handoff-envelope 管理。
这篇来自 davidahmann/fde-guide 的 Agents 系统架构指南,为所有正在构建 AI Agent 的工程师提供了一套务实的架构框架。它没有停留在概念层面,而是直接给出了 Harness/Loop/Graph 三层模型、最小充分机制、11 种参考蓝图以及神经符号护栏,把安全边界、工作流逻辑和智能选择决策缝合成了一个可落地的整体。无论你是刚接触 Agent 开发,还是已经在治理复杂的多智能体系统,这份指南都能帮你厘清边界、减少过度依赖大模型的风险,是当前行业极其稀缺的系统性实践手册。
Agent 系统被视为运营软件中的组件,而非系统的全部,架构强调显式边界、持久化状态和分层决策机制。
—— 络石智能编辑部 · 编辑推荐Agent 系统架构
FDE指南中的Agent系统被视为操作软件中的组件,而非系统本身。该架构强调明确的边界、持久化状态以及分层决策机制,其中基础模型仅在非结构化解读能带来可衡量价值时使用。
Harness/Loop/Graph 模型
架构分为三个不同的层次,以分离环境、反馈机制和工作流逻辑。
| 层 | 回答的问题 | 典型内容 | | --- | --- | --- | | Harness | 模型能否安全有效地运作? | 上下文、工具、工作区、状态、权限、沙箱、预算、追踪记录 | | Loop | 工作如何被检查和改进? | 目标、证据、反馈、重试、停止规则、升级 | | Graph | 下一步允许发生什么? | 节点、路径、分支、合并、并发、审批、恢复 |
分层架构映射
该图连接了概念层与工程套件中定义的特定代码实体和模式。
来源:library/03-agent-system-architecture.md 5-13 blueprints/README.md 26-47
智能选择
“最小充分机制”原则规定:当输入和分支已知时,应优先使用确定性代码、优化或经典机器学习,而非基础模型。
有关选择矩阵及记录这些决策的模板详情,请参阅“智能选择与机制设计”。
来源:library/12-software-architecture-and-intelligence-selection.md 9-23 blueprints/README.md 53-59
参考蓝图
本指南提供11个参考蓝图,用于标准化常见的Agent模式,从简单的检索到复杂的多Agent平台。
| 蓝图 | 选择条件 | | --- | --- | | 有界检索Agent | 变量证据路径、只读结果、可靠的充分性测试。 | | 事务写入Agent | 外部变更、策略约束、审批或回滚。 | | 多Agent协调器 | 不同的工具、数据范围、权限或专业化上下文。 | | 计算机操作边界 | 视觉界面是访问目标系统的唯一可行路径。 |
有关蓝图完整列表及选择矩阵,请参阅“参考蓝图”。
来源:blueprints/README.md 3-19
安全与操作边界
可靠性通过神经符号防护栏实现:将概率模型解读与确定性领域逻辑相结合。生产级Harness通过最小权限、隔离和明确的工具契约来确保安全。
该图将自然语言意图映射到代码强制执行的安全检查。
来源:library/03-agent-system-architecture.md 82-91 library/12-software-architecture-and-intelligence-selection.md 66-79
有关安全模型和基于能力的访问控制详情,请参阅“安全与操作边界”。
多Agent拓扑
只有当工作者需要非重叠的受限数据、显著不同的上下文或不同的组织所有权时,才允许使用多Agent系统。Agent之间的协调通过handoff-envelope(交接信封)进行管理,该信封绑定了身份、权限和预算。
有关拓扑选择和协调协议的研究,请参阅“多Agent拓扑”。
来源:blueprints/multi-agent-coordinator.md 3-13 blueprints/multi-agent-coordinator.md 45-57 research/2026-08-14--multi-agent-topology-selection.md 11-12
标签
相关主题
专家点评
本文由编辑团队收录整理,内容来源于公开信息,仅供参考。