概觀
應用程式範本是一種設定路徑,適用於需要工作區專屬 ChatGPT 應用程式或連接器版本的 Business 和 Enterprise 工作區。工作區管理員或擁有者不會從目錄啟用單一共用應用程式,而是從 OpenAI 提供的範本開始,加入其組織專屬的詳細資料,並建立草稿應用程式以供檢閱。
當 OpenAI 能提供共通的應用程式行為,但每個工作區都必須提供特定提供者設定時,範本就很有用。視範本而定,該設定可包含租用戶或主機名稱、OAuth 用戶端認證、回呼 URL、範圍、webhook 詳細資料、受管理的 MCP 伺服器 URL,或其他提供者設定。例如,GitHub Enterprise 範本可能會建立 Codex 用來存取該組織 GitHub Enterprise 主機的工作區專屬連接器。
設定完成後,成員不會使用原始範本。他們會使用由該範本建立的已發布工作區應用程式。之後管理員可以像管理其他 ChatGPT 應用程式一樣管理該應用程式,包括角色存取權、動作控制、應用程式權限和提供者授權。
Codex plugins 也可以包含應用程式範本,或從範本建立的應用程式。如果插件包含應用程式範本,工作區管理員或擁有者仍需先建立並發布工作區專屬應用程式,成員才能在 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 對話。工作區智慧體會使用智慧體建構者設定的個別智慧體控制項,判斷哪些應用程式動作可用,以及何時要求使用者核准。如需智慧體行為,請參閱:適用於 Enterprise 和 Business 的 ChatGPT 工作區智慧體。
如果範本只能使用一次
某些範本在每個工作區可能只能建立一個應用程式。如果範本已被使用,啟用按鈕可能無法使用。在這種情況下,請管理現有草稿或已發布的應用程式,而不是從相同範本建立另一個。
成員會看到什麼
成員會看到從範本建立的已發布應用程式。成員能否看到或使用該應用程式,取決於工作區設定和提供者授權。如果應用程式包含在插件中,成員可能會透過該插件遇到它,但仍適用相同的工作區存取權和提供者授權需求。
確認以下事項:
應用程式已發布。
應用程式已為工作區啟用。
成員的工作區角色具備存取權。
成員位於正確的工作區。
成員在外部提供者中具備必要權限。
已發布的應用程式會出現在 ChatGPT 應用程式目錄的工作區專屬區段中。
疑難排解
如果設定失敗或應用程式未顯示,請確認以下事項:
租用戶、帳戶或工作區主機名稱正確。
回呼 URL 已完整複製到提供者設定中。
OAuth 用戶端 ID 和用戶端密鑰正確。
要求的範圍與提供者 OAuth 應用程式允許的範圍相符。
已建立草稿。
草稿已發布。
角色存取權允許測試使用者看到應用程式。
提供者端權限允許正在測試的資料或動作。
安全性注意事項
請將 OAuth 用戶端密鑰和提供者認證視為敏感資訊。
建立草稿前,請檢閱要求的範圍。
發布後,使用 動作控制 來限制應用程式可執行的操作。
使用 應用程式權限 來決定 ChatGPT 何時在使用應用程式前詢問成員。
請注意,在 ChatGPT 中啟用應用程式後,提供者權限仍然適用。
