如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

自動審查

在智慧體工作階段中設定動作自動審查,讓智慧體能更自主地執行任務。

智慧體執行任務時,自動審查會核准或拒絕其支援的核准要求,運作方式與 ChatGPT 和 Codex 的自動核准功能類似。為智慧體建立工作階段時,請使用 review 欄位設定自動審查。此設定適用於根回合,以及根回合建立的所有子代理程式。

  • 審查動作

    自動核准或拒絕智慧體及其子代理程式提出的受支援要求。

  • 在任務之間變更審查模式

    選擇下一個根回合的審查模式。

  • 保留網路限制

    即使審查通過,環境的對外網路限制仍然適用。

API 資源

  • 工作階段

    /v1/agents/sessions

    設定審查模式並查看待處理的動作。

  • 智慧體

    /v1/agents

    重複使用任務所需的指示和工具。

  • 環境範本

    /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。

使用自動審查執行 npm install
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="Run npm install in /workspace.",
)
print(session.id)

使用傳回的工作階段 id,即可在任務之間變更審查模式。如需瞭解要求欄位,請參閱建立工作階段的 API 參考文件。

你的專案必須具有自動審查功能的使用權。如果專案無法使用這項功能,API 會拒絕啟用要求,並指出受影響的參數為 review。

變更審查模式

請在任務之間更新工作階段的 review 欄位。主線任務必須處於閒置狀態,而且輸入資料的提交作業必須已完成,才能變更模式。下列範例會關閉自動審查。請將 sess_123 替換成先前傳回的工作階段 ID:

關閉自動審查
updated_session = client.beta.agents.sessions.update("sess_123", review="none")
print(updated_session.id)

更新成功時,API 會傳回 200 OK 和更新後的工作階段。執行其他工作階段更新時,請省略 review 以保留目前的設定。如要重新啟用自動審查,請傳送 "review": "auto_review"。如需瞭解要求欄位,請參閱更新工作階段的 API 參考文件。

如果主線任務仍在執行,或輸入資料的提交作業尚未完成,此時要求變更模式,API 會傳回 409 Conflict,而且不會套用該要求中的任何更新。請等到任務閒置且輸入資料提交完畢後再試一次。即使已檢查工作階段狀態,也必須處理 409,因為在更新前仍可能收到新的輸入。任務執行期間可以傳送目前的審查設定值。

擷取工作階段或列出工作階段,即可查看已儲存的 review 值。如果回應省略此欄位,請將其視為 "none"。