OpenAI Agents API 自动审核

2026-11-19 15:38 更新

自动审核可在智能体执行任务期间批准或拒绝受支持的审批请求。创建会话时用 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,因为更新前可能收到新的输入。工作期间可以发送当前已保存的审核值。

可获取会话或列出会话查看保存的 review。若响应省略该字段,按 "none" 处理。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号