OpenAI Agents API 是什么？公测接口详解

这期讲了什么

• AI 干长活断在三处：越聊越糊（上下文被挤出去）、断在半路重来、一步失败整单停住——这不是模型聪不聪明的事，是没人管记忆、重试和收尾
• Agents API 是什么：OpenAI 把自家跑 Codex 的那套骨架开放成公测接口，官方叫 harness；会话、编排、上下文压缩、出错恢复归 OpenAI，工具和在哪执行归你
• 骨架替你接走的三件难事：定期把干过的活压成摘要腾地方（上下文压缩）、活的档案存着掉线可续跑、一个大活可拆给最多四个帮手同时干
• 托管沙箱的坑：一小时没人用就可能被删且超时改不了；要留的文件必须放指定输出文件夹；装环境一条命令报错就不启动；API key 必须放屋外；关掉事件流任务并不会停
• 费用只列三段：模型按模型价、自带工具按工具价、托管机器按机器价，没有单独编排费；公测期每次调用要手动加 beta 标记

文字稿

AI 干长活为什么断：三处断法

OpenAI 的 Agents API 开了公测。你让 AI 干个长活，它干到中途就忘了前面，你只好从头再讲，换个说法再试，还是断在差不多的位置。我起初也以为是自己的问题，后来才看明白，这类活本身就容易断，这事真不怪你。不少做产品的朋友都在等新模型，等来的偏偏不是模型——它这回拿出来的，是一件平时没人愿意干、又非干不可的活。

我自己也这样。让 AI 照着清单整理文件，前半段很顺，到中间它开始重复做过的动作，提醒一句答应得挺好，接着又绕回去。越聊越糊，是最容易撞上的一种断法：聊得越长，能同时记住的那点地方就越挤，前面说过的只能被后面的挤出去。让它照着一份长文档一步步做也一样，你出去接个电话回来，它停在那儿等你，可你已经忘了说到哪。还有更让人着急的：中间有一步失败，整单活就停在那儿，没人重试也没人换条路。更坑的是它安静下来的时候，你以为活干完了其实没干成——官方文档自己写着，一轮跑完不等于每个工具都成功，得回头看报上来的执行结果。

这三件事摆在一起，都不是模型聪不聪明的事。模型再强，也架不住没人管记忆、没人管重试、没人管收尾。这几样东西模型自己不管，得外头有人替它管。

Agents API 是什么：一副替 AI 管事的骨架

这回放出来的不是新模型。OpenAI 把自家盯着 AI 干活的那套东西开放了，官方名字叫 harness，翻成大白话就是一副替 AI 管事的骨架。OpenAI 自家专门写代码的 AI 叫 Codex，一直在用这套干活，现在把它装成了能直接调用的接口对外放开。分工是这样的：会话、编排、上下文压缩、出错恢复归 OpenAI 管；工具从哪来、在哪儿执行归你管。

这套东西有四个概念，用生活里的说法最省事：干活的工人（你得说清他是谁、带什么工具）、给工人一间屋子（由你决定在哪儿干活）、这单活的档案（它替你存着、也能接着续）、边干边报的进度（做一步往外报一次）。有两样能省不少事：工人的设定可以存下来，下次开新活直接用；调用要用的凭据那把钥匙是单独存放的，跟设定分开放。

公测阶段，骨架已经把几件难事接过去了。越聊越糊那件，它会定期把前面干过的活总结成短的腾出地方，官方叫上下文压缩；断在半路那件，活的档案它替你存着，掉线回来能从中断处接着跑；拆活也省事，一个大活可以拆成小块派给几个帮手同时干，官方示例里写的是最多四个。

沙箱的坑：一小时没动静可能就没了

公测阶段用的是 OpenAI 托管的一个 Linux 工作区，官方叫沙箱，就是一台临时借给你用的机器，常用工具都装好了，干活位置固定在一个工作目录里。这间屋子也可以换成你自己的系统、自己的算力、自己公司的内网。

出网有三种档：默认能出网，也可以完全禁掉，还能只放行你点名的主机——名字得写全，最多一百个，下面带的小站和跳转过去的地方都得一个一个单独写。还有一条得记住：一个小时没人用、里面也没动静，OpenAI 那边就可能把它删掉，官方说这个超时不可配置，你改不了。一小时这个数不小，出去开个会回来屋子可能就没了。要留的东西放在官方指定的输出文件夹里，一轮结束那里的文件会存成一份改不了的副本，屋子过期了还能下载回来。

屋子搭起来之前，装环境要用的东西和输入文件得提前备好：装环境时只要一条命令报错，工人连启动都不启动。官方专门叮嘱过，API key 要放在屋子外面，别塞进屋里。你建好会话只代表开始装了，环境还在装是一个状态、装好了是另一个状态，得自己去查。还有个小坑：把事件流关掉，正在跑的任务并不会停，你这边看不见了，它还在后台接着跑。想动手试，官方给了五种常见编程语言的现成工具包，直接用命令行敲几条命令也能调；钥匙单独申请，权限只给会话读写和模型推理这几项。

费用和判断：值钱的是流程不是模型

钱的事说清楚：官方文档只列三段，模型按模型的价算、自带那几个工具按工具的价算、用它的屋子按机器的价算，没有单独一项编排费。你那活要是偶尔问两句就完，这东西对你就是白搭，它是给要连着跑很久、还得反复重来的活准备的。就算要做这种活它也不是唯一一条路：自己拿开源框架拼一套，省下的是这笔钱、花掉的是自己的时间；用别家同类托管服务也能走通，代价是哪些东西交到对方手里得自己看清楚。它值不值只看一件事：你是不是本来就打算自己写这套流程。

现在调这个接口每次都得手动加一个写着 beta 的标记，用它家现成工具包会自动加，自己直接调就得自己写——这是公测阶段的意思，别当稳定依赖。真正值钱的不是模型，是那套没人愿意写的流程；这副骨架给你省了事，顺手把这类活该怎么跑的标准也定了。今天就能做一件事：把你最近让 AI 干断过的那件活写下来，标出断掉的那一步，那一步才是要管的地方。

常见问题

OpenAI Agents API 是干什么的？

它是 OpenAI 开放的公测接口，不是新模型，而是一副替 AI 管事的骨架（harness）：会话、编排、上下文压缩、出错恢复由 OpenAI 负责，工具和执行环境由你自己提供。Codex 内部一直在用这套东西。

Agents API 托管沙箱有哪些限制？

一小时没人使用且无动静就可能被删除，超时不可配置；要保留的文件须放入指定输出文件夹；装环境时一条命令报错就不启动；API key 必须放在沙箱外；关掉事件流任务仍在后台运行。

Agents API 怎么收费？

官方文档只列三段费用：模型按模型价、自带工具按工具价、托管工作区按机器价，没有单独的编排费。公测阶段每次调用需手动加 beta 标记。