跳到正文
SGSteven Guan

原子概念 / Agent engineering layers

Model、Framework、Runtime 与 Harness

把生成、开发抽象、真实执行与业务责任分开。

要解决的问题为什么换一个模型或 SDK,产品仍可能失败?

检索别名:框架 · SDK · Runtime

BLUEPRINT局部蓝图

01 输入

  1. 模型输出
  2. 工具合同
→

02 处理机制

  1. 识别开发抽象
  2. 定位执行权威
  3. 核对完成责任
→

03 输出与证据

  1. 组件职责图
  2. 可替换边界

四种不同的能力

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。

  1. OpenAI:Agents API architecture ↗官方文档 / 声明
  2. Anthropic:Managed Agents 架构 ↗官方文档 / 声明