归档
全部笔记，按最近更新时间排列。
21篇5.4 万字
2026 年 10 月21 篇
- 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 判断模型为什么停下。
- 3.3Claude Agent SDKClaude Agent SDK 就是把 Claude Code 当作一个库来用：它提供与 Claude Code 相同的工具、agent loop 和上下文管理，支持 Python 和 TypeScript。
- 3.4Claude Managed AgentsManaged Agents 是一个预置、可配置、运行在托管基础设施上的 agent harness。Anthropic 负责运行循环、托管沙箱、保存会话，你通过 REST 接口和 SSE 与它交互。
- 4.1pi 全景与设计哲学pi 是 “一个极简、可扩展、可以让你据为己有的 agent harness”。作者是 libGDX 的作者 Mario Zechner；
- 4.2pi-ai 统一多模型 APIpi-ai 是一个统一的 LLM 接口层，用同一套 Context、消息和事件模型对接 OpenAI、Anthropic、Google、DeepSeek、Mistral、xAI、Groq、OpenRouter 等数十家提供方，以及任何兼容 …
- 4.3pi-agent-core 最小 Agent 运行时pi-agent-core 是一个有状态的 agent，负责工具执行和事件流，构建在 pi-ai 之上。整个包大约 2,500 行，是学习“agent 循环如何工程化”的绝佳材料。
- 4.4pi-coding-agent SDK 与扩展系统pi-coding-agent 既是交互式 CLI，也是 TypeScript SDK。它在 pi-agent-core 的基础上加入了内置工具、会话持久化、上下文压缩、资源发现，以及扩展运行时。
- 5.1DeepSeek Harness 全景DSH 是 DeepSeek AI 开发的开源 agent harness，架构核心是“一切皆插件”。它构建在 Cordis 之上，Cordis 的设计思想发表在论文 *A Programming Paradigm for Spatiote…
- 5.2Cordis 与一切皆插件Cordis 是一个元框架（meta-framework），只负责插件的加载、卸载和依赖管理。DSH 的每个具体组件都是对等的 Cordis 插件，彼此通过服务和事件协作，在配置层自由组合。
- 5.3DSH 核心机制与插件开发轮次与步骤：一个步骤（step）是一次模型请求，加上它触发的工具调用；一个轮次（turn）包含零个或多个步骤，从领取第一条输入时开始，到不再有待完成的工作时结束。
- 6.1同一个任务的六种写法用同一个任务——“查询北京和上海的天气，并回答问题”，需要一个自定义工具 get_weather(city)——分别用六种方式实现，对比谁在写循环、工具怎么定义、状态放在哪里： | # | 写法 | 所在层 | 语言 | |---|---|…
- 6.2横向对比与选型建议用两个坐标轴给六个产品定位：抽象层级（只提供原语，还是提供完整的 harness）和运行位置（在你的进程里，还是由厂商托管）。
- 参考资料
- 术语表