ChatGPT Support › ChatGPT (Tổng quan & Ứng dụng) › Ứng dụng liên kết (Connected apps) › Thiết lập mẫu ứng dụng Databricks trong ChatGPT

Thiết lập mẫu ứng dụng Databricks trong ChatGPT

Cập nhật: 08/10/2026 • Biên dịch & Hướng dẫn kỹ thuật bởi vMixGPT

Tìm hiểu cách quản trị viên không gian làm việc ChatGPT và người dùng ChatGPT Plus hoặc Pro có thể kết nối Databricks bằng OAuth client của tổ chức.

Hãy dùng hướng dẫn này nếu bạn là quản trị viên không gian làm việc ChatGPT hoặc người dùng ChatGPT Plus hay Pro đang thiết lập bộ kết nối Databricks Genie bằng OAuth tích hợp sẵn hoặc OAuth client của tổ chức.

  • OAuth tích hợp sẵn: Khi có sẵn trong ChatGPT và đã được bật cho không gian làm việc Databricks của bạn, hãy dùng kết nối được cấu hình sẵn. Bạn không cần tạo ứng dụng OAuth hay nhập client ID hoặc client secret. Hãy làm theo phần OAuth tích hợp sẵn bên dưới.

  • OAuth client tùy chỉnh: Dùng cách này nếu không có OAuth tích hợp sẵn hoặc tổ chức của bạn yêu cầu dùng OAuth client riêng. Hãy làm theo phần OAuth client tùy chỉnh bên dưới.

Những gì bạn đang thiết lập

Bạn đang tạo một kết nối ứng dụng Databricks cho tài khoản hoặc không gian làm việc ChatGPT của mình. Cả hai cách đều cần các thông tin nhà cung cấp Databricks mà ChatGPT yêu cầu và quyền đối với các tài nguyên bạn định sử dụng. Nếu dùng OAuth client tùy chỉnh, bạn cũng cần chuẩn bị:

  • Một kết nối ứng dụng OAuth của Databricks được tạo trong Databricks Account Console.

  • Client ID và client secret OAuth của Databricks.

  • Callback URL chính xác được sao chép từ ChatGPT.

  • Các scope của Databricks phù hợp với những khả năng của bộ kết nối mà bạn muốn bật.

  • Mọi thông tin nhà cung cấp Databricks mà quy trình thiết lập của ChatGPT yêu cầu, chẳng hạn máy chủ không gian làm việc, máy chủ tài khoản, ID tài khoản hoặc warehouse.

Trước khi bắt đầu

Đối với thiết lập cho không gian làm việc, hãy mở admin console, chọn không gian làm việc ChatGPT tương ứng và mở Plugins. Chọn Manage Legacy Apps (Quản lý ứng dụng cũ) để mở trang Ứng dụng (Apps) vẫn được giữ lại. Để biết cách điều hướng trong không gian làm việc và truy cập ứng dụng cũ, xem Tùy chọn kiểm soát dành cho quản trị viên, bảo mật và tuân thủ đối với plugin và ứng dụng.

Bạn cần có:

  • Quyền quản trị viên hoặc chủ sở hữu không gian làm việc ChatGPT, hoặc tài khoản ChatGPT Plus hay Pro.

  • Đối với OAuth client tùy chỉnh, quyền quản trị viên tài khoản Databricks. Quyền quản trị viên không gian làm việc có thể đủ cho một số tác vụ, nhưng kết nối ứng dụng tùy chỉnh được cấu hình từ Databricks Account Console. Đối với OAuth tích hợp sẵn, quản trị viên Databricks phải kiểm tra để chắc chắn ứng dụng ChatGPT có sẵn và đã được bật cho không gian làm việc của bạn.

  • Đối với OAuth client tùy chỉnh, mở Databricks Account Console trong một thẻ riêng.

  • Đối với OAuth client tùy chỉnh, mở màn hình kết nối Databricks Genie trong ChatGPT để bạn có thể sao chép chính xác callback URL.

  • Quyết định về các khả năng mà ứng dụng cần: Genie và bảng điều khiển AI/BI, quyền truy cập Databricks API rộng hơn, hoặc ứng dụng chỉ giới hạn trong Databricks SQL API. Quyền truy cập chỉ SQL không đủ cho các thao tác của Genie hoặc bảng điều khiển.

  • Đối với OAuth client tùy chỉnh, một nơi an toàn để xử lý client secret của Databricks.

  • Nếu tài khoản hoặc không gian làm việc Databricks của bạn hạn chế truy cập bằng danh sách IP được phép, kiểm soát truy cập đầu vào dựa trên ngữ cảnh, tường lửa hoặc chính sách mạng khác, bạn cần sự hỗ trợ của một quản trị viên Databricks có thể cho phép các dải IP đầu ra hiện tại của bộ kết nối ChatGPT.

Đối với OAuth client tùy chỉnh, hãy sao chép chính xác Callback URL hiển thị trong ChatGPT.

Các giá trị cần chuẩn bị

  • Đối với OAuth client tùy chỉnh, Callback URL: sao chép từ quy trình thiết lập bộ kết nối trong ChatGPT.

  • Đối với OAuth client tùy chỉnh, client ID OAuth của Databricks.

  • Đối với OAuth client tùy chỉnh, client secret OAuth của Databricks.

  • Đối với OAuth client tùy chỉnh, các scope truy cập Databricks phù hợp với khả năng của ứng dụng. Với kết nối Genie/bảng điều khiển mới hiển thị ai-gateway, dashboards và offline_access, hãy chuẩn bị các scope đó. ALL APIs (all-apis cùng với offline_access) vẫn là lựa chọn thay thế cũ hơn, có phạm vi rộng hơn. Chỉ dùng SQL cho ứng dụng giới hạn trong Databricks SQL API.

  • Các trường thông tin về không gian làm việc hoặc tài khoản Databricks mà quy trình thiết lập của ChatGPT yêu cầu.

OAuth tích hợp sẵn

Hãy hoàn tất các điều kiện tiên quyết ở trên trước. Chỉ dùng cách này khi OAuth tích hợp sẵn có trong ChatGPT và đã được bật cho không gian làm việc Databricks của bạn.

  1. Nhờ quản trị viên Databricks kiểm tra để chắc chắn ứng dụng ChatGPT có sẵn trong cài đặt tích hợp ứng dụng (app integrations settings) của Account Console và đã được bật cho không gian làm việc của bạn. Nếu ứng dụng ChatGPT không có trong Databricks Account Console, hãy liên hệ đại diện tài khoản Databricks để hỏi xem tính năng này có khả dụng cho tài khoản của bạn hay không.

  2. Trong ChatGPT, chuyển sang tài khoản hoặc không gian làm việc nơi ứng dụng cần được cung cấp. Đi tới Cài đặt > Plugins nếu thiết lập cho cá nhân, hoặc Admin console > Plugins với tư cách quản trị viên hoặc chủ sở hữu nếu thiết lập cho không gian làm việc.

  3. Chọn Databricks Genie, sau đó chọn Add App Connection (Thêm kết nối ứng dụng).

  4. Nhập Workspace hostname (required) (Tên máy chủ không gian làm việc, bắt buộc) mà không kèm https:// hoặc đường dẫn URL.

    ChatGPT tự suy ra endpoint Genie MCP cục bộ của không gian làm việc, https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, từ tên máy chủ này. Không cần endpoint MCP theo khu vực riêng.

  5. Chọn Continue (Tiếp tục), sau đó đăng nhập vào Databricks và xem lại yêu cầu cấp quyền.

Tiếp tục với các phần Kết nối và kiểm tra và Quản lý quyền truy cập bên dưới, bao gồm các bài kiểm tra với thành viên được phép và kiểm tra quyền truy cập không gian làm việc.

OAuth client tùy chỉnh

Hãy hoàn tất các điều kiện tiên quyết ở trên trước. Dùng cách này nếu không có OAuth tích hợp sẵn hoặc tổ chức của bạn yêu cầu dùng OAuth client riêng. Sau khi thiết lập, hãy hoàn tất các phần Kết nối và kiểm tra và Quản lý quyền truy cập bên dưới.

Bắt đầu thiết lập OAuth tùy chỉnh trong ChatGPT

  1. Trong ChatGPT, chuyển sang tài khoản hoặc không gian làm việc nơi ứng dụng cần được cung cấp.

  2. Đi tới Cài đặt > Plugins nếu thiết lập cho cá nhân, hoặc Admin console > Plugins với tư cách quản trị viên hoặc chủ sở hữu nếu thiết lập cho không gian làm việc.

  3. Chọn Databricks Genie trong Directory (Thư mục).

  4. Chọn Add App Connection.

  5. Trong hộp thoại Connect Databricks Genie, tìm các trường OAuth client ID và OAuth client secret. Việc nhập thông tin xác thực vào các trường hiển thị này chính là quy trình dùng client tùy chỉnh; không cần bộ chọn riêng.

  6. Sao chép Callback URL từ ChatGPT. Giữ nguyên hộp thoại này.

ChatGPT Connect Databricks Genie dialog showing the callback URL field and OAuth client settings.

Ví dụ về callback URL:

https://chatgpt.com/connector/oauth/<callback_id>

Không xóa callback ID, không thêm dấu gạch chéo ở cuối và không thay bằng một URL ChatGPT chung chung. URL được đăng ký trong Databricks phải khớp chính xác với Callback URL hiển thị trong ChatGPT.

Tạo kết nối ứng dụng OAuth tùy chỉnh trong Databricks

  1. Mở Databricks Account Console cho tài khoản Databricks của bạn.

  2. Ở thanh bên trái, mở Settings (Cài đặt).

  3. Mở thẻ App connections (Kết nối ứng dụng).

  4. Chọn Add connection (Thêm kết nối).

    Databricks Account Console Settings page showing the App connections tab and Add connection button.
  5. Nhập tên ứng dụng, chẳng hạn ChatGPT Databricks Connector.

  6. Trong Redirect URLs, dán chính xác callback URL đã sao chép từ ChatGPT.

  7. Trong Access scopes, chọn các scope mà ứng dụng cần.

  8. Với kết nối Genie/bảng điều khiển mới hiển thị ai-gateway, dashboards và offline_access trong ChatGPT, hãy cho phép đúng các scope đó trên ứng dụng OAuth của Databricks.

  9. ALL APIs vẫn là lựa chọn thay thế cũ hơn, có phạm vi rộng hơn, cho quyền truy cập Databricks API chung. Với cấu hình này, hãy dùng all-apis và offline_access trong ChatGPT và đảm bảo ứng dụng OAuth của Databricks cho phép cả hai. Đối với kết nối Genie/bảng điều khiển mới, nên ưu tiên các scope chi tiết được hiển thị.

  10. Chỉ dùng SQL cho ứng dụng giới hạn trong Databricks SQL API. Quyền truy cập chỉ SQL không đủ cho các thao tác của Genie hoặc bảng điều khiển.

  11. Hãy đảm bảo mọi scope sau này được liệt kê trong ChatGPT đều được bật trên ứng dụng OAuth Databricks này. Databricks tự động cho phép openid, email, profile và offline_access đối với các ứng dụng được tạo trong giao diện.

  12. Giữ TTL của token ở giá trị mặc định của Databricks trừ khi tổ chức của bạn có chính sách cụ thể: 60 phút cho access token và 10080 phút cho refresh token.

  13. Bật Generate a client secret (Tạo client secret). ChatGPT cần một OAuth client bảo mật (confidential) cho quy trình này.

  14. Tạo kết nối.

Databricks OAuth connection settings showing redacted client ID and redirect URL, access scopes, and the client-secret option.

Sao chép thông tin xác thực từ Databricks

  1. Trong hộp thoại Connection created (Đã tạo kết nối), sao chép Client ID.

  2. Sao chép Client secret ngay lập tức và lưu trữ an toàn.

  3. Nếu bạn đóng hộp thoại trước khi sao chép secret, hãy tạo mới hoặc xoay vòng thông tin xác thực của ứng dụng OAuth và dùng secret mới.

Databricks chỉ hiển thị secret một lần. Hãy coi nó như một thông tin xác thực và không đưa vào ảnh chụp màn hình, phiếu hỗ trợ, bình luận hoặc cuộc trò chuyện.

Hoàn tất thiết lập OAuth tùy chỉnh trong ChatGPT

  1. Quay lại hộp thoại Connect Databricks Genie.

  2. Nhập client ID của Databricks vào OAuth client ID.

  3. Nhập client secret của Databricks vào OAuth client secret.

    Việc nhập các thông tin xác thực này sẽ dùng OAuth client tùy chỉnh của bạn; không cần bộ chọn riêng.

  4. Trong Scopes (optional) (Scope, không bắt buộc), nhập các scope cần thiết cho endpoint Databricks và khả năng của ứng dụng. Hãy cho khớp với các scope đã bật trên ứng dụng OAuth của Databricks.

    Với kết nối Genie/bảng điều khiển mới hiển thị ai-gateway, dashboards và offline_access, hãy giữ nguyên các scope đó. Đảm bảo ứng dụng OAuth của Databricks cho phép đúng các scope này. ai-gateway bật kết nối Genie MCP cục bộ của không gian làm việc, dashboards bật các thao tác trên bảng điều khiển AI/BI, và offline_access bật refresh token.

    Lựa chọn thay thế cũ hơn, có phạm vi rộng hơn, gồm all-apis và offline_access, vẫn được hỗ trợ cho quyền truy cập API rộng hơn nhưng không được ưu tiên cho kết nối Genie/bảng điều khiển này. Nếu ứng dụng Databricks chỉ cho phép all-apis, hãy cập nhật hoặc tạo lại ứng dụng để cho phép ai-gateway, dashboards và offline_access. Nếu không có các scope chi tiết, hãy chủ động đặt ChatGPT dùng all-apis và offline_access và đảm bảo ứng dụng Databricks cho phép cả hai. Không yêu cầu ba scope chi tiết trong ChatGPT khi ứng dụng Databricks chỉ cho phép all-apis.

  5. Nhập mỗi scope trên một dòng hoặc phân tách các scope bằng dấu phẩy. Mọi scope được liệt kê trong ChatGPT đều phải được bật trên ứng dụng OAuth của Databricks.

  6. Nhập Workspace hostname (required) mà không kèm https:// hoặc đường dẫn URL. Điền mọi trường thông tin nhà cung cấp Databricks bắt buộc khác hiển thị trong quy trình thiết lập.

    ChatGPT tự suy ra endpoint Genie MCP cục bộ của không gian làm việc, https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, từ tên máy chủ này. Không cần endpoint MCP theo khu vực riêng.

  7. Chọn Continue.

ChatGPT yêu cầu chính xác các scope đã nhập trong Scopes (optional). Nó không tự động thêm các scope mẫu có phạm vi rộng hơn.

ChatGPT Connect Databricks Genie dialog showing a mock workspace hostname, mock client ID, masked secret, and scopes.

Kết nối và kiểm tra

Hoàn tất các bài kiểm tra kết nối và kiểm tra quyền truy cập sau đây cho cả hai cách dùng OAuth.

  1. Xem lại thông tin chi tiết, các thao tác và cài đặt xác thực của bộ kết nối.

  2. Nếu bạn là quản trị viên không gian làm việc, hãy bật bộ kết nối cho không gian làm việc và cấu hình những ai có thể sử dụng theo chính sách của không gian làm việc.

  3. Bắt đầu quy trình kết nối từ ChatGPT với tư cách một người dùng thử nghiệm được phép, sau đó đăng nhập vào Databricks.

  4. Xác nhận rằng trình duyệt mở đúng tài khoản hoặc không gian làm việc Databricks mong muốn.

  5. Xem lại các scope được yêu cầu, sau đó chọn Authorize (Ủy quyền).

    Databricks permission request for a mock ChatGPT Databricks Connector showing requested access and the Authorize button.
  6. Xác minh rằng trình duyệt quay lại ChatGPT và bộ kết nối hiển thị trạng thái đã kết nối.

  7. Chạy một thao tác đọc ít rủi ro phù hợp với khả năng của kết nối. Với kết nối Genie, hãy gửi một yêu cầu Genie về dữ liệu mà người dùng thử nghiệm được phép truy cập. Với các khả năng được hỗ trợ khác, hãy lấy thông tin người dùng hiện tại hoặc truy vấn một tài nguyên Databricks SQL đã được phê duyệt. Xác nhận rằng người dùng có các quyền cần thiết đối với tài nguyên Databricks; chỉ riêng scope OAuth không cấp quyền truy cập dữ liệu.

  8. Nếu các thao tác ghi được bật, hãy thử nghiệm với một quy trình Databricks rõ ràng là ít rủi ro trước khi triển khai rộng hơn.

  9. Đối với thiết lập cho không gian làm việc, hãy nhờ một thành viên không phải quản trị viên và được phép trong không gian làm việc kết nối và lặp lại bài kiểm tra ít rủi ro.

Quản lý quyền truy cập

Cả Databricks và ChatGPT đều tham gia vào việc kiểm soát truy cập.

Trong ChatGPT, quản trị viên không gian làm việc quản lý việc ứng dụng có được cung cấp hay không và cách thành viên có thể sử dụng ứng dụng. Trong gói Business, quản trị viên quản lý việc ứng dụng có được bật trên toàn không gian làm việc hay không. Hãy xem lại các tùy chọn kiểm soát dành cho quản trị viên đối với ứng dụng Databricks (Cài đặt không gian làm việc > Ứng dụng hoặc Admin Console > Plugins > Manage Legacy Apps) để cấu hình:

  • Quyền truy cập của người dùng (User access), để cấu hình những vai trò nào trong không gian làm việc có thể dùng bộ kết nối trong các không gian làm việc Enterprise và Edu được hỗ trợ.

  • Kiểm soát thao tác (Action control), để cấu hình những thao tác Databricks nào được bật.

  • Quyền của ứng dụng (App permissions), để cấu hình khi nào ChatGPT hỏi thành viên trước khi dùng bộ kết nối.

Các quyền ứng dụng này áp dụng cho cuộc trò chuyện ChatGPT. Workspace Agents dùng các tùy chọn kiểm soát riêng cho từng agent do người xây dựng agent thiết lập để xác định thao tác ứng dụng nào khả dụng và khi nào người dùng cuối được yêu cầu phê duyệt. Về hoạt động của agent, xem: ChatGPT Workspace Agents cho Enterprise và Business.

Trong Databricks, quản trị viên quản lý những người dùng nào có thể ủy quyền ứng dụng OAuth và những tài nguyên Databricks nào mà người dùng đó có thể truy cập. Quyền của nhà cung cấp vẫn được áp dụng sau khi ứng dụng được bật trong ChatGPT.

Để biết cách điều hướng trong không gian làm việc, quyền truy cập ứng dụng và các tùy chọn kiểm soát ứng dụng theo từng gói, xem: Tùy chọn kiểm soát dành cho quản trị viên, bảo mật và tuân thủ trong ứng dụng.

Khắc phục sự cố khi thiết lập bộ kết nối Databricks

  • Redirect URI không khớp: Nếu bạn dùng OAuth client tùy chỉnh, hãy xác nhận giá trị Redirect URLs trong Databricks khớp chính xác với Callback URL hiển thị trong ChatGPT, bao gồm cả đường dẫn và callback ID. Không xóa callback ID, không thêm dấu gạch chéo ở cuối và không thay bằng một redirect URL khác của ChatGPT.

  • Thiếu secret: Nếu bạn dùng OAuth client tùy chỉnh, secret của Databricks chỉ hiển thị một lần. Hãy tạo client secret mới nếu chưa sao chép.

  • Ứng dụng OAuth chưa khả dụng ngay: Theo Databricks, các cập nhật ứng dụng OAuth có thể mất đến 30 phút để được xử lý.

  • Scope không đủ hoặc không khớp: Nếu bạn dùng OAuth client tùy chỉnh, hãy so sánh Scopes (optional) trong ChatGPT với Access scopes trên ứng dụng OAuth của Databricks. Mọi scope mà ChatGPT yêu cầu đều phải được bật ở đó. Xác nhận rằng các scope hỗ trợ endpoint và các khả năng bạn sử dụng.

    Với kết nối Genie/bảng điều khiển mới hiển thị ai-gateway, dashboards và offline_access, hãy giữ các scope đó trong ChatGPT và đảm bảo ứng dụng Databricks cho phép cả ba. Nếu ứng dụng chỉ cho phép all-apis, hãy cập nhật hoặc tạo lại ứng dụng để cho phép ba scope chi tiết này.

    Nếu không có các scope chi tiết, hãy dùng lựa chọn thay thế rộng hơn được hỗ trợ: đặt ChatGPT dùng all-apis và offline_access, và đảm bảo ứng dụng Databricks cho phép cả hai. Một ứng dụng chỉ cho phép all-apis sẽ không khớp với yêu cầu ai-gateway, dashboards và offline_access từ ChatGPT. Quyền truy cập chỉ SQL chỉ phù hợp cho ứng dụng giới hạn trong Databricks SQL API; quyền này không đủ cho các thao tác của Genie hoặc bảng điều khiển.

  • Thao tác SQL không thành công: Với ứng dụng giới hạn trong Databricks SQL API, hãy xác nhận scope SQL, cấu hình warehouse và các quyền trong Databricks.

  • Sai không gian làm việc ChatGPT: Hãy tạo và bật bộ kết nối trong cùng không gian làm việc ChatGPT nơi người dùng sẽ kết nối.

  • Sai tài khoản hoặc không gian làm việc Databricks: Xác nhận giá trị Workspace hostname (required), sau đó lặp lại quy trình đăng nhập và xác minh rằng Databricks mở đúng tài khoản hoặc không gian làm việc mong muốn.

  • Người dùng không thể kết nối: Xác nhận rằng người dùng có quyền truy cập Databricks và được phép ủy quyền ứng dụng OAuth. Trong gói Business, xác nhận rằng ứng dụng đã được bật trên toàn không gian làm việc. Trong các không gian làm việc Enterprise và Edu được hỗ trợ, cũng hãy xác nhận rằng Quyền truy cập của người dùng trong ChatGPT cho phép dùng bộ kết nối.

  • Chính sách mạng của Databricks chặn bộ kết nối: Nếu Databricks chỉ cho phép một số IP nguồn cụ thể, quản trị viên Databricks phải cập nhật danh sách IP được phép của tài khoản hoặc không gian làm việc liên quan, kiểm soát truy cập đầu vào dựa trên ngữ cảnh, tường lửa hoặc các quy tắc mạng khác do khách hàng kiểm soát.

    • Cho phép các kết nối đến từ các dải IP đầu ra hiện tại của bộ kết nối ChatGPT.

    • Cấu hình danh sách cho phép này trong Databricks hoặc lớp mạng do khách hàng kiểm soát. Việc này tách biệt với danh sách IP được phép của không gian làm việc ChatGPT.

    • Các dải IP được công bố có thể thay đổi. Hãy tự động hóa việc cập nhật từ tệp JSON khi có thể.

    • Không xoay vòng client secret hoặc thay đổi scope OAuth để né tránh việc bị chặn ở tầng mạng. Trước tiên, hãy xác nhận liệu Databricks có đang từ chối các IP nguồn của bộ kết nối hay không.

Chính sách hỗ trợ doanh nghiệp
LIÊN HỆ TƯ VẤN CÁC DỊCH VỤ AI
Hỗ trợ tư vấn, đào tạo và chuyển giao AI cho cá nhân, doanh nghiệp và tổ chức.
Nguồn tài liệu tham khảo: Bài viết được chuyển ngữ và tổng hợp từ tài liệu hỗ trợ chính thức của OpenAI Help Center (ChatGPT): https://help.openai.com/en/articles/20001250-set-up-the-databricks-app-template-in-chatgpt ↗
Bản quyền nội dung gốc thuộc về OpenAI. Bản dịch tiếng Việt phục vụ mục đích học tập và tra cứu cộng đồng trên vMixGPT.
Chat Zalo Chat Zalo
Gọi ngay Chat