如果你是 ChatGPT 工作區管理員或 ChatGPT Plus 或 Pro 使用者，並要使用內建 OAuth 或組織的 OAuth 用戶端設定 Databricks Genie 應用程式，請參閱本指南。
內建 OAuth：如果 ChatGPT 提供此選項，且你的 Databricks 工作區已啟用此功能，請使用預先設定的連線。你不需要建立 OAuth 應用程式，也不需要輸入用戶端 ID 或用戶端密鑰。請依照下方「內建 OAuth」一節的步驟操作。
自訂 OAuth 用戶端：如果無法使用內建 OAuth，或組織要求使用自己的 OAuth 用戶端，請採用此方式。請依照下方「自訂 OAuth 用戶端」一節的步驟操作。
設定內容
你將為 ChatGPT 帳戶或工作區建立 Databricks 應用程式連線。兩種方式都需要提供 ChatGPT 要求的 Databricks 供應商詳細資料，並具備你打算使用的資源所需的權限。如果你使用自訂 OAuth 用戶端，還需要準備：
在 Databricks 帳戶主控台中建立的 Databricks OAuth 應用程式連線。
Databricks OAuth 用戶端 ID 和用戶端密鑰。
從 ChatGPT 原樣複製的完整回呼 URL。
與你要啟用的應用程式功能相符的 Databricks 範圍。
ChatGPT 設定流程要求的各項 Databricks 供應商詳細資料，例如工作區主機、帳戶主機、帳戶 ID 或倉儲。
開始之前
若要為工作區進行設定，請開啟管理員主控台，選擇目標 ChatGPT 工作區，然後開啟「外掛程式」。選擇「管理舊版應用程式」，開啟保留的「應用程式」頁面。如需工作區導覽與舊版應用程式存取方式的說明，請參閱外掛程式與應用程式的管理員控制項、安全性與合規性。
你需要：
ChatGPT 工作區管理員或擁有者權限，或 ChatGPT Plus 或 Pro 帳戶。
若使用自訂 OAuth 用戶端，則需具備 Databricks 帳戶管理員權限。部分工作可能只需要工作區管理員權限，但自訂應用程式連線必須從 Databricks 帳戶主控台設定。若使用內建 OAuth，Databricks 管理員必須確認 ChatGPT 應用程式可用，且已為你的工作區啟用。
若使用自訂 OAuth 用戶端，請在另一個分頁中開啟 Databricks 帳戶主控台。
若使用自訂 OAuth 用戶端，請在 ChatGPT 中開啟 Databricks Genie 連線畫面，以便原樣複製完整的回呼 URL。
確定應用程式需要哪些功能：Genie 和 AI/BI 儀表板、較廣泛的 Databricks API 存取權，或僅使用 Databricks SQL API。僅限 SQL 的存取權不足以執行 Genie 或儀表板動作。
若使用自訂 OAuth 用戶端，請準備安全的環境來處理 Databricks 用戶端密鑰。
如果你的 Databricks 帳戶或工作區透過 IP 存取清單、情境式輸入流量控制、防火牆或其他網路政策限制存取，請尋求 Databricks 管理員協助，允許目前的 ChatGPT 應用程式輸出 IP 範圍。
若使用自訂 OAuth 用戶端，請原樣複製 ChatGPT 顯示的完整回呼 URL。
需要準備的值
若使用自訂 OAuth 用戶端，請準備回呼 URL：從 ChatGPT 應用程式設定流程中複製此值。
若使用自訂 OAuth 用戶端，請準備 Databricks OAuth 用戶端 ID。
若使用自訂 OAuth 用戶端，請準備 Databricks OAuth 用戶端密鑰。
若使用自訂 OAuth 用戶端，請準備與應用程式功能相符的 Databricks 存取範圍。如果新的 Genie／儀表板連線顯示
ai-gateway、dashboards和offline_access，請準備這些範圍。所有 API（all-apis搭配offline_access）仍可作為較舊、範圍較廣的替代方案。只有在應用程式僅使用 Databricks SQL API 時，才使用 SQL。ChatGPT 設定流程要求的 Databricks 工作區或帳戶欄位資料。
內建 OAuth
請先完成上述先決條件。只有在 ChatGPT 提供內建 OAuth，且你的 Databricks 工作區已啟用此功能時，才使用此方式。
請 Databricks 管理員檢查帳戶主控台的應用程式整合設定中是否有 ChatGPT 應用程式，並確認已為你的工作區啟用。若你的 Databricks 帳戶主控台中未列出 ChatGPT 應用程式，請聯絡 Databricks 客戶代表，詢問你的帳戶是否可使用此功能。
在 ChatGPT 中，切換至要使用此應用程式的帳戶或工作區。若要進行個人設定，請前往設定 > 外掛程式；若要設定工作區，請以工作區管理員或擁有者身分前往管理員主控台 > 外掛程式。
選取 Databricks Genie，再選取新增應用程式連線。
輸入工作區主機名稱（必填），不要包含
https://或 URL 路徑。ChatGPT 會根據此主機名稱，產生工作區內的 Genie MCP 端點
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp。無須另行提供區域 MCP 端點。選取繼續，然後登入 Databricks 並檢閱授權請求。
接著按照下方「連接並測試」和「管理存取權」的步驟操作，包括獲准成員的測試和工作區存取權檢查。
自訂 OAuth 用戶端
請先完成上述前置作業。如果無法使用內建 OAuth，或組織要求使用自己的 OAuth 用戶端，請採用此方式。設定後，請完成下方「連線與測試」及「管理存取權」的步驟。
在 ChatGPT 中開始自訂 OAuth 設定
在 ChatGPT 中，切換至要使用此應用程式的帳戶或工作區。
若要進行個人設定，請前往設定 > 外掛程式；若要設定工作區，請以工作區管理員或擁有者身分前往管理員主控台 > 外掛程式。
在目錄中選取 Databricks Genie。
選取新增應用程式連線。
在連接 Databricks Genie 對話方塊中，找出 OAuth 用戶端 ID 和 OAuth 用戶端密鑰欄位。在這些顯示的欄位中輸入憑證，即可使用自訂用戶端流程，無須另外選取。
從 ChatGPT 複製回呼 URL。保持此對話方塊開啟。
回呼 URL 範例：
https://chatgpt.com/connector/oauth/<callback_id>
請勿移除回呼 ID、在結尾加上斜線，或改用一般的 ChatGPT URL。在 Databricks 中註冊的 URL 必須與 ChatGPT 中顯示的回呼 URL 完全一致。
在 Databricks 中建立自訂 OAuth 應用程式連線
開啟你 Databricks 帳戶的 Databricks 帳戶主控台。
在左側邊欄中，開啟設定。
開啟應用程式連線分頁。
選擇新增連線。
輸入應用程式名稱，例如 ChatGPT Databricks。
在重新導向 URL 中，貼上從 ChatGPT 原樣複製的完整回呼 URL。
在存取範圍下，選擇應用程式需要的範圍。
如果新的 Genie／儀表板連線在 ChatGPT 中顯示
ai-gateway、dashboards和offline_access，請在 Databricks OAuth 應用程式中允許相同範圍。若需要一般 Databricks API 存取權，所有 API 仍可作為較舊、範圍較廣的替代方案。採用此設定時，請在 ChatGPT 中使用
all-apis和offline_access，並確保 Databricks OAuth 應用程式允許這兩個範圍。對於新的 Genie／儀表板連線，請優先使用畫面顯示的細分範圍。只有在應用程式僅使用 Databricks SQL API 時，才使用 SQL。僅限 SQL 的存取權不足以執行 Genie 或儀表板動作。
請確保稍後在 ChatGPT 中列出的每個範圍，都已在此 Databricks OAuth 應用程式中啟用。對於透過使用者介面建立的應用程式，Databricks 會自動允許 openid、email、profile 和 offline_access。
除非組織另有明確政策，否則請維持 Databricks 預設的權杖存留時間（TTL）：存取權杖為 60 分鐘，重新整理權杖為 10080 分鐘。
開啟產生用戶端密鑰。此流程需要 ChatGPT 使用機密型 OAuth 用戶端。
建立連線。
從 Databricks 複製憑證
在連線已建立對話方塊中，複製用戶端 ID。
立即複製用戶端密鑰，並妥善安全保存。
如果你尚未複製密鑰就關閉對話方塊，請建立或輪替 OAuth 應用程式憑證，並使用新的密鑰。
Databricks 只會顯示密鑰一次。請將密鑰視為憑證妥善保護，不要將其放入螢幕截圖、支援單、留言或聊天中。
在 ChatGPT 中完成自訂 OAuth 設定
返回連接 Databricks Genie 對話方塊。
在 OAuth 用戶端 ID 中輸入 Databricks 用戶端 ID。
在 OAuth 用戶端密鑰中輸入 Databricks 用戶端密鑰。
輸入這些憑證即可使用自訂 OAuth 用戶端，無須另外選取。
在權限範圍（選填）中，輸入應用程式的 Databricks 端點和功能所需的權限範圍。請確保這些權限範圍與 Databricks OAuth 應用程式已啟用的權限範圍一致。
若新的 Genie／儀表板連線顯示
ai-gateway、dashboards和offline_access，請保留這些權限範圍。確保 Databricks OAuth 應用程式允許相同的權限範圍。ai-gateway可啟用工作區內的 Genie MCP 連線，dashboards可啟用 AI/BI 儀表板動作，而offline_access可啟用更新權杖。舊有且範圍較廣的替代方案
all-apis和offline_access仍受支援，可提供更廣泛的 API 存取權，但不建議優先用於此 Genie／儀表板連線。若 Databricks 應用程式僅允許all-apis，請更新或重新建立應用程式，使其允許ai-gateway、dashboards和offline_access。若無法使用細分權限範圍，請明確將 ChatGPT 設為all-apis和offline_access，並確保 Databricks 應用程式允許這兩者。若 Databricks 應用程式僅允許all-apis，請勿在 ChatGPT 中要求上述三個細分權限範圍。每行輸入一個權限範圍，或以逗號分隔各個權限範圍。ChatGPT 中列出的每個權限範圍，都必須在 Databricks OAuth 應用程式中啟用。
輸入工作區主機名稱（必填），不要包含 https:// 或 URL 路徑。填寫設定流程中顯示的其他 Databricks 提供者必填欄位。
ChatGPT 會根據此主機名稱，產生工作區內的 Genie MCP 端點
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp。無須另行提供區域 MCP 端點。選取繼續。
ChatGPT 只會要求你在權限範圍（選填）中輸入的權限範圍。系統不會自動新增範圍較廣的範本權限。
連線與測試
無論採用哪種 OAuth 方式，都請完成以下連線測試與存取權檢查。
檢查應用程式詳細資料、動作和驗證設定。
如果你是工作區管理員，請為工作區啟用應用程式，並依據工作區政策設定哪些人可以使用。
以獲准使用的測試使用者身分，從 ChatGPT 啟動連線流程，然後登入 Databricks。
確認瀏覽器開啟的是預期的 Databricks 帳戶或工作區。
檢查要求的範圍，然後選擇授權。
確認瀏覽器返回 ChatGPT，且應用程式顯示為已連線。
執行與連線功能相符的低風險讀取動作。若為 Genie 連線，請針對測試使用者有權存取的資料傳送 Genie 請求。若要測試其他支援的功能，請擷取目前使用者的資訊，或查詢已核准的 Databricks SQL 資源。確認使用者具有所需的 Databricks 資源權限；僅有 OAuth 範圍並不會授予資料存取權。
如果已啟用寫入動作，請在擴大部署前，先使用明確屬於低風險的 Databricks 工作流程進行測試。
若為工作區設定，請邀請一位獲准使用且不具管理員身分的工作區成員連線，並重複執行低風險測試。
管理存取權
存取控制由 Databricks 和 ChatGPT 共同決定。
在 ChatGPT 中，工作區管理員負責管理應用程式是否可用，以及成員可以如何使用。在 Business 中，管理員負責決定是否為整個工作區啟用應用程式。請在 Databricks 應用程式的管理員控制項（工作區設定 > 應用程式，或管理員主控台 > 外掛程式 > 管理舊版應用程式）中，檢查下列項目：
使用者存取權：在支援此功能的 Enterprise 和 Edu 工作區中，設定哪些工作區角色可以使用應用程式。
動作控制：設定要啟用哪些 Databricks 動作。
應用程式權限：設定 ChatGPT 在哪些情況下使用應用程式前，必須先詢問成員。
這些應用程式權限適用於 ChatGPT 對話。工作區智慧體會依據建構者為各個智慧體設定的控制項，決定哪些應用程式動作可用，以及何時需要請終端使用者核准這些動作。如需瞭解智慧體的行為，請參閱：適用於 Enterprise 和 Business 的 ChatGPT 工作區智慧體。
在 Databricks 中，管理員負責管理哪些使用者可以授權 OAuth 應用程式，以及這些使用者可以存取哪些 Databricks 資源。在 ChatGPT 中啟用應用程式後，供應商端的權限仍然適用。
如需工作區導覽、應用程式存取權，以及各方案專屬應用程式控制項的說明，請參閱：應用程式的管理員控制項、安全性與合規性。
Databricks 應用程式設定疑難排解
重新導向 URI 不符：如果你使用自訂 OAuth 用戶端，請確認 Databricks 的重新導向 URL 值與 ChatGPT 顯示的回呼 URL 完全一致，包括路徑和回呼 ID。請勿移除回呼 ID、在結尾加上斜線，或改用其他 ChatGPT 重新導向 URL。
缺少密鑰：如果你使用自訂 OAuth 用戶端，請注意 Databricks 密鑰只會顯示一次。如果未複製密鑰，請產生新的用戶端密鑰。
OAuth 應用程式無法立即使用：Databricks 表示，OAuth 應用程式更新最多可能需要 30 分鐘才能處理完成。
範圍不足或不符：如果你使用自訂 OAuth 用戶端，請比對 ChatGPT 中的範圍（選填）與 Databricks OAuth 應用程式中的存取範圍。必須在該應用程式中啟用 ChatGPT 要求的每個範圍。請確認這些範圍支援你使用的端點和功能。
如果新的 Genie／儀表板連線顯示
ai-gateway、dashboards和offline_access，請在 ChatGPT 中保留這些範圍，並確保 Databricks 應用程式允許這三個範圍。如果應用程式只允許all-apis，請更新或重新建立應用程式，以允許這三個細分範圍。如果無法使用細分範圍，請採用支援的較廣泛替代方案：將 ChatGPT 設為使用
all-apis和offline_access，並確保 Databricks 應用程式允許這兩個範圍。只允許all-apis的應用程式無法滿足 ChatGPT 對ai-gateway、dashboards和offline_access的要求。僅限 SQL 的存取權只適用於僅使用 Databricks SQL API 的應用程式，不足以執行 Genie 或儀表板動作。SQL 動作失敗：如果應用程式僅使用 Databricks SQL API，請確認 SQL 範圍、倉儲設定和 Databricks 權限。
ChatGPT 工作區錯誤：請在使用者將連接此應用程式的同一個 ChatGPT 工作區中，建立並啟用應用程式。
Databricks 帳戶或工作區錯誤：請確認工作區主機名稱（必填）的值，然後重新執行登入流程，確認 Databricks 開啟的是預期的帳戶或工作區。
使用者無法連線：請確認使用者具有 Databricks 存取權，且獲准授權 OAuth 應用程式。在 Business 中，請確認已為整個工作區啟用應用程式。在支援此功能的 Enterprise 和 Edu 工作區中，也請確認 ChatGPT 的使用者存取權允許使用此應用程式。
Databricks 網路政策封鎖應用程式：如果 Databricks 僅允許特定來源 IP，Databricks 管理員必須更新相關帳戶或工作區的 IP 存取清單、情境式輸入流量控制、防火牆，或其他由客戶控制的網路規則。
請允許來自目前 ChatGPT 應用程式輸出 IP 範圍的輸入連線。
請在 Databricks 或客戶控制的網路層中設定此允許清單。此設定與 ChatGPT 工作區的 IP 允許清單是分開的。
公布的範圍可能會變更。請盡可能依據該 JSON 自動更新。
請勿嘗試透過輪替用戶端密鑰或變更 OAuth 範圍來繞過網路封鎖。請先確認 Databricks 是否正在拒絕應用程式的來源 IP。