如果您是 ChatGPT 工作區管理員，正在為組織設定 Databricks 應用程式範本，請使用本指南。範本不是成員最終使用的應用程式。它是一個設定流程；您提供必要的 Databricks 設定後，會建立工作區專屬的草稿應用程式。
對於 Databricks，大多數設定都在 Databricks Account Console 中完成。您會建立自訂 OAuth 應用程式連線、註冊 ChatGPT 回呼 URL、複製產生的用戶端憑證，然後將這些值貼到 ChatGPT 範本設定流程中。ChatGPT 建立草稿應用程式後，您可以發布並像管理其他工作區應用程式一樣管理它。
您正在設定的內容
您正在 ChatGPT 中建立工作區專屬的 Databricks 應用程式。此應用程式使用：
在 Databricks Account Console 中建立的 Databricks OAuth 應用程式連線。
Databricks OAuth 用戶端 ID 和用戶端密鑰。
從 ChatGPT 複製的確切回呼 URL。
與您要啟用的連接器功能相符的 Databricks 範圍。
ChatGPT 設定流程要求的任何 Databricks 提供者詳細資料，例如工作區主機、帳戶主機、帳戶 ID 或倉儲。
開始之前
您需要：
ChatGPT 工作區管理員或擁有者存取權。
Databricks 帳戶管理員存取權。工作區管理員存取權可能足以執行某些工作，但自訂應用程式連線需從 Databricks Account Console 設定。
在另一個分頁中開啟 Databricks Account Console。
在 ChatGPT 中開啟 Databricks 應用程式範本設定畫面，以便複製確切的回呼 URL。
判斷應用程式是否需要一般 Databricks API 存取權，或只需要 Databricks SQL 存取權。
可安全處理 Databricks 用戶端密鑰的位置。
請勿自行編造回呼 URL。請複製 ChatGPT 中顯示的確切回呼 URL。
要準備的值
回呼 URL：從 ChatGPT 範本設定流程中複製。
Databricks OAuth 用戶端 ID。
Databricks OAuth 用戶端密鑰。
Databricks 存取範圍，例如 ALL APIs 或 SQL。
ChatGPT 設定流程要求的 Databricks 工作區或帳戶欄位。
在 ChatGPT 中發布和管理應用程式
建立草稿應用程式不會自動讓成員可以使用。檢閱草稿後：
發布草稿應用程式。
確認應用程式顯示在 工作區設定 > 應用程式 > 已啟用。
為應使用此應用程式的角色設定 使用者存取權。
檢閱應用程式公開的 Databricks 動作的 動作控制。
檢閱 應用程式權限，以選擇 ChatGPT 何時在使用應用程式前詢問成員。
請一位允許的測試使用者在 ChatGPT 中開啟「應用程式」，並確認應用程式出現。
這些應用程式權限適用於 ChatGPT 對話。工作區智慧體會使用由智慧體建構者設定的各智慧體控制項，判斷哪些應用程式動作可用，以及何時要求終端使用者核准。如需智慧體行為，請參閱：企業版和商務版 ChatGPT 工作區智慧體。
在 ChatGPT 中開始範本設定
在 ChatGPT 中，切換到應提供此應用程式的工作區。
開啟 工作區設定 > 應用程式。
選取 目錄。
搜尋 Databricks。
選取 Databricks 應用程式範本並開始設定。
輸入清楚的應用程式名稱和描述，例如 Databricks 或 Databricks - Data Platform。
在 OAuth 用戶端區段中，從 ChatGPT 複製回呼 URL。保持此分頁開啟。
回呼 URL 範例：https://chatgpt.com/connector/oauth/<callback_id>
請勿移除回呼 ID、新增結尾斜線，或將其替換為通用 ChatGPT URL。
在 Databricks 中建立 OAuth 應用程式連線
開啟您的 Databricks 帳戶的 Databricks Account Console。
在左側邊欄中，開啟 設定。
開啟 應用程式連線 分頁。
選取 新增連線。
輸入應用程式名稱，例如 ChatGPT Databricks Connector。
在 重新導向 URL 中，貼上從 ChatGPT 複製的確切回呼 URL。
在 存取範圍 下，選擇應用程式需要的範圍。
對於需要 SQL 以外 Databricks API 的一般 Databricks 應用程式，請使用 ALL APIs。
對於僅限 Databricks SQL API 的應用程式，請只使用 SQL。
除非您的組織有特定政策，否則請將 Token TTL 保持為 Databricks 預設值。
啟用 產生用戶端密鑰。此流程需要 ChatGPT 使用機密 OAuth 用戶端。
建立連線。
從 Databricks 複製憑證
在「連線已建立」對話方塊中，複製 Client ID。
立即複製 Client secret 並安全儲存。
如果您在複製密鑰前關閉對話方塊，請建立或輪替 OAuth 應用程式憑證，並使用新的密鑰。
Databricks 只會顯示密鑰一次。請像處理憑證一樣處理它，不要將其包含在螢幕截圖、工單、留言或聊天中。
在 ChatGPT 中完成設定
返回 ChatGPT 範本設定分頁。
將 Databricks Client ID 貼到 OAuth 用戶端 ID。
將 Databricks Client secret 貼到 OAuth 用戶端密鑰。
除非您有意覆寫範本預設值，否則請讓範圍保持不變。
填寫設定流程要求的任何 Databricks 提供者欄位，例如工作區主機、帳戶主機、帳戶 ID、倉儲或其他 Databricks 專屬值。
建立草稿應用程式。
以使用者身分測試應用程式
以允許的測試使用者身分，從 ChatGPT 啟動連線流程。
確認瀏覽器開啟預期的 Databricks 帳戶或工作區。
核准要求的範圍。
確認瀏覽器返回 ChatGPT，且應用程式顯示為已連線。
先執行低風險的讀取動作，例如擷取目前使用者資訊，或查詢已核准的 Databricks SQL 資源。
如果已啟用寫入動作，請先使用明確低風險的 Databricks 工作流程進行測試，再擴大推出。
管理存取權
Databricks 和 ChatGPT 共同提供存取控制。
在 ChatGPT 中，工作區管理員負責管理已發布應用程式是否可用、哪些工作區角色可以使用、哪些動作已啟用，以及 ChatGPT 何時在使用應用程式前詢問使用者。
在 Databricks 中，管理員負責管理哪些使用者可以授權 OAuth 應用程式，以及這些使用者可以存取哪些 Databricks 資源。在 ChatGPT 中啟用應用程式後，提供者權限仍然適用。
疑難排解
重新導向 URI 不相符：確認 Databricks Redirect URL 與 ChatGPT 中顯示的回呼 URL 完全相符，包括路徑和回呼 ID。
缺少密鑰：Databricks 密鑰只會顯示一次。如果未複製密鑰，請產生新的用戶端密鑰。
OAuth 應用程式未立即可用：Databricks 表示 OAuth 應用程式更新最多可能需要 30 分鐘處理。
範圍不足：如果 ChatGPT 可以驗證，但 Databricks API 呼叫失敗，請確認當應用程式需要非 SQL API 時，Databricks 應用程式具有 ALL APIs。
SQL 動作失敗：確認 SQL 範圍、倉儲設定和 Databricks 權限。
工作區錯誤：請在使用者將連線此應用程式的同一個 ChatGPT 工作區中建立並發布應用程式。
使用者無法連線：確認使用者具備 Databricks 存取權，且允許授權 OAuth 應用程式。