蓝图

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 架构从模型中心转向工程化、可验证的系统实践。