從寫程式碼,到創作下一幕

探索 字節跳動 - 火山方舟 的 AI 程式設計與影片創作活動。

Agent Plan & Coding Plan

一站體驗多款熱門模型,為 AI 程式設計與智能體開發提供更多選擇。新使用者可聯絡(微信: goo_lvyouyou)免費體驗 9.9 agent plan。

Seedance 2.5

讓創意,躍然成片。探索 30 秒影片、多模態參考與局部編輯,把腦海中的畫面變成下一支作品。

繁體中文

Agent Security

管理 ChatGPT Work 和 Codex 的全域策略及環境設定

使用管理控制台中的 Agent Security 管理策略和設定。它取代了 Policies & Configuration。其推出進度獨立於 Work 和 dots 的本機電腦存取功能。

符合條件的舊版雲端策略遷移時,其設定會轉入全域,並保留策略分配和排序。請在 Agent Security 中審查遷移後的策略。Work 和 dots 的本機電腦存取需要分別選擇啟用。

設定的適用範圍

每項策略都以全域 基準設定為起點。環境覆蓋設定會更改本機 或 Codex 雲端 支援的執行設定。如果某個環境沒有覆蓋設定,則會繼承該策略中適用的全域 設定。

  • 全域:設定編排器控制項,包括核准和網頁搜尋,以及共享執行設定。

  • 本機:調整在已連線電腦上執行的工作所支援的執行設定。

  • Codex 雲端:調整 Codex 雲端任務所支援的執行設定。你可以在啟用 Codex 雲端 之前設定這些策略,但它們只有在權限頁面啟用 Codex 雲端 後才會生效。Work Cloud 有單獨的能力權限,詳見 Agent Security 如何適用於 Work Cloud。

設定基準並新增環境設定

  1. 開啟 Agent Security,審查現有的全域策略、分配和排序。檢查它們是否符合組織預期的控制要求。此審查不會啟用“透過 Work Cloud 存取本機電腦”。

  2. 分別審查要求和預設值。要求設定使用者無法覆蓋的限制。預設值設定這些限制範圍內的初始值。

  3. 將編排器控制項保留在全域 中。這些控制項包括核准要求、允許的網頁搜尋模式以及受管工具控制項。

  4. 為受支援的執行控制項新增本機 或 Codex 雲端 環境設定,例如沙箱、檔案系統權限和受管執行網路。需要限定到特定作業系統時,使用作業系統專用的覆蓋設定。

  5. 儲存策略,並檢視針對所輸入設定的任何驗證訊息。

選擇控制項和設定欄位

編排器負責協調任務。執行器是執行步驟的電腦或雲端容器。在全域 中設定編排器控制項。環境 requirements.toml 設定僅支援執行控制項。核准策略和網頁搜尋等編排器設定保留在全域 中,無法由環境覆蓋。

編排器控制項

在全域 中設定這些控制項。對於具有本機存取權限的 Work 和 dots,啟用受管策略後,受支援的全域策略會透過共享雲端編排器生效。環境覆蓋設定適用於受支援的執行設定,無法覆蓋編排器控制項。在下列核准、網頁搜尋、應用、MCP、外掛和規則要求中,只有允許的核准策略 和允許的網頁搜尋模式 在 Agent Security UI 中有專用控制項。其他欄位透過 TOML 設定。

控制項 控制內容 requirements.toml 欄位
核准策略和審查 智能體何時需要核准,以及由誰審查,包括自動審查。 allowed_approval_policies
allowed_approvals_reviewers
auto_review
guardian_policy_config
網頁搜尋模式 智能體可以使用哪些網頁搜尋模式。 allowed_web_search_modes
應用、MCP server 和 plugins 可用的應用、MCP server 和外掛,以及它們的設定。 apps
mcp_servers
plugins
命令 rules 智能體可以執行哪些命令、哪些需要核准,以及哪些不能執行。 rules
受管 hooks 管理員為受支援的任務和工具事件定義的操作。 hooks
allow_managed_hooks_only

透過 Work Cloud 存取本機電腦時的鉤子

在 全域 中,使用以 TOML 編輯,為具有本機電腦存取權限的 Work 和 dots 設定 mcp_tool 處理程序。在依賴鉤子阻止工具執行之前,請測試回呼失敗和明確拒絕這兩種情況。有關支援的處理程序和事件,請參閱雲端編排中的鉤子。

全域還包含桌面端和用戶端設定。其中一些設定僅適用於桌面端應用。在全域 中設定某項設定並不意味著它適用於所有位置。請參閱設定參考,瞭解各欄位支援的用途。

執行控制項(執行器)

這些欄位控制工作如何在電腦或雲端容器中執行。在全域 中設定共享值。對於需要在某個環境中採用不同值的受支援設定,使用本機 或 Codex 雲端 覆蓋設定。

控制項 控制內容 requirements.toml 欄位
登入 shell 的使用 shell 工具是否可以啟動登入 shell。 allow_login_shell
允許的沙箱模式 執行器可以使用哪些沙箱模式。 allowed_sandbox_modes
權限設定檔和預設值 允許的權限設定檔、它們的存取限制以及預設設定檔。 allowed_permission_profiles
default_permissions
permissions
遠端沙箱設定 按主機名選擇的主機專用沙箱模式。 remote_sandbox_config
受管執行網路 受管網路存取,包括允許和拒絕的目標。 experimental_network
Windows 執行設定 Windows 上特定於平台的執行和沙箱設定。 windows

該表展示了哪些欄位組支援環境覆蓋設定。每組中受支援的選項可能因平台而異,部分要求會跨策略合併,而非相互替換。請參閱設定參考瞭解受支援的值,並參閱受管設定瞭解網路例外。

在受支援的託管 Codex 雲端 執行路徑中,在 Agent Security 中允許某個域名無法覆蓋環境限制。經核准的完整沙箱權限提升可以繞過受管命令代理。有關代理的覆蓋範圍,請參閱網路隔離。

在 UI 中設定網路

  1. 開啟管理控制台 > Agent Security。選擇一項策略,然後選擇 全域(Global)、本機(Local) 或 Codex 雲端。使用全域 設定共享基準,使用環境覆蓋設定設定受支援的差異。
  2. 開啟要求 並開啟管理網路。新增所需的域名條目,並為每項選擇允許 或拒絕。如果普通使用者設定和逐域名核准不得擴充受管代理允許清單,請開啟僅允許管理員新增的域名。
  3. 儲存前審查實際生效的設定和繼承的規則。空的環境設定會繼承全域,而不是清除它。對於 Codex 雲端,單獨檢查本機/私有網路連通性。關閉“管理網路”並不等於關閉 Cloud 環境的“網際網路存取”開關。
  4. 對於 Codex 雲端,還應檢查環境的網際網路存取、目標和請求方法設定。儲存後,分別測試一個預期允許的請求和一個預期阻止的請求。單獨測試任何允許的完全沙箱權限提升。

沒有實際允許的目標

當管理網路 和僅允許管理員新增的域名 均開啟時,普通受管命令需要有實際允許的目標。如果未設定或繼承任何允許條目,這些命令就沒有允許的目標。僅包含拒絕規則的策略不會隱式允許存取網際網路的其他部分。儲存前請新增所需的允許條目,並檢查繼承的規則。此限制適用於受管命令代理,不適用於所有工具或已核准的完全沙箱權限提升。

Codex 雲端本機/私有網路連通性

本機/私有網路連通性明確設為關閉時,可能導致 Codex 雲端 無法連線其上游代理,即使目標域名已被允許。檢查最終的 allow_local_binding 值,並確定該值由哪項策略或設定提供。在受支援的 Cloud 代理路徑上,僅當沒有適用的要求、所選網路設定檔或代理功能設定提供值時,此項才預設為 true。繼承的 false 仍算作顯式設定。在支援的情況下,設定更高優先順序的 Cloud 覆蓋值,為 Codex 雲端 更改此值,而不更改本機 使用的全域 值。這不會新增域名允許條目。依賴覆蓋設定前,請確認執行器支援它。不要將此 Cloud 預設值應用於本機。

環境預設值

預設值編輯器使用 config.toml 欄位,與 requirements.toml 約束不同。受支援的頂層環境預設值包括:

  • Shell 行為:allow_login_shell 和 shell_environment_policy。

  • 沙箱和權限:sandbox_mode、sandbox_workspace_write、default_permissions 和 permissions。

  • Windows 執行:windows。

預設值不會覆蓋強制執行的要求。將編排器預設值保留在全域 中,包括核准和網頁搜尋設定。

瞭解策略如何組合

  • 跨策略時,優先順序較高的策略優先於優先順序較低的策略,即使較低優先順序的策略更具體。

  • 在同一策略內,受支援的執行設定按以下順序解析:作業系統專用的環境覆蓋設定、適用於所有作業系統的環境覆蓋設定,然後是全域。

  • 對於本機執行,MDM 和舊版受管裝置要求的優先順序高於 Agent Security。裝置的系統要求檔案的優先順序低於 Agent Security。

對於同一策略中的相同域名規則,管理員的環境覆蓋設定可以允許全域 中拒絕的域名,也可以拒絕全域 中允許的域名。沒有環境覆蓋設定時,會繼承全域 規則。其他生效的拒絕規則或存取控制仍可能阻止請求。

上述結果比較的是同一策略中的相同域名鍵,且沒有更高優先順序的策略改變結果。更高優先順序的值會替換相同的鍵。其他繼承的鍵會保留。允許規則不會繞過另一條匹配的拒絕規則,例如繼承的萬用字元規則。空的環境對映不會清除繼承的規則。

Agent Security 如何適用於 Work Cloud

在管理控制台 > 權限與角色 > 工作區能力 > 雲端電腦能力 下設定雲端瀏覽器使用 和雲端網路存取。這些共享能力可供 Work Cloud 和 dots 使用,並且可以獨立於 Work Cloud 存取權限進行設定。Work 任務仍需要 Work 存取權限,以及使用每項所需能力的權限。請分別審查瀏覽器存取以及程式碼或 shell 的網路存取。停用其中一項不會自動停用另一項。

Work Cloud 容器和 dots 雲端電腦使用自身的執行設定和要求,而不是其他執行器類型使用的受管環境設定套件。本機檔案和網路限制不會自動適用於這些雲端電腦。受支援的全域 編排器策略具有獨立的適用範圍。全域策略或 Codex 雲端 覆蓋設定不會設定共享雲端能力權限。請單獨審查這些權限。

驗證成員實際生效的存取權限時,檢查工作區預設值、所有直接分配和透過群組分配的角色,以及 Lockdown Mode 等單獨強制執行的限制。

在 Work Cloud 下啟用允許存取本機電腦 之前,請審查全域 基準設定,並檢查其與組織所依賴控制項的相容性。在 ChatGPT 桌面端應用上本機使用 Codex 不是前提條件。如果任何雲端策略啟用了 enforce_residency,Work 和 dots 的允許存取本機電腦 都會被停用。此防護措施不會設定工作區資料駐留位置,也不會單憑自身停用 Work Cloud 或 dots。請參閱 Work Cloud 和 dots 的本機電腦存取,瞭解各自的設定步驟、資格要求和連線行為。

策略 API 和 Terraform

使用策略 API 管理全域 設定。要管理本機 或 Codex 雲端 設定,請使用 Agent Security UI。遷移後,現有全域 API 工作流程仍然可用。請測試指令碼和 Terraform 整合,並確認策略分配和排序保持不變。

策略遷移不會更改 SCIM 成員同步或 RBAC 角色。

相關指南