智慧體執行任務時,自動審查會核准或拒絕其支援的核准要求,運作方式與 ChatGPT 和 Codex 的自動核准功能類似。為智慧體建立工作階段時,請使用 review 欄位設定自動審查。此設定適用於根回合,以及根回合建立的所有子代理程式。
-
審查動作
自動核准或拒絕智慧體及其子代理程式提出的受支援要求。
-
在任務之間變更審查模式
選擇下一個根回合的審查模式。
-
保留網路限制
即使審查通過,環境的對外網路限制仍然適用。
-
-
-
環境範本
/v1/agents/environments/templates
-
工作階段事件
/v1/agents/sessions/{session_id}/events
透過自動審查,智慧體也能使用 Codex 任務執行框架的「代我核准」功能。在工作階段中,如果智慧體準備執行的動作需要額外權限,就可能觸發核准要求。例如:
- 執行需要核准的 Shell 指令或向終端傳送需要核准的輸入,例如要求提升權限或執行可能有危險的指令。
- 對檔案進行需要核准的變更。
- 要求額外權限,例如更廣泛的檔案系統或網路存取權。
- 提出會觸發核准流程的網路存取要求。這類要求仍受環境的網路限制約束。
- 呼叫依核准規則須先取得確認的 MCP 工具。
由 OpenAI 管理的審查模型會根據對話上下文,評估該動作會執行哪些操作、可能帶來哪些風險,以及是否符合使用者的意圖。模型接著會核准或拒絕該要求。
除了智慧體的模型用量外,審查所用的 Token 也會另外計費。
瀏覽器的來源存取要求和登入要求仍由你的應用程式處理。需要使用者輸入的 MCP 表單,以及引導使用者前往特定網址的要求,都會沿用既有流程。啟用自動審查無須新增核准事件處理常式。如要追蹤智慧體的進度並查看回合結果,請參閱事件與項目。
設定工作階段的 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"。