概覽
應用程式範本是適用於 Business 和 Enterprise 工作區的設定途徑,供需要 ChatGPT 應用程式或連接器的工作區專屬版本使用。工作區管理員或擁有人不會從目錄啟用一個共用應用程式,而是從 OpenAI 提供的範本開始,加入其組織特有的詳細資料,並建立草稿應用程式以供檢閱。
當 OpenAI 可以提供通用的應用程式行為,但每個工作區都必須提供供應商專屬設定時,範本便很有用。視乎範本而定,該設定可包括租戶或主機名稱、OAuth 用戶端憑證、回呼 URL、範圍、webhook 詳細資料、受管理 MCP 伺服器 URL,或其他供應商設定。例如,GitHub Enterprise 範本可能會建立工作區專屬連接器,供 Codex 用來連接該組織的 GitHub Enterprise 主機。
設定完成後,成員不會使用原始範本。他們會使用由該範本建立的已發佈工作區應用程式。之後,管理員可以像管理其他 ChatGPT 應用程式一樣管理該應用程式,包括角色存取權限、動作控制、應用程式權限和供應商授權。
Codex 外掛程式也可以包含應用程式範本,或由範本建立的應用程式。如果外掛程式包含應用程式範本,工作區管理員或擁有人仍需先建立並發佈工作區專屬應用程式,成員才可在 ChatGPT 中連接它,並透過該外掛程式使用它。外掛程式執行時,會使用該工作區中可用的應用程式執行個體,而不是要求成員自行設定原始範本。如果所需範本尚未設定,成員可能需要管理員先完成設定。外掛程式無法單獨使用應用程式範本。
請使用本文了解一般範本流程。如需供應商專屬設定,請參閱:
當相同的應用程式模式可適用於多個組織,但每個組織都需要自己的設定時,範本便很有用。
常見例子包括:
供應商 URL 包含公司租戶、帳戶、組織或工作區主機名稱。
組織需要自備 OAuth 用戶端或供應商憑證。
供應商要求設定客戶專屬的回呼 URL。
應用程式應使用相同的實作模式,同時每個工作區可分別控制存取權限、動作和安全性設定。
範本與一般應用程式有何不同
一般應用程式通常可以直接從應用程式目錄啟用。範本則會啟動設定流程。
一般流程如下:
管理員在應用程式目錄中找到範本。
管理員輸入所需的工作區專屬設定。
ChatGPT 會為工作區建立草稿應用程式。
管理員檢閱並發佈草稿。
管理員為已發佈的應用程式設定存取權限和動作設定。
成員使用已發佈的工作區應用程式,而不是原始範本。
尋找並設定應用程式範本
開啟工作區設定 > 應用程式。
選擇目錄。
搜尋供應商或應用程式名稱。
尋找標示為範本的項目。
選擇啟用以開始設定流程。
設定流程會要求提供建立工作區專屬應用程式所需的詳細資料。確切欄位取決於範本。
例如,GitHub Enterprise 範本可能會要求提供以下詳細資料:
應用程式名稱和描述。
GitHub Enterprise 主機名稱。
回呼 URL 設定。
OAuth 用戶端 ID 和用戶端密鑰。
GitHub App 私密金鑰。
要求的範圍。
Webhook 設定詳細資料。
建立草稿前,請仔細檢閱每個欄位。如果貴組織集中管理 OAuth 或供應商憑證,請與負責這些憑證的團隊協調。
請參閱應用程式專屬指示:GitHub、Snowflake 和 Databricks。
OAuth 用戶端設定
部分範本要求貴組織自備 OAuth 用戶端。如有此要求,請在外部供應商的管理控制台中建立或設定 OAuth 應用程式,然後將回呼 URL 從 ChatGPT 複製到供應商的重新導向或回呼 URL 設定中。
只有在確認供應商設定與範本設定指示相符後,才在 ChatGPT 中輸入 OAuth 用戶端 ID 和密鑰。
如果範本包含預設範圍,除非貴組織已檢閱供應商權限並有明確理由更改,否則請保留預設值。
建立草稿
輸入所需資料後,選擇建立草稿。
建立草稿不會自動讓成員可以使用該應用程式。請先檢閱草稿、發佈草稿,並設定存取權限和動作設定,然後才要求成員使用。
發佈並管理產生的應用程式
發佈後,請從工作區設定 > 應用程式 > 已啟用管理工作區專屬應用程式。
建議的發佈後檢查:
確認應用程式出現在已啟用的應用程式中。
為應使用應用程式的角色設定使用者存取權限。
檢閱動作控制中的讀取和寫入動作。
檢閱應用程式權限,以選擇 ChatGPT 何時在使用應用程式前詢問成員。
請獲准的測試使用者在 ChatGPT 中開啟「應用程式」,並確認應用程式出現。
如果應用程式需要供應商驗證,請測試使用者連接其供應商帳戶。
執行低風險測試提示詞,以確認應用程式按預期運作。
這些應用程式權限適用於 ChatGPT 對話。工作區智能代理會使用由智能代理建立者設定的個別智能代理控制項,判斷哪些應用程式動作可用,以及何時要求最終使用者核准。如需了解智能代理行為,請參閱:ChatGPT Workspace Agents for Enterprise and Business。
如果範本只能使用一次
部分範本可能每個工作區只能建立一個應用程式。如果範本已被使用,啟用按鈕可能無法使用。在這種情況下,請管理現有草稿或已發佈的應用程式,而不是從同一範本建立另一個。
成員會看到的內容
成員會看到由範本建立的已發佈應用程式。成員是否能看到或使用它,取決於工作區設定和供應商授權。如果應用程式包含在外掛程式中,成員可能會透過該外掛程式遇到它,但仍須符合相同的工作區存取權限和供應商授權要求。
請檢查:
應用程式已發佈。
應用程式已為該工作區啟用。
成員的工作區角色具有存取權限。
成員位於正確的工作區。
成員在外部供應商中具有所需權限。
已發佈的應用程式會出現在 ChatGPT 應用程式目錄中工作區專屬的區段。
疑難排解
如果設定失敗或應用程式沒有出現,請確認以下事項:
租戶、帳戶或工作區主機名稱正確。
回呼 URL 已完整準確複製到供應商設定中。
OAuth 用戶端 ID 和用戶端密鑰正確。
要求的範圍與供應商 OAuth 應用程式允許的範圍相符。
已建立草稿。
草稿已發佈。
角色存取權限允許測試使用者看到應用程式。
供應商端權限允許正在測試的資料或動作。
安全性注意事項
請將 OAuth 用戶端密鑰和供應商憑證視為敏感資料。
建立草稿前,請檢閱要求的範圍。
發佈後,使用動作控制限制應用程式可執行的操作。
使用應用程式權限決定 ChatGPT 何時在使用應用程式前詢問成員。
請注意,應用程式在 ChatGPT 中啟用後,供應商權限仍然適用。
