把 Agent、LLM 应用与后端工程拆开、读懂、再动手实现。每篇笔记都标注版本与出处。https://tlrince.cn/zh-cnhttps://tlrince.cn/posts/agent-sdk/llm-api-to-agent-harness/https://tlrince.cn/posts/agent-sdk/llm-api-to-agent-harness/在 Agent 领域，“SDK”这个词被用得非常宽泛：openai 包、OpenAI Agents SDK、Claude Agent SDK、Tool Runner、pi、DSH 都被称为 SDK，但它们解决的问题不在同一层。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/基础agenthttps://tlrince.cn/posts/agent-sdk/tool-calling-and-agent-loop/https://tlrince.cn/posts/agent-sdk/tool-calling-and-agent-loop/模型不会执行工具。 一次工具调用至少需要两次模型请求：模型先提出调用，程序执行后把结果送回去，模型再继续生成。 Agent Loop 就是把这个过程放进 while 循环。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/基础agent/tool-callinghttps://tlrince.cn/posts/agent-sdk/openai-ecosystem/https://tlrince.cn/posts/agent-sdk/openai-ecosystem/OpenAI 面向开发者的产品可以分成四层：模型 API → 客户端 SDK → Agents SDK（开源，运行在你这边）→ Agents API（托管的 Codex harness，beta）。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/openaihttps://tlrince.cn/posts/agent-sdk/openai-sdk-responses-api/https://tlrince.cn/posts/agent-sdk/openai-sdk-responses-api/openai 包是 OpenAI REST API 的类型化封装，根据 OpenAPI 规范自动生成，提供同步和异步两种客户端。 Responses API 的核心模型是“输入一组 *item*，输出一组 *item*”。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/openaiapi/responseshttps://tlrince.cn/posts/agent-sdk/openai-agents-sdk/https://tlrince.cn/posts/agent-sdk/openai-agents-sdk/Agents SDK 的设计目标是原语极少：Agent、Agents as tools / Handoffs、Guardrails，在此之上提供 Sessions、Tracing、Sandbox agents 和 Realtime/Voic…Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/openaiagent/frameworkhttps://tlrince.cn/posts/agent-sdk/openai-agents-api/https://tlrince.cn/posts/agent-sdk/openai-agents-api/Agents API 通过一个 OpenAI 托管的 API 提供 Codex harness。会话、编排、上下文压缩、故障恢复都由 OpenAI 负责；你只需要提供工具，并选择执行环境。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/openaiagent/hostedhttps://tlrince.cn/posts/agent-sdk/claude-ecosystem/https://tlrince.cn/posts/agent-sdk/claude-ecosystem/Anthropic 的开发者产品可以分成四层：Claude API（Messages API）→ 客户端 SDK（7 种语言，外加 ant CLI）→ Claude Agent SDK（把 Claude Code 当作库来用）→ Claud…Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/claudehttps://tlrince.cn/posts/agent-sdk/anthropic-sdk-messages-api/https://tlrince.cn/posts/agent-sdk/anthropic-sdk-messages-api/Messages API 是无状态的：每次请求都要带上完整历史。响应内容是一组 content block，类型有 text、thinking、tool_use 等，用 stop_reason 判断模型为什么停下。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/claudeapi/messageshttps://tlrince.cn/posts/agent-sdk/claude-agent-sdk/https://tlrince.cn/posts/agent-sdk/claude-agent-sdk/Claude Agent SDK 就是把 Claude Code 当作一个库来用：它提供与 Claude Code 相同的工具、agent loop 和上下文管理，支持 Python 和 TypeScript。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/claudeagent/harnesshttps://tlrince.cn/posts/agent-sdk/claude-managed-agents/https://tlrince.cn/posts/agent-sdk/claude-managed-agents/Managed Agents 是一个预置、可配置、运行在托管基础设施上的 agent harness。Anthropic 负责运行循环、托管沙箱、保存会话，你通过 REST 接口和 SSE 与它交互。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/claudeagent/hostedhttps://tlrince.cn/posts/agent-sdk/pi-overview/https://tlrince.cn/posts/agent-sdk/pi-overview/pi 是 “一个极简、可扩展、可以让你据为己有的 agent harness”。作者是 libGDX 的作者 Mario Zechner；Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/piagent/harnesshttps://tlrince.cn/posts/agent-sdk/pi-ai/https://tlrince.cn/posts/agent-sdk/pi-ai/pi-ai 是一个统一的 LLM 接口层，用同一套 Context、消息和事件模型对接 OpenAI、Anthropic、Google、DeepSeek、Mistral、xAI、Groq、OpenRouter 等数十家提供方，以及任何兼容 …Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/pillm/multi-providerhttps://tlrince.cn/posts/agent-sdk/pi-agent-core/https://tlrince.cn/posts/agent-sdk/pi-agent-core/pi-agent-core 是一个有状态的 agent，负责工具执行和事件流，构建在 pi-ai 之上。整个包大约 2,500 行，是学习“agent 循环如何工程化”的绝佳材料。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/piagent/loophttps://tlrince.cn/posts/agent-sdk/pi-coding-agent/https://tlrince.cn/posts/agent-sdk/pi-coding-agent/pi-coding-agent 既是交互式 CLI，也是 TypeScript SDK。它在 pi-agent-core 的基础上加入了内置工具、会话持久化、上下文压缩、资源发现，以及扩展运行时。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/piagent/harnesshttps://tlrince.cn/posts/agent-sdk/deepseek-harness-overview/https://tlrince.cn/posts/agent-sdk/deepseek-harness-overview/DSH 是 DeepSeek AI 开发的开源 agent harness，架构核心是“一切皆插件”。它构建在 Cordis 之上，Cordis 的设计思想发表在论文 *A Programming Paradigm for Spatiote…Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/dshagent/harnesshttps://tlrince.cn/posts/agent-sdk/dsh-cordis-plugins/https://tlrince.cn/posts/agent-sdk/dsh-cordis-plugins/Cordis 是一个元框架（meta-framework），只负责插件的加载、卸载和依赖管理。DSH 的每个具体组件都是对等的 Cordis 插件，彼此通过服务和事件协作，在配置层自由组合。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/dsharchitecture/pluginhttps://tlrince.cn/posts/agent-sdk/dsh-core-and-plugins/https://tlrince.cn/posts/agent-sdk/dsh-core-and-plugins/轮次与步骤：一个步骤（step）是一次模型请求，加上它触发的工具调用；一个轮次（turn）包含零个或多个步骤，从领取第一条输入时开始，到不再有待完成的工作时结束。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/dshagent/harnesshttps://tlrince.cn/posts/agent-sdk/same-task-six-ways/https://tlrince.cn/posts/agent-sdk/same-task-six-ways/用同一个任务——“查询北京和上海的天气，并回答问题”，需要一个自定义工具 get_weather(city)——分别用六种方式实现，对比谁在写循环、工具怎么定义、状态放在哪里： | # | 写法 | 所在层 | 语言 | |---|---|…Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/对比https://tlrince.cn/posts/agent-sdk/comparison-and-selection/https://tlrince.cn/posts/agent-sdk/comparison-and-selection/用两个坐标轴给六个产品定位：抽象层级（只提供原语，还是提供完整的 harness）和运行位置（在你的进程里，还是由厂商托管）。Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/对比https://tlrince.cn/posts/agent-sdk/references/https://tlrince.cn/posts/agent-sdk/references/Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/附录https://tlrince.cn/posts/agent-sdk/glossary/https://tlrince.cn/posts/agent-sdk/glossary/Fri, 09 Oct 2026 00:00:00 GMTagent-sdk/附录