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

雲端環境

為 Codex 雲端任務建立、設定及共用可重複使用的環境

Codex 雲端會在雲端執行程式設計任務,即使電腦進入睡眠狀態,任務也能繼續執行。你可以透過網頁版、行動版或桌面應用程式編輯程式碼、執行指令及檢查結果。

每個雲端任務都在各自的工作區中執行。如果預設環境可用,你可以直接啟動任務,無須先選擇程式碼庫。若要讓多個任務重複使用同一套設定,請選取建立環境,選擇任務所需的程式碼庫、相依套件、工具及存取設定,然後發布環境。

如需入門介紹,請參閱 Codex 雲端概觀。

Codex 雲端(舊版) 仍支援程式碼審查,以及 Linear 和 GitHub 整合。我們計劃棄用舊版。如需為這些工作流程建立及管理環境,請參閱舊版指南。

在 Codex 雲端啟動任務

在網頁版或桌面應用程式中,選擇工作位置 > 雲端。在行動版中,開啟 Codex。如果環境選擇器中顯示預設環境,請選取該環境並描述任務。

  • 沒有專案時,你可以在沒有程式碼庫的情況下啟動任務。例如,你可以請 Codex 使用範例資料撰寫及測試指令碼。如果任務後來需要使用現有程式碼,請告訴 Codex 要複製哪個程式碼庫。
  • 從桌面應用程式中的專案啟動任務時,如果與專案關聯的程式碼庫託管在 GitHub.com 上,而且你已連結 GitHub 帳戶,預設環境就能自動使用這些程式碼庫。這項專案自動設定功能不適用於 GitLab 程式碼庫。

除了專案自動設定,你也可以在任務執行期間新增程式碼庫。即使是在行動版上啟動的任務,你也可以請 Codex 複製環境有權存取的程式碼庫。若要透過程式碼庫選擇器簽出 GitLab.com 程式碼庫,請在網頁版或桌面應用程式中建立可重複使用的環境。

若要使用自己已準備好的設定,或其他人與你共用的設定,請選取對應的已發布環境。在 Enterprise 工作區中,請使用你有權存取的已發布環境。管理員可以檢查工作區的存取權。

建立及發布環境

若要在多個任務中重複使用相同的程式碼庫、工具或存取設定,你可以在網頁版或桌面應用程式中建立可重複使用的環境。請先使用 ChatGPT 帳戶登入,再依照下列步驟操作:

  1. 在新任務中,選擇工作位置 > 雲端,開啟選取環境,然後選取建立環境。
  2. 選取要簽出的程式碼庫。如果系統提示你連線至 GitHub,請依提示操作。如果程式碼庫選擇器中有 GitLab 選項,請選取你的 GitLab.com 連線,然後搜尋程式碼庫。
  3. 選取開始使用。Codex 會檢查程式碼庫、安裝相依套件和工具,並測試工作流程。
  4. 依提示授予所需的存取權或補充資訊。你也可以要求 Codex 使用特定版本、指令或服務。
  5. 檢查設定報告、組態及檔案。完成待辦事項、儲存變更,然後選取發布。
  6. 畫面顯示環境已發布後,選取啟動新任務,並描述你想請 Codex 完成的工作。

你也可以前往設定 > Codex 雲端 > 環境 > 建立環境開始設定。

儲存會保留組態,其中部分設定會立即套用至目前正在準備的環境。發布會擷取準備好的檔案系統,供新任務使用。共用設定則決定誰可以使用環境。

自訂安裝及啟動流程

Codex 會從程式碼庫辨識所需的執行階段、套件版本、工具和服務。你可以在對話中調整設定,無須自行撰寫安裝指令碼。

Codex 可以將測試過的設定記錄在兩個欄位中:

  • 安裝指令碼: 用來安裝相依套件及準備開發所需資源的指令。
  • 啟動技能: 說明如何啟動服務並確認服務已就緒。

重複使用及更新已儲存的狀態

  • 已發布環境中的新任務: 從該環境已準備好的檔案系統開始執行。
  • 既有任務: 繼續使用任務本身儲存的檔案,包括尚未提交的變更和已安裝的工具。
  • 程式碼庫更新: 會在背景自動執行,保留相依套件的快取,無須重新執行安裝或啟動指令。

若要更新可重複使用的設定,請開啟設定 > Codex 雲端 > 環境。從環境的 … 選單中選取編輯。描述要變更的內容,讓 Codex 準備並測試,然後儲存變更並選取重新發布。啟動新任務即可使用更新後的設定,既有任務會保留各自的狀態。

請提交重要變更,或儲存需要的輸出。儲存任務狀態不能取代版本控制。

設定環境變數及網路密鑰

Codex 會找出缺少的設定,並請你提供它無法推斷的值。在環境組態中,選取管理(位於環境變數或 HTTP 密鑰旁)。依用途選擇提供各個值的方式:

設定 用途 傳遞方式
環境變數 程式必須直接讀取的值 直接傳給環境中的程式。
網路密鑰 傳送至特定 HTTPS 服務的憑證 程式會收到預留位置。當請求送往允許的目的地時,Proxy 會將預留位置替換為實際值。

對於網路密鑰,請設定索引鍵、值及允許的網域。索引鍵不可與任何直接傳給程式的環境變數同名。在設定環境及執行任務期間,透過連接埠 443 傳送 HTTPS 請求時都可以替換密鑰。原始憑證不會寫入本機程序或檔案。

儲存屬於環境的網路密鑰時,系統會將其目的地加入受限網際網路存取的允許清單。直接傳給程式的環境變數及個人值都不會新增目的地。測試前請檢查已儲存的網路政策。如需瞭解工作區的要求,請參閱智慧體安全性。

提供個人值

你可以使用個人保管庫儲存自己的環境變數及網路密鑰,供工作區中的雲端環境使用。

共用環境可以要求每個人透過自己的帳戶提供所需的值。共用環境時,其他人會看到需要提供哪些值,但無法取得你的個人憑證。

系統提示時,請在新增個人密鑰中輸入必要的值,然後選取儲存並啟動。選填的值可以留空。

若要事先管理這些值:

  1. 開啟設定 > Codex 雲端,然後選取個人保管庫分頁。
  2. 選取新增。選擇環境變數或網路密鑰作為類型,然後輸入對應的索引鍵及你要提供的值。
  3. 在適用於下選擇所有環境或選取的環境,然後選取儲存。

任務只會收到環境要求的值。特定環境的值優先於通用預設值。使用個人網路密鑰時,Proxy 也會依照環境允許的目的地,以相同方式替換預留位置。

在 Enterprise 工作區內共用環境

共用準備好的環境,讓同事也能以此環境啟動自己的任務:

  1. 開啟環境組態。
  2. 在隱私 > 誰可以使用下選擇你的工作區。
  3. 儲存變更。如果環境尚未發布,請發布環境。

若要將環境設為私人,請選擇只有我(位於誰可以使用下)。每個任務都有獨立的工作檔案。能夠使用環境並不代表能夠存取其他人的任務或編輯環境。

共用前,請檢查準備好的檔案及屬於環境的憑證。雲端身分及 VPN 連線也能讓使用者共用服務的存取權。程式碼庫的存取權及可用的個人連線則取決於執行任務的帳戶。

在雲端使用 Codex 控制任務的存取權。管理工作區環境決定誰可以建立及編輯與工作區共用的環境。請參閱角色與工作區權限。

智慧體安全性

環境的網際網路存取設定決定虛擬機器可以連線至哪些公用網際網路目的地。VPN 設定則獨立控制這部虛擬機器與私人網路服務之間的連線。

在 Enterprise 工作區中,管理員可以透過智慧體安全性設定工作區對智慧體行為、受管理執行環境的網路連線及支援工具使用方式的要求。這些要求與各環境儲存的網域設定同時生效。如需瞭解全域政策,以及 Codex 雲端支援覆寫哪些設定,請參閱智慧體安全性說明。

連線至服務

請依工作流程的需求,設定套件登錄服務、API 及其他服務的存取權:

  1. 在環境組態中,選擇工作流程所需的公用網際網路存取範圍。若要允許完整存取,請開啟允許存取整個公用網際網路。完整存取已涵蓋套件管理工具和其他網域設定所允許的目的地,因此系統會停用這兩項範圍較窄的控制項。
  2. 若要限制公用網際網路存取,請關閉允許存取整個公用網際網路,然後允許套件管理工具使用的目的地,或在其他允許的網域下新增特定主機。關閉完整存取後,仍可連線至這些允許的目的地。
  3. 儲存設定,並在設定環境期間測試服務。發布或重新發布環境,然後在新任務中確認能否存取服務。

公用網際網路存取與 VPN 存取彼此獨立。你可以擇一使用,也可以同時使用。公用網際網路設定適用於不經 Tailscale 的連線,即使 Tailscale 子網路路由使用公用 IP 位址也是如此。限制公用網際網路存取不會停用已設定的 VPN。

如需瞭解工作區的要求,請參閱智慧體安全性。允許連線至某個目的地並不會提供該服務的憑證或授予服務內的權限。

如果服務接受公用網際網路連線,並依來源 IP 篩選連線,請使用智慧體對外連線 IP 清單。請允許清單中發布的所有位址範圍,每天檢查清單,並在範圍變更時更新服務的允許清單。這些位址範圍由多個客戶共用,因此請保留服務的身分驗證和授權控制措施。

私人網路連線(VPN)

透過 VPN 連線,雲端任務可以存取私人網路上的服務。Tailscale 會使用你設定的私人 DNS、子網路路由及存取規則。對於透過 Tailscale 連線的目的地(包括 HTTP、HTTPS 及其他 TCP 服務),無須另外設定 Codex 的 IP 或網域允許清單。

  1. 在環境組態中,選取 Tailscale 旁的鉛筆圖示。
  2. 輸入 VPN 供應商提供的連線憑證。
  3. 在 Tailscale 中設定必要的路由、DNS 及存取規則,讓環境的 VPN 身分可以連線至預定使用的服務。
  4. 儲存設定,然後發布或重新發布環境。啟動新任務並測試服務。

目前支援的 VPN 供應商為 Tailscale。建立 Tailscale 驗證金鑰時,請同時啟用可重複使用及臨時選項。可重複使用的金鑰能讓新雲端任務的虛擬機器加入你的網路。臨時裝置離線後,Tailscale 會自動移除裝置。我們計劃支援更多 VPN 供應商。

雲端環境支援私人 IPv4 子網路路由。任務可以使用 Tailscale 的分割 DNS 和 MagicDNS,透過主機名稱連線至私人服務。

如果服務使用組織的內部 DNS,請在 Tailscale 管理主控台中設定分割 DNS,將內部網域的查詢送至你的 DNS 伺服器。請使用服務的完整主機名稱,例如 api.corp.example.com。該名稱必須能解析為 IPv4 位址。你設定的 Tailscale 路由必須能到達目的地,Tailscale 存取規則也必須允許連線。

共用環境中的任務會使用該環境設定的 VPN 身分。

連線至 TCP 服務

你可以使用 VPN 連線至資料庫或 SSH 等 TCP 服務。TCP 目的地必須使用經由 Tailscale 路由的 IPv4 位址。如果使用主機名稱,解析出的每個 IPv4 位址都必須經由這些路由。平台仍會封鎖受保護的位址。

TCP 用戶端必須透過環境的 HTTP CONNECT Proxy proxy:8088 建立連線,可以直接連至 Proxy,也可以使用本機轉送工具。如果目的地是主機名稱,請保留主機名稱,讓 Proxy 執行 DNS 解析。TCP 通道不會攔截 TLS 或注入網路密鑰,因此用戶端必須提供服務所需的憑證,並在適用時驗證服務的 TLS 憑證。需要替換網路密鑰的請求必須使用已設定的 HTTPS Proxy,且符合該密鑰的允許網域規則。替換功能僅適用於連接埠 443。

變更 VPN 組態後,請儲存變更,再發布或重新發布環境。若要讓執行中的環境使用更新後的 VPN 組態,請替換這些環境。啟動新任務並測試存取權。從草稿中解除 VPN 連結不會撤銷既有連線。如需撤銷存取權,請替換或終止受影響的環境。

使用 OIDC 存取雲端資源

OpenID Connect(OIDC)可讓任務取得用於存取雲端資源的短效憑證。你的組織需與雲端供應商設定信任關係,並授予該身分工作流程所需的權限。

  1. 開啟已儲存環境的進階 > OIDC 設定。
  2. 選取新增,然後選擇可用的連線,或選取建立連線… 以建立支援的供應商連線。
  3. 如果是新連線,請輸入供應商的身分詳細資料並建立連線。在供應商端,使用畫面顯示的簽發者、對象和主體或宣告條件來設定信任關係,並授予資源權限。
  4. 確認已將連線加入環境,並檢查連線別名。儲存設定,然後發布或重新發布環境。
  5. 啟動新任務,分別測試一項允許的操作和一項應遭拒絕的操作。

各供應商的設定方式不同,只有支援的連線可以加入環境。存取範圍取決於該身分的權限。你在供應商端的個人權限不會轉移給該身分。請另外在網路政策中允許所需的供應商端點及服務目的地。

如果變更環境連結的身分連線或連線別名,請儲存變更,即可在設定環境期間套用。若要讓新任務使用這些變更,請發布或重新發布環境。編輯共用的身分連線可能會影響使用該連線的其他環境。

執行任務及返回任務

在對話中描述你的目標。Codex 可以編輯檔案、執行指令及檢查成果。提交變更或開啟 pull request 前,請檢查變更內容及測試結果。

在網頁版或行動版繼續任務

在網頁版中,選擇工作位置 > 雲端,然後選取環境。在行動版中,開啟 Codex 並選擇可用的環境。如需建立新環境,請使用網頁版或桌面應用程式。

在其他裝置上重新開啟同一個任務,即可接續先前的工作。每個新任務都會在各自的工作區中啟動。即使電腦進入睡眠狀態,Codex 雲端中的任務仍可繼續執行。

從 Slack 或 Microsoft Teams 啟動任務

如果 Enterprise 工作區已啟用雲端任務委派,你可以在 Slack 或 Microsoft Teams 中請 @ChatGPT 處理程式碼庫中的工作。Codex 會根據對話上下文,選擇已與工作區共用且執行任務的帳戶有權使用的環境。你也可以在提示詞中指定偏好的環境,或補充指示。

對於 Slack,如果工作區採用 Codex 雲端的角色型存取控制,就必須將 Codex 雲端存取權同時授予部署所用的服務帳戶及提出請求的使用者。管理員設定方式請參閱為 Slack 啟用 Codex 雲端。

依提示完成連線及核准步驟,然後在對話中檢查結果。若要接續任務,請使用同一個已連線的帳戶提出後續要求。其他參與者提出的要求不會自動接續你的任務。

工作區設定方式請參閱管理 Slack 和 Teams 中的 ChatGPT。如需瞭解如何在 Slack 中控制任務,請參閱在 Slack 中使用 ChatGPT。

虛擬機器規格

每個雲端任務都在虛擬機器中執行,預設資源如下:

ChatGPT 方案 vCPU 數量 記憶體 磁碟空間
Plus、Edu Plus 2 8 GiB 8 GiB
Pro、Business、Enterprise 4 16 GiB 32 GiB
Edu、Edu Pro 4 16 GiB 32 GiB

依預設,從你上次開始一輪互動或繼續任務算起,最多可在七天內復原該任務已儲存的虛擬機器狀態。

Enterprise 可使用資源更多的虛擬機器,也可自訂規格。如需瞭解可用組態及價格,請聯絡你的 OpenAI 客戶團隊。

目前的限制

雲端環境目前尚未支援下列功能,我們已將這些功能列入開發計畫:

  • 電腦
  • 自行託管的 GitHub Enterprise Server

雲端任務可以使用儲存在程式碼庫中的技能。本機電腦上的個人技能不會同步至雲端環境。

排解設定及執行期間的存取問題

設定失敗或缺少必要工具

在設定對話中找出執行失敗的指令。請 Codex 診斷錯誤,修正後重新執行指令。例如:「安裝 pnpm 並執行專案的測試。」

  • 如果初始設定失敗,請選取再試一次,使用這次設定時已選取的程式碼庫重試。
  • 如果需要變更原始碼檔案、套件資訊清單或鎖定檔才能修正問題,請先在程式設計任務中完成變更,再返回設定流程。

Codex 確認設定無誤後,請發布或重新發布環境。

套件下載或 HTTPS 請求失敗

請分別檢查目的地主機名稱及身分驗證設定:

  1. 確認環境的網際網路存取設定允許該主機。如果私人套件登錄服務位於 packages.example.com,請確認允許的主機名稱完全相符。如果下載時也會使用 downloads.example.com,也必須允許連線至該主機。
  2. 檢查套件管理工具或用戶端設定的 URL 和憑證。允許連線至網域並不會授予服務的存取權。
  3. 如果身分驗證使用網路密鑰,請檢查該密鑰的允許的網域是否包含目的地,並確認請求使用 HTTPS 和連接埠 443。
  4. 在 Enterprise 工作區中,請管理員一併檢查適用的智慧體安全性要求及環境設定。

儲存組態變更,並在設定環境期間測試請求。發布或重新發布環境後,請在新任務中確認能否存取服務。

缺少必要的值或無法使用該值

請確認你已在環境組態中的正確位置新增該值:

  • 環境變數: 用於程式需要直接讀取的值,例如 APP_MODE=development。
  • HTTP 密鑰: 用於傳送至允許的 HTTPS 服務的憑證,例如私人套件登錄服務的權杖。程式會收到預留位置,Proxy 則會在符合條件的請求中將預留位置替換為憑證。如果程式需要讀取原始值,請將該值新增至環境變數。

如果是個人值,請確認其索引鍵與環境要求的索引鍵相符,且適用於的範圍包含該環境。特定環境的值優先於通用預設值。

設定方式請參閱環境變數及網路密鑰。

VPN 已連線,但無法連線至 HTTP 或 HTTPS 服務

  1. 確認用戶端使用環境中設定的 HTTP/HTTPS Proxy。使用 curl 測試時,請省略 --noproxy,讓請求透過該 Proxy 傳送。
  2. 如果目的地位於 Tailscale 網路中,請檢查 VPN 的路由及存取規則。如果目的地位於公用網際網路上,請檢查環境允許的網域。
  3. 如果透過 IP 位址可以連線至服務,但透過主機名稱無法連線,請檢查 Tailscale DNS 設定。如果是公司內部網域,請確認分割 DNS 指向正確的 DNS 伺服器,且可透過 Tailscale 網路連線至該伺服器。請使用服務的完整主機名稱,並確認該名稱可解析為 IPv4 位址。

連線設定方式請參閱私人網路連線。

任務無法使用環境或更新後的設定

請在設定 > Codex 雲端 > 環境中檢查該環境。如果環境標示為尚未發布,請完成設定並選取發布,讓任務可以使用該環境。

若要變更已發布的環境,請開啟其編輯流程,讓 Codex 準備並測試變更,再選取重新發布。從更新後的環境啟動新任務,即可使用新設定。既有任務會保留各自的工作狀態。