<!-- title: 官方Agent SDK运行时解耦横评 -->

# 官方Agent SDK运行时解耦横评：harness与算力分家，2026选型定盘

## 概述

2026年Agent框架战场出现一次结构性反转：Anthropic、OpenAI、Google三家在2025年下半年到2026年密集推出的官方Agent SDK，都不再把自己定位为"编排框架"，而是定位为**"内置运行时（vendored runtime）"**——它们自带工具集、自带沙箱、自带执行循环（agent loop）、自带hooks与权限闸门。真正决定生死的不再是"谁来编排多智能体"，而是"**harness（执行外壳）与compute（算力/沙箱）解耦**"做得有多彻底。OpenAI在2026年4月15日的0.14更新把agent harness与计算层切开、一次接入7家沙箱供应商；Microsoft在Build 2026用MXC沙箱+CodeAct重申"我们要拥有执行层"。本文横评Claude Agent SDK、OpenAI Agents SDK（0.14）、Google ADK、PydanticAI、Microsoft Agent Framework五条主流运行时路线，给出按场景的定盘建议。

## 五大运行时多维度对比

| 维度 | Claude Agent SDK | OpenAI Agents SDK 0.14 | Google ADK | PydanticAI | Microsoft Agent Framework |
|------|------------------|------------------------|------------|------------|---------------------------|
| 定位 | CLI运行时的编程包装 | 轻量编排+沙箱harness | 代码优先全功能平台 | 类型安全轻封装 | 企业编排+MXC执行层 |
| 核心原语 | agentic loop + hooks + subagents | Handoff + Guardrail + Tracing | sessions/state + callbacks | Agent + deps + result_type | Threads + Tools + CodeAct |
| 内置工具 | Bash/文件/Web/编辑全栈 | apply_patch+shell（v2） | 需自配或接Vertex | 纯函数工具 | CodeAct代码解释器 |
| 模型绑定 | 强绑定Claude | 强绑定OpenAI | 强绑定Gemini | 模型无关 | 模型无关 |
| 沙箱/隔离 | permission_mode三态 | 7家沙箱供应商可选 | 依赖Vertex Agent Engine | 无（你自带） | MXC托管沙箱 |
| 语言 | Python/TS | Python | Python/Java/TS | Python | .NET/Python/JS |
| 上手成本 | 低（自带运行时） | 中（需配沙箱） | 中高（概念多） | 极低 | 中（企业概念重） |
| 变现/训练营潜力 | 高（卖点足） | 高（生态最大） | 中（云绑定重） | 中（偏极客） | 中（B端场景） |
| 最近更新 | 2026活跃迭代 | 2026-04-15沙箱大更新 | 2025底开源、2026补全 | 2026活跃 | Build 2026发布 |

## 深度分析

### 一、Claude Agent SDK：把Claude Code的循环直接卖给你

Claude Agent SDK的本质不是"框架"，而是把Claude Code CLI那条经过亿级实战打磨的**agentic loop（智能体循环）**做成了可编程接口。它启动一个agent后，运行的就是驱动Claude Code的同一条循环：Claude评估请求→决定调用工具→执行工具→把结果喂回→继续推理，直到任务完成。这意味着它开箱就带着一整套真实可用的内置工具——读文件、跑命令、搜网页、改代码——而不是像传统框架那样给你一个空壳让你自己写工具适配。

```python
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        permission_mode="acceptEdits",   # 三态权限：default/acceptEdits/bypassPermissions
        allowed_tools=["Bash", "Read", "Write", "WebSearch"],
        hooks=hooks,                      # 工具调用前后注入自定义逻辑
        mcp_servers=mcp_config,           # 原生MCP，零胶水接外部工具
        setting_sources=["project", "user"],
    )
    async for message in query(prompt="给这个仓库加测试并跑通", options=options):
        print(message)
```

它的杀手锏有三：**hooks系统**（在每次工具调用前后、agent启停时挂载逻辑，等于一条可编程的中间件带）、**subagents（子代理）**（把任务扇出给隔离上下文的子循环，天然带权限边界）、**原生MCP支持**（不用写一行胶水就能接Model Context Protocol的任何工具服务器）。缺点同样尖锐：强绑定Claude模型，换芯等于换SDK；运行时偏重，做轻量API任务有"用推土机挖花盆"之嫌。**变现评估**：训练营卖点极强——"用驱动Claude Code的同款循环造产品"这句话本身就能卖票，适合做编程agent、自动化运维agent方向的产品课。

### 二、OpenAI Agents SDK 0.14：harness与算力正式分家

OpenAI Agents SDK最初是Swarm的教育性升级版，靠三个原语打天下：**Handoff**（agent之间显式交接控制权）、**Guardrail**（在交接边界做输入/输出安全校验）、**Tracing**（每一步可追溯）。这套"手动协调"哲学一开始被吐槽太薄，但2026年4月15日的0.14更新是一次范式级跃迁：它把**agent harness（执行外壳）与compute（计算/沙箱）彻底切开**，一次接入7家沙箱供应商（E2B、Daytona、Modal等），并引入**model-native harness**和可配置memory。

```python
from agents import Agent, Runner, handoff, input_guardrail
from agents.ext.sandbox import SandboxAgent

triage = Agent(name="分流", instructions="判断问题归属")
billing = Agent(name="计费", tools=[lookup_invoice], 
                handoffs=[escalate_human])

@input_guardrail
async def block_pii(ctx, agent, input):
    return GuardrailFunctionOutput(
        output_info={"scanned": True},
        tripwire_triggered=detect_pii(input))

# v2: 子代理跑在隔离沙箱，apply_patch+shell可安全编辑文件/跑测试
sandbox_agent = SandboxAgent(
    name="代码工", model="gpt-5.5-codex",
    sandbox_provider=E2B(),   # harness与算力解耦，换provider不改业务
    tools=[apply_patch, shell])
```

它最大的认知反转是：**交接（handoff）是显式的、由模型决定的，而不是框架自动路由的**。这避免了"自动编排"带来的级联失控与烧钱，每一步控制权流转都有据可查。Guardrail在交接边界做校验，等于把安全检查放到了最危险的"换手瞬间"。缺点是沙箱配置陡峭，初学者会被7家provider的选型劝退；强绑定OpenAI模型。**变现评估**：生态最大、文档最全、社区案例最多，是做训练营最安全的牌——能交付一条"从分流到沙箱执行"的完整生产链路，企业B端接受度最高。

### 三、Google ADK：全功能平台的session/state/callback三件套

Google在2025年底开源的Agent Development Kit（ADK）走的是另一条路：不做薄壳，做**全功能代码优先平台**。它的核心抽象不是loop，而是**session.state**——一个贯穿多轮对话的键值字典，agent通过读写它来维持状态、做个性化、跨轮记忆。配合**callbacks（回调）**系统：before_agent / after_agent、before_tool / after_tool、before_model / after_model三对回调，几乎可以在执行流的任何节点注入"观察、定制、控制"逻辑。

```python
from google.adk.agents import LlmAgent
from google.adk.sessions import InMemorySessionService
from google.adk.tools import FunctionTool

def fetch_account(user_id: str) -> dict:
    """读取用户账户，结果自动写入session.state"""
    return {"tier": "gold"}

agent = LlmAgent(
    name="客服",
    model="gemini-2.5-pro",
    tools=[FunctionTool(fetch_account)],
    before_model_callback=redact_sensitive,   # 进模型前脱敏
    after_tool_callback=audit_log,            # 工具执行后审计
)

# 长任务可pause/resume，状态持久化在Vertex Agent Engine
# 适合"永不丢上下文"的常驻agent
```

ADK的另一大卖点是**长时运行agent**：可以pause、resume、跨进程不丢上下文，背后是Vertex AI Agent Engine的状态持久化。这对需要"挂机等待人工/外部事件再继续"的常驻agent是刚需。但代价是**概念密度高**——session、state、callbacks、artifacts、memory、transfers一堆名词，学习曲线陡峭；且深度绑定Gemini与Google Cloud，离开Vertex能力打折。**变现评估**：适合做"有状态常驻agent"专题课（如私人助理、长周期研究agent），云绑定反而是企业客户的安全感来源。

### 四、PydanticAI：模型无关的类型安全极简派

PydanticAI是Pydantic团队（Samuel Colvin等）的作品，定位和前几家截然相反：**不卖运行时，卖类型安全**。它用Pydantic的校验能力，让你用Python类型注解直接定义结构化输出，依赖注入（dependency injection）让工具的可测试性极高。它是真正意义上的"模型无关"——OpenAI、Anthropic、Gemini、Ollama、Groq一行代码切换。

```python
from pydantic_ai import Agent, RunContext
from dataclasses import dataclass

@dataclass
class Deps:
    db: Database
    user_id: str

agent = Agent(
    "anthropic:claude-sonnet-4-6",   # 一行换模型
    deps_type=Deps,
    result_type=OrderSummary,        # 输出强类型校验，错误自动重试
    system_prompt="根据用户历史下单。")

@agent.tool
async def lookup_history(ctx: RunContext[Deps], limit: int) -> list:
    return await ctx.deps.db.history(ctx.deps.user_id, limit)

result = await agent.run("最近买了啥", deps=Deps(db, "u123"))
print(result.data)  # 已是OrderSummary实例，非裸字符串
```

它的价值在于**把LLM输出从"祈祷JSON正确"变成"编译期可验证"**——result_type校验失败会自动重试带反馈，结构化输出的可靠性碾压手写解析。依赖注入让工具能mock、能单测，工程化水准最高。缺点是没有内置运行时——没有沙箱、没有内置Bash/文件工具、没有现成的agent loop重武器，做"能跑代码改文件"的自主agent要自己搭。**变现评估**：偏极客/后端工程师受众，适合做"LLM工程化最佳实践""结构化输出可靠性"方向的技术课，不适合做炫酷产品demo课。

### 五、Microsoft Agent Framework：Build 2026押注CodeAct+MXC

Microsoft在Build 2026明确表态"要拥有agent执行层"，其Agent Framework（AutoGen的继任者）主打**Threads（线程状态）+ Tools + CodeAct（代码即动作）**，搭配**MXC托管沙箱**。CodeAct的理念是让agent直接生成并执行代码来解决问题，而不是只调函数工具——这与OpenAI的apply_patch+shell思路殊途同归，都是把"代码执行"作为一等公民。

```csharp
// .NET 调用 CodeAct agent
var agent = new CodeActAgent(
    name: "数据分析师",
    kernel: kernel,            // 任意模型，Semantic Kernel内核
    codeInterpreter: new MxcSandbox());
var thread = new AgentThread();
await foreach (var resp in agent.InvokeAsync("清洗这份CSV并画图", thread))
    Console.WriteLine(resp.Message);
```

它强在企业集成（Azure、Microsoft 365、Semantic Kernel生态）、强在.NET一等公民支持，对微软技术栈团队是顺理成章的选择。缺点是概念偏企业化（Threads/Plugins/Azure绑定重），社区热度与文档丰富度暂时不如OpenAI/Claude阵营。**变现评估**：适合做"企业级Agent + 微软生态"方向的B端交付课，在金融、政府等微软存量市场有天然客户。

### 六、harness与算力解耦：2026真正的定盘维度

把五家放在一起，2026最该看清的不是"谁的原语更优雅"，而是**harness（执行外壳）与compute（算力/沙箱）的解耦程度**。OpenAI 0.14把它做成了显式产品特性——7家沙箱供应商可插拔，harness不变；Claude Agent SDK用permission_mode三态（default/acceptEdits/bypassPermissions）+ hooks把"能不能执行"做成可编程闸门；Google靠Vertex Agent Engine把状态/执行托管到云；Microsoft用MXC做托管沙箱。这条线的工程含义是：**未来选型的核心问题从"用哪个框架"变成了"harness能不能跨沙箱/跨模型复用，会不会被锁死"**。

```mermaid
flowchart TB
    U[用户任务] --> H{Agent Harness 执行外壳}
    H -->|Claude SDK| CL[agentic loop + hooks + 内置工具]
    H -->|OpenAI SDK 0.14| OA[Handoff/Guardrail + 可插拔沙箱]
    H -->|Google ADK| AD[session.state + callbacks]
    H -->|PydanticAI| PA[类型安全 + 依赖注入]
    H -->|MS Framework| MS[Threads + CodeAct]

    CL & OA & AD & MS --> C{Compute 算力/沙箱层}
    PA -.无沙箱,自带.-> EXT[外部执行: 你负责]

    C --> S1[E2B]
    C --> S2[Daytona]
    C --> S3[Modal]
    C --> S4[Vertex Engine]
    C --> S5[MXC]
    C --> S6[本地Shell]

    S1 & S2 & S3 & S4 & S5 & S6 --> M[模型层<br/>Claude/GPT/Gemini/本地]

    style H fill:#ffd479
    style C fill:#9ad7ff
    style M fill:#c3e6cb
```

### 七、护栏与可观测性：谁把"换手瞬间"守住了

生产级agent的死法八成在边界：agent A交接给agent B的瞬间、工具执行前的瞬间、模型输出后的瞬间。三家官方SDK在这个维度分化明显。**OpenAI的Guardrail**把校验钉死在交接边界（input_guardrail在agent入口、output_guardrail在结果出口），设计哲学最干净；**Google ADK的callbacks**粒度最细（before/after model/tool/agent全覆盖），灵活但易被滥用成"万物皆hook"的意大利面；**Claude Agent SDK的hooks**介于两者之间，更偏"工具调用生命周期"的中间件。可观测性方面，OpenAI Tracing、Claude的遥测、ADK的执行日志+性能指标各有体系。**变现评估**：这是一个被严重低估的课目方向——"Agent护栏工程""交接边界安全"是每个生产团队的真痛点，能做成交付级训练营。

## 推荐方案：按场景定盘

| 你的场景 | 首选 | 理由 |
|----------|------|------|
| 自主编程/自动化运维agent | Claude Agent SDK | 自带全栈工具+成熟loop，开箱即跑 |
| 多智能体客服/工单分流 | OpenAI Agents SDK 0.14 | Handoff显式可控+Guardrail守边界 |
| 有状态常驻私人助理 | Google ADK | session.state+pause/resume不掉线 |
| 后端LLM工程化/结构化输出 | PydanticAI | 类型安全+模型无关+可单测 |
| 微软生态企业交付 | Microsoft Agent Framework | Azure/M365原生+MXC沙箱 |
| 要做训练营变现 | OpenAI + Claude双讲 | 生态最大+卖点最强，组合拳最稳 |
| 极致避免锁死 | PydanticAI + 自建沙箱 | 唯一模型无关+执行层自控 |

一句话定盘：**2026选Agent SDK，先问"harness和算力解耦了没有"，再问"换手瞬间谁守得住"，最后才看原语好不好看。** 运行时范式已经迁移，还停留在"编排框架"思维的项目，今年会持续交抽象税。

## 参考来源

1. [OpenAI's Agents SDK Splits the Stack: 7 Sandbox Providers and the End of Compute Lock-in](https://agentmarketcap.ai/blog/2026/04/22/openai-agents-sdk-sandbox-providers-harness-compute-separation) — 详解2026-04-15更新harness与算力解耦、7家沙箱供应商
2. [Claude Agent SDK vs OpenAI Agents SDK vs Google ADK：2026年8大Agent框架深度横评](https://www.holysheep.ai/articles/zh-claude-agent-sdk-vs-openai-agents-sdk-vs-google-ad-2026-04-13-0007.html) — 三大官方SDK生产环境压力测试对比
3. [How the agent loop works — Claude Code Docs](https://code.claude.com/docs/en/agent-sdk/agent-loop) — Claude Agent SDK官方文档，agentic loop执行机制
4. [Building Stateful and Personalized Agents with ADK — Google Codelabs](https://codelabs.developers.google.com/codelabs/agent-memory/instructions) — Google ADK的session/state/callbacks机制
5. [Microsoft Build 2026 Developer Recap: CodeAct, MXC Sandbox, and Hosted Agents](https://chatforest.com/builders-log/microsoft-build-2026-maf-codeact-mxc-sandbox-hosted-agents-developer-recap/) — Microsoft Agent Framework的CodeAct与MXC执行层

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)