原子概念 / Agent engineering layers
Model、Framework、Runtime 与 Harness
把生成、开发抽象、真实执行与业务责任分开。
检索别名:框架 · SDK · Runtime
01 输入
- 模型输出
- 工具合同
02 处理机制
- 识别开发抽象
- 定位执行权威
- 核对完成责任
03 输出与证据
- 组件职责图
- 可替换边界
四种不同的能力
Model 根据上下文生成文本或工具请求,它并不天然拥有数据库连接、持久状态或授权。Framework/SDK 提供工具定义、状态图、handoff、适配与 tracing 等开发抽象。Runtime 实际负责排队、资源、恢复和执行。Harness 包围模型,负责组装上下文、调用工具、处理反馈与停止;loop 是其中不断观察和行动的核心。
这些是职责划分,并非必须购买四套产品。托管平台可能同时提供 runtime 和 harness;框架也可能逐步扩展到持久执行。采购时要把功能映射回责任,而不是只根据产品名称归类。OpenAI 的架构文档明确分出应用服务器、harness 与环境;Anthropic 的 Managed Agents 说明也区分会话、harness 和 sandbox。这说明相同“Agent”一词可能覆盖不同控制边界。
如何验证边界
把模型服务临时替换成只返回固定工具请求的桩,检查工具授权、状态保存、取消与最终完成是否仍由程序保证;再使 worker 中断,检查恢复是否依赖只存在内存里的状态。如果业务规则随模型口头承诺而变化,说明控制逻辑还没有落到系统。
选型启示
在概念验证阶段,可以使用一个进程和现成 SDK。进入多用户、长任务和外部写入后,必须知道谁负责会话事实、恢复权威和工具副作用。产品路线页按这些维度比较,而不是按框架功能列表简单计数。
RELATIONSHIP MAP
与其他节点的关系
箭头从本节点指向目标;关系是工程分析映射,不代表厂商合作或已披露的内部实现。
PRIMARY SOURCES
来源与阅读边界
来源按研究截止日整理。官方文档说明能力和约束,代码只证明对应版本,论文与讲座不自动证明生产效果。 资料截止:2026-10-15。
- OpenAI:Agents API architecture ↗官方文档 / 声明
- Anthropic:Managed Agents 架构 ↗官方文档 / 声明