01
Agent SDK
从 LLM API 到托管 Agent：OpenAI、Claude、pi、DeepSeek Harness 四类 SDK 的分层、原理与选型。
21 篇5.5 万 字约 5 小时 47 分钟资料截至 2026-10-09
进入专栏 →02 · OpenAI
03 · Claude
06 · 对比
Tlrince Notes · 学习笔记把 Agent 拆开，
把 Agent 拆开，
看清每一圈循环。
把 Agent、LLM 应用与后端工程拆开、读懂、再动手实现。每篇笔记都标注版本与出处。
- 笔记
- 21
- 专栏
- 1
- 字数
- 5.5 万
- 最近更新
- 2026-10-09
专栏
全部专栏 →最近更新
归档 →- 1.1从 LLM API 到 Agent Harness 的分层在 Agent 领域，“SDK”这个词被用得非常宽泛：openai 包、OpenAI Agents SDK、Claude Agent SDK、Tool Runner、pi、DSH 都被称为 SDK，但它们解决的问题不在同一层。
- 1.2Tool Calling 与 Agent Loop 原理模型不会执行工具。 一次工具调用至少需要两次模型请求：模型先提出调用，程序执行后把结果送回去，模型再继续生成。 Agent Loop 就是把这个过程放进 while 循环。
- 2.1OpenAI 开发者生态全景OpenAI 面向开发者的产品可以分成四层：模型 API → 客户端 SDK → Agents SDK（开源，运行在你这边）→ Agents API（托管的 Codex harness，beta）。
- 2.2OpenAI 客户端 SDK 与 Responses APIopenai 包是 OpenAI REST API 的类型化封装，根据 OpenAPI 规范自动生成，提供同步和异步两种客户端。 Responses API 的核心模型是“输入一组 *item*，输出一组 *item*”。
- 2.3OpenAI Agents SDKAgents SDK 的设计目标是原语极少：Agent、Agents as tools / Handoffs、Guardrails，在此之上提供 Sessions、Tracing、Sandbox agents 和 Realtime/Voic…
- 2.4OpenAI Agents APIAgents API 通过一个 OpenAI 托管的 API 提供 Codex harness。会话、编排、上下文压缩、故障恢复都由 OpenAI 负责；你只需要提供工具，并选择执行环境。
- 3.1Claude 开发者生态全景Anthropic 的开发者产品可以分成四层：Claude API（Messages API）→ 客户端 SDK（7 种语言，外加 ant CLI）→ Claude Agent SDK（把 Claude Code 当作库来用）→ Claud…
- 3.2Anthropic 客户端 SDK 与 Messages APIMessages API 是无状态的：每次请求都要带上完整历史。响应内容是一组 content block，类型有 text、thinking、tool_use 等，用 stop_reason 判断模型为什么停下。