在智能体工作期间,自动审查会批准或拒绝属于审查范围的审批请求,类似于 ChatGPT 和 Codex 中的自动审批功能。为智能体创建会话时,可通过 review 字段配置自动审查。该设置适用于根轮次以及这些轮次创建的所有子智能体。
-
审查操作
对于智能体及其子智能体发起的请求,自动批准或拒绝其中属于审查范围的请求。
-
在任务之间更改审查模式
为下一个根轮次选择审查模式。
-
保留网络限制
启用审查后,环境的出站网络限制仍然有效。
-
-
-
环境模板
/v1/agents/environments/templates
-
会话事件
/v1/agents/sessions/{session_id}/events
通过自动审查,智能体也能使用 Codex 执行框架的“代我审批”功能。在会话期间,如果智能体计划执行的操作需要额外权限,就可能触发审批请求。以下操作可能触发审批请求:
- 需要审批的 Shell 命令和终端输入,例如需要提升权限的命令或可能有危险的命令。
- 需要审批的文件更改。
- 申请额外权限,例如扩大文件系统或网络的访问范围。
- 会触发审批的网络访问请求。这类请求仍受环境的网络限制约束。
- 根据审批规则需要确认的 MCP 工具调用。
由 OpenAI 管理的审查模型会结合对话上下文,评估该操作会产生什么效果、存在哪些风险,以及是否符合用户意图。随后,模型会批准或拒绝该请求。
审查消耗的 Token 在智能体的模型用量之外另行计费。
浏览器访问特定源的请求和登录请求仍由您的应用处理。需要用户输入的 MCP 表单和引导用户前往某个 URL 的请求仍沿用现有流程。启用自动审查无需新增审批事件处理程序。有关如何跟踪智能体的进度并查看轮次结果,请参阅事件和条目。
通过设置会话的 review 字段选择审查方式:
| 值 |
行为 |
"auto_review" |
根据操作的风险和用户在对话中给出的指令,自动批准或拒绝属于审查范围的请求。 |
"none" |
不启用自动审查。大多数操作会直接执行,但仍受环境权限和限制的约束。 |
如果省略 review,则默认使用 "none"。恢复会话时,该设置仍然有效。要更改设置,请发送 "auto_review" 或 "none"。此字段不接受 null。将 review 设为 "none" 不会把这些操作发送到您的应用进行人工审批。
如果使用 OpenAI 托管的执行环境,请在创建会话时新建环境。您可以根据环境模板新建环境。通过 environment_id 复用现有托管环境时,不支持自动审查。
如果使用自托管执行环境,请先按照自托管环境设置指南配置环境,并确保满足在您的操作系统上使用沙盒的前提条件,然后再启用自动审查。仅设置 review 不会为环境配置沙盒。
自动审查不会更改环境的网络限制。请通过环境的网络设置配置出站访问。即使批准浏览器访问某个源,这些限制也仍然有效。
创建会话时,将 review 设为 "auto_review"。本示例要求智能体运行 npm install,工作目录为 /workspace。
配置好 API 密钥和 SDK 后,请使用一个现有智能体,并选择一个可提供 Node.js 和示例所需项目的环境模板。该项目必须包含 /workspace/package.json。请将示例中的智能体 ID 和模板 ID 替换为您自己的 ID。
1
2
3
4
5
6
7
8
9
10
11
12
13import 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: "Run npm install in /workspace.",
});
console.log(session.id);
1
2
3
4
5
6
7
8
9
10
11
12
13from 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="Run npm install in /workspace.",
)
print(session.id)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22import (
"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("Run npm install in /workspace.")},
})
if err != nil {
panic(err)
}
fmt.Println(session.ID)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22import 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("Run npm install in /workspace.")
.build());
System.out.println(session.id());
1
2
3
4
5
6
7
8
9
10
11
12
13require "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: "Run npm install in /workspace."
)
puts session.id
1
2
3
4
5
6
7
8
9
10
11
12
13curl --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": "Run npm install in /workspace."
}'
使用返回的会话 id 即可在任务之间更改审查模式。有关请求字段,请参阅创建会话的 API 参考。
您的项目必须具备使用自动审查的权限。如果该功能不可用,API 会拒绝启用请求,并指出受影响的参数是 review。
在两个任务之间更新会话的 review 字段。更改模式前,请确保主任务处于空闲状态,且所有输入提交均已处理完毕。以下示例会关闭自动审查。请将 sess_123 替换为上文返回的会话 ID:
const updatedSession = await client.beta.agents.sessions.update("sess_123", {
review: "none",
});
console.log(updatedSession.id);
updated_session = client.beta.agents.sessions.update("sess_123", review="none")
print(updated_session.id)
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)
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());
updated_session = client.beta.agents.sessions.update("sess_123", review: :none)
puts updated_session.id
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"
}'
更新成功后,API 会返回 200 OK 和更新后的会话。在其他会话更新请求中,省略 review 即可保留当前设置。要重新启用自动审查,请发送 "review": "auto_review"。有关请求字段,请参阅更新会话的 API 参考。
如果主任务仍在运行,或输入提交尚未处理完毕,API 会对更改模式的请求返回 409 Conflict。该请求中的所有更新都不会生效。请等到主任务空闲且输入提交处理完毕后再重试。即使已检查会话状态,也需要处理 409,因为在更新前可能会有新的输入到达。任务运行期间,仍可发送当前的审查模式值。
检索会话或列出会话即可查看已保存的 review 值。如果响应中没有该字段,请将其视为 "none"。