OpenAI Agents API 自动审核
自动审核可在智能体执行任务期间批准或拒绝受支持的审批请求。创建会话时用 review 字段选择审核方式。设置适用于主轮次及其创建的子智能体,也可在任务之间更新。环境原有的出站网络限制仍然生效。
API 资源
| 路径 | 用途 |
|---|---|
/v1/agents/sessions |
设置审核模式、查看待处理操作。 |
/v1/agents |
复用任务指令和工具。 |
/v1/agents/environments/templates |
复用执行环境配置。 |
/v1/agents/sessions/{session_id}/events |
跟踪进度和轮次结果。 |
工作原理
会话中的操作可能要求额外权限,例如需审批的 Shell 命令或终端输入、文件变更、更广的文件系统或网络访问,以及审批规则要求确认的 MCP 工具调用。
由 OpenAI 管理的审核模型会结合对话上下文,判断操作的效果和风险、是否符合用户意图,然后批准或拒绝。审核使用的词元与智能体模型用量分别计费。
浏览器站点访问和登录仍由应用处理。需要填写的 MCP 表单和要求用户打开 URL 的请求沿用现有流程。应用可使用已有的事件处理逻辑。参见事件与数据项。
选择审核模式
review 的值 |
行为 |
|---|---|
"auto_review" |
根据操作风险和对话中的用户指令,自动批准或拒绝受支持的请求。 |
"none" |
关闭自动审核。在环境许可及限制范围内,多数操作直接执行。 |
创建会话时省略 review 默认使用 "none"。恢复会话时保留已存设置。更新只能使用 "auto_review" 或 "none",不接受 null。选择 "none" 不会把原先支持自动审核的操作转交应用实施人工审核。
准备执行环境
使用 OpenAI 托管环境时,创建会话应配置一个新环境,也可使用环境模板。通过 environment_id 复用已存在的托管环境时,自动审核暂不受支持。
使用自托管环境时,先按自托管环境设置和对应操作系统的沙箱要求完成配置。设置 review 不会为环境配置沙箱,也不会改变出站网络设置。浏览器站点审批受相同网络限制约束。
创建启用自动审核的会话
创建会话时将 review 设为 "auto_review"。以下示例让智能体在 /workspace 运行 npm install。参照 Agents API 快速开始配置 API 密钥和 SDK。使用已有智能体及包含 Node.js 的环境模板,并确保项目包含 /workspace/package.json。把示例中的智能体 ID 和模板 ID 替换为实际值。
TypeScript
// 创建使用自动审核的会话
import OpenAI from "openai";
const client = new OpenAI();
const session = await client.beta.agents.sessions.create({
agent_id: "agt_123",
environment: {
type: "openai_hosted",
environment_template_id: "envtmpl_123",
},
review: "auto_review",
input: "在 /workspace 中运行 npm install。",
});
console.log(session.id);
Python
## 创建使用自动审核的会话
from openai import OpenAI
client = OpenAI()
session = client.beta.agents.sessions.create(
agent_id="agt_123",
environment={
"type": "openai_hosted",
"environment_template_id": "envtmpl_123",
},
review="auto_review",
input="在 /workspace 中运行 npm install。",
)
print(session.id)
Go
// 创建使用自动审核的会话
import (
"context"
"fmt"
"github.com/openai/openai-go/v3"
)
client := openai.NewClient()
session, err := client.Beta.Agents.Sessions.New(context.Background(), openai.BetaAgentSessionNewParams{
AgentID: openai.String("agt_123"),
Environment: openai.EnvironmentParamUnion{
OfParamOpenAIHosted: &openai.EnvironmentParamOpenAIHosted{
EnvironmentTemplateID: openai.String("envtmpl_123"),
},
},
Review: openai.BetaAgentSessionNewParamsReviewAutoReview,
Input: openai.BetaAgentSessionNewParamsInputUnion{OfString: openai.String("在 /workspace 中运行 npm install。")},
})
if err != nil {
panic(err)
}
fmt.Println(session.ID)
Java
// 创建使用自动审核的会话
import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.beta.agents.EnvironmentParam;
import com.openai.models.beta.agents.sessions.SessionCreateParams;
OpenAIClient client = OpenAIOkHttpClient.fromEnv();
var session =
client
.beta()
.agents()
.sessions()
.create(
SessionCreateParams.builder()
.agentId("agt_123")
.environment(
EnvironmentParam.OpenAIHosted.builder()
.environmentTemplateId("envtmpl_123")
.build())
.review(SessionCreateParams.Review.AUTO_REVIEW)
.input("在 /workspace 中运行 npm install。")
.build());
System.out.println(session.id());
Ruby
## 创建使用自动审核的会话
require "openai"
client = OpenAI::Client.new
session = client.beta.agents.sessions.create(
agent_id: "agt_123",
environment: {
type: :openai_hosted,
environment_template_id: "envtmpl_123"
},
review: :auto_review,
input: "在 /workspace 中运行 npm install。"
)
puts session.id
cURL
## 创建使用自动审核的会话
curl --fail-with-body https://api.openai.com/v1/agents/sessions \
-H "OpenAI-Beta: agents=v1" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "agt_123",
"environment": {
"type": "openai_hosted",
"environment_template_id": "envtmpl_123"
},
"review": "auto_review",
"input": "在 /workspace 中运行 npm install。"
}'
保存返回的会话 id,供后续任务之间切换审核模式。请求字段见创建会话。
项目须具有自动审核权限。权限不可用时,启用请求会被拒绝,API 会将 review 标为相关参数。
更改审核模式
在任务之间修改会话的 review 字段。更改前,主任务必须空闲,且输入提交已经结束。下面的示例将自动审核关闭。将 sess_123 换成创建会话时返回的 ID。
TypeScript
// 更新会话并关闭自动审核
const updatedSession = await client.beta.agents.sessions.update("sess_123", {
review: "none",
});
console.log(updatedSession.id);
Python
## 更新会话并关闭自动审核
updated_session = client.beta.agents.sessions.update("sess_123", review="none")
print(updated_session.id)
Go
// 更新会话并关闭自动审核
updatedSession, err := client.Beta.Agents.Sessions.Update(context.Background(), "sess_123", openai.BetaAgentSessionUpdateParams{
Review: openai.BetaAgentSessionUpdateParamsReviewNone,
})
if err != nil {
panic(err)
}
fmt.Println(updatedSession.ID)
Java
// 更新会话并关闭自动审核
import com.openai.models.beta.agents.sessions.SessionUpdateParams;
var updatedSession =
client
.beta()
.agents()
.sessions()
.update(
SessionUpdateParams.builder()
.sessionId("sess_123")
.review(SessionUpdateParams.Review.NONE)
.build());
System.out.println(updatedSession.id());
Ruby
## 更新会话并关闭自动审核
updated_session = client.beta.agents.sessions.update("sess_123", review: :none)
puts updated_session.id
cURL
## 更新会话并关闭自动审核
curl --fail-with-body https://api.openai.com/v1/agents/sessions/sess_123 \
-X POST \
-H "OpenAI-Beta: agents=v1" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"review": "none"
}'
更新成功返回 200 OK 和更新后的会话。若会话更新与审核无关,省略 review 即可保留原设置。重新启用时传入 "review": "auto_review"。字段说明见更新会话。
若主任务仍在执行或输入尚未提交完毕,切换请求会返回 409 Conflict,同一请求中的其他更改也不会生效。等任务空闲且输入提交结束后重试。即使先查过状态,仍应处理 409,因为更新前可能收到新的输入。工作期间可以发送当前已保存的审核值。

TRAE-AI编程


更多建议: