Sử 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 ứng dụng Databricks Genie bằng OAuth tích hợp sẵn hoặc ứng dụng khách OAuth của tổ chức.
OAuth tích hợp sẵn: Khi tùy chọn này có trong ChatGPT và đã được bật cho không gian làm việc Databricks của bạn, hãy sử 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 ID hoặc mã bí mật của ứng dụng khách. Làm theo phần OAuth tích hợp sẵn bên dưới.
Ứng dụng khách OAuth tùy chỉnh: Sử 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 sử dụng ứng dụng khách OAuth riêng. Làm theo phần Ứng dụng khách OAuth tùy chỉnh bên dưới.
Bạn đang thiết lập gì
Bạn đang tạo 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 yêu cầu thông tin nhà cung cấp Databricks mà ChatGPT đề nghị bạn cung cấp, cùng quyền truy cập các tài nguyên bạn dự định sử dụng. Nếu sử dụng ứng dụng khách OAuth tùy chỉnh, bạn cũng cần chuẩn bị:
Một kết nối ứng dụng OAuth Databricks được tạo trong Bảng điều khiển tài khoản Databricks.
ID và mã bí mật của ứng dụng khách OAuth Databricks.
URL gọi lại được sao chép chính xác từ ChatGPT.
Các phạm vi Databricks phù hợp với những tính năng ứng dụng bạn muốn bật.
Mọi thông tin nhà cung cấp Databricks được yêu cầu trong quy trình thiết lập ChatGPT, chẳng hạn như máy chủ của không gian làm việc, máy chủ tài khoản, ID tài khoản hoặc kho dữ liệu.
Trước khi bắt đầu
Để thiết lập cho không gian làm việc, hãy mở bảng điều khiển quản trị, chọn không gian làm việc ChatGPT mong muốn rồi mở mục Plugin. Chọn Quản lý ứng dụng cũ để mở trang Ứng dụng được giữ lại. Để tìm hiểu cách điều hướng trong không gian làm việc và truy cập ứng dụng cũ, hãy xem Các biện pháp quản trị, bảo mật và tuân thủ cho plugin và ứng dụng.
Bạn cần:
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.
Nếu sử dụng ứng dụng khách OAuth tùy chỉnh, bạn cần 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 phải được cấu hình từ Bảng điều khiển tài khoản Databricks. Với OAuth tích hợp sẵn, quản trị viên Databricks phải kiểm tra để đảm bảo ứng dụng ChatGPT có sẵn và đã được bật cho không gian làm việc của bạn.
Nếu sử dụng ứng dụng khách OAuth tùy chỉnh, bạn cần mở Bảng điều khiển tài khoản Databricks trong một tab riêng.
Nếu sử dụng ứng dụng khách OAuth tùy chỉnh, bạn cần mở màn hình kết nối Databricks Genie trong ChatGPT để có thể sao chép chính xác URL gọi lại.
Xác định những tính năng ứng dụng cần có: Genie và bảng điều khiển AI/BI, quyền truy cập API Databricks rộng hơn, hoặc chỉ các API Databricks SQL. Quyền truy cập chỉ dành cho SQL không đủ cho các thao tác với Genie hoặc bảng điều khiển.
Nếu sử dụng ứng dụng khách OAuth tùy chỉnh, bạn cần một nơi an toàn để xử lý mã bí mật của ứng dụng khách 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, cơ chế kiểm soát lưu lượng vào theo 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 quản trị viên Databricks có thể cho phép các dải IP đầu ra hiện tại của ứng dụng ChatGPT.
Nếu sử dụng ứng dụng khách OAuth tùy chỉnh, hãy sao chép chính xác URL gọi lại hiển thị trong ChatGPT.
Các giá trị cần chuẩn bị
Với ứng dụng khách OAuth tùy chỉnh, URL gọi lại: sao chép giá trị này từ quy trình thiết lập ứng dụng trong ChatGPT.
Với ứng dụng khách OAuth tùy chỉnh, ID ứng dụng khách OAuth Databricks.
Với ứng dụng khách OAuth tùy chỉnh, mã bí mật của ứng dụng khách OAuth Databricks.
Với ứng dụng khách OAuth tùy chỉnh, các phạm vi truy cập Databricks phù hợp với tính 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,dashboardsvàoffline_access, hãy chuẩn bị các phạm vi đó. TẤT CẢ API (all-apiscùng vớioffline_access) vẫn là phương án thay thế cũ có phạm vi rộng hơn. Chỉ sử dụng SQL cho ứng dụng giới hạn ở các API Databricks SQL.Các trường thông tin về không gian làm việc hoặc tài khoản Databricks được yêu cầu trong quy trình thiết lập ChatGPT.
OAuth tích hợp sẵn
Trước tiên, hãy đáp ứng các điều kiện tiên quyết ở trên. Chỉ sử 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.
Nhờ quản trị viên Databricks kiểm tra xem ứng dụng ChatGPT có trong phần cài đặt tích hợp ứng dụng của Bảng điều khiển tài khoản và đã được bật cho không gian làm việc của bạn hay chưa. Nếu ứng dụng ChatGPT không có trong Bảng điều khiển tài khoản Databricks, hãy liên hệ với đại diện phụ trách tài khoản Databricks để hỏi xem tính năng này có sẵn cho tài khoản của bạn hay không.
Trong ChatGPT, chuyển sang tài khoản hoặc không gian làm việc cần sử dụng ứng dụng. Vào Cài đặt > Plugin để thiết lập cho cá nhân, hoặc vào Bảng điều khiển quản trị > Plugin với vai trò quản trị viên hay chủ sở hữu không gian làm việc để thiết lập cho không gian làm việc.
Chọn Databricks Genie, rồi chọn Thêm kết nối ứng dụng.
Nhập Tên máy chủ của không gian làm việc (bắt buộc), không kèm
https://hoặc đường dẫn URL.ChatGPT xác định điểm cuối Genie MCP trong 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 điểm cuối MCP riêng theo khu vực.Chọn Tiếp tục, rồi đă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 mục Kết nối và kiểm thử, Quản lý quyền truy cập bên dưới, bao gồm kiểm thử 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.
Ứng dụng khách OAuth tùy chỉnh
Trước tiên, hãy đáp ứng các điều kiện tiên quyết ở trên. Sử dụng cách này nếu OAuth tích hợp sẵn không khả dụng hoặc tổ chức của bạn yêu cầu dùng ứng dụng khách OAuth 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 thử, 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
Trong ChatGPT, chuyển sang tài khoản hoặc không gian làm việc cần sử dụng ứng dụng.
Vào Cài đặt > Plugin để thiết lập cho cá nhân, hoặc vào Bảng điều khiển quản trị > Plugin với vai trò quản trị viên hay chủ sở hữu không gian làm việc để thiết lập cho không gian làm việc.
Chọn Databricks Genie trong Danh mục.
Chọn Thêm kết nối ứng dụng.
Trong hộp thoại Kết nối Databricks Genie, tìm các trường ID ứng dụng khách OAuth và Khóa bí mật của ứng dụng khách OAuth. Nhập thông tin xác thực vào các trường đang hiển thị này chính là quy trình dùng ứng dụng khách tùy chỉnh; không cần chọn thêm tùy chọn riêng.
Sao chép URL gọi lại từ ChatGPT. Giữ hộp thoại này mở.
Ví dụ về URL gọi lại:
https://chatgpt.com/connector/oauth/<callback_id>
Không xóa ID gọi lại, thêm dấu gạch chéo ở cuối hoặc thay bằng URL ChatGPT chung. URL đăng ký trong Databricks phải khớp chính xác với URL gọi lại hiển thị trong ChatGPT.
Tạo kết nối ứng dụng OAuth tùy chỉnh trong Databricks
Mở Bảng điều khiển tài khoản Databricks cho tài khoản Databricks của bạn.
Trong thanh bên trái, mở Cài đặt.
Mở tab Kết nối ứng dụng.
Chọn Thêm kết nối.
Nhập tên ứng dụng, chẳng hạn như ChatGPT Databricks.
Trong URL chuyển hướng, dán chính xác URL gọi lại đã sao chép từ ChatGPT.
Trong mục Phạm vi truy cập, chọn các phạm vi mà ứng dụng cần.
Với kết nối Genie/bảng điều khiển mới hiển thị
ai-gateway,dashboardsvàoffline_accesstrong ChatGPT, hãy cho phép đúng các phạm vi đó trên ứng dụng OAuth của Databricks.TẤT CẢ API vẫn là phương án thay thế cũ có phạm vi rộng hơn để truy cập các API Databricks nói chung. Với cấu hình này, hãy sử dụng
all-apisvàoffline_accesstrong ChatGPT, đồng thời đảm bảo ứng dụng OAuth của Databricks cho phép cả hai. Với kết nối Genie/bảng điều khiển mới, hãy ưu tiên các phạm vi chi tiết được hiển thị.Chỉ sử dụng SQL cho ứng dụng giới hạn ở các API Databricks SQL. Quyền truy cập chỉ dành cho SQL không đủ cho các thao tác với Genie hoặc bảng điều khiển.
Đảm bảo mọi phạm vi được liệt kê trong ChatGPT ở bước sau đề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 người dùng.
Giữ thời gian hiệu lực (TTL) của token theo mặc định của Databricks, trừ khi tổ chức của bạn có chính sách riêng: 60 phút cho token truy cập và 10080 phút cho token làm mới.
Bật Tạo mã bí mật cho ứng dụng khách. ChatGPT cần ứng dụng khách OAuth có khả năng giữ bí mật thông tin xác thực cho quy trình này.
Tạo kết nối.
Sao chép thông tin xác thực từ Databricks
Trong hộp thoại Đã tạo kết nối, sao chép ID ứng dụng khách.
Sao chép ngay Mã bí mật của ứng dụng khách và lưu trữ an toàn.
Nếu đóng hộp thoại trước khi sao chép mã bí mật, hãy tạo hoặc thay mới thông tin xác thực của ứng dụng OAuth rồi sử dụng mã bí mật mới.
Databricks chỉ hiển thị mã bí mật một lần. Bảo vệ mã này như 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
Quay lại hộp thoại Kết nối Databricks Genie.
Nhập ID ứng dụng khách Databricks vào ID ứng dụng khách OAuth.
Nhập khóa bí mật của ứng dụng khách Databricks vào Khóa bí mật của ứng dụng khách OAuth.
Khi nhập các thông tin xác thực này, bạn sẽ sử dụng ứng dụng khách OAuth tùy chỉnh mà không cần chọn thêm tùy chọn riêng.
Trong Phạm vi (không bắt buộc), nhập các phạm vi cần thiết cho điểm cuối Databricks và các chức năng của ứng dụng. Đảm bảo các phạm vi này khớp với những phạm vi đã bật trên ứng dụng OAuth Databricks.
Với kết nối Genie/bảng điều khiển mới hiển thị
ai-gateway,dashboardsvàoffline_access, hãy giữ nguyên các phạm vi đó. Đảm bảo ứng dụng OAuth Databricks cho phép các phạm vi tương ứng.ai-gatewaycho phép kết nối Genie MCP trong không gian làm việc,dashboardscho phép các thao tác trên bảng điều khiển AI/BI vàoffline_accesscho phép sử dụng token làm mới.Phương án cũ với phạm vi rộng hơn,
all-apisvàoffline_access, vẫn được hỗ trợ để truy cập API rộng hơn nhưng không phải lựa chọn ư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épall-apis, hãy cập nhật hoặc tạo lại ứng dụng để cho phépai-gateway,dashboardsvàoffline_access. Nếu không có các phạm vi chi tiết, hãy chủ động đặt phạm vi trong ChatGPT thànhall-apisvàoffline_access, đồng thời đảm bảo ứng dụng Databricks cho phép cả hai. Không yêu cầu ba phạm vi chi tiết trong ChatGPT khi ứng dụng Databricks chỉ cho phépall-apis.Nhập mỗi phạm vi trên một dòng hoặc phân tách các phạm vi bằng dấu phẩy. Mọi phạm vi được liệt kê trong ChatGPT đều phải được bật trên ứng dụng OAuth Databricks.
Nhập Tên máy chủ của không gian làm việc (bắt buộc), không kèm https:// hoặc đường dẫn URL. Điền mọi trường bắt buộc khác của nhà cung cấp Databricks được hiển thị trong quy trình thiết lập.
ChatGPT xác định điểm cuối Genie MCP trong 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 điểm cuối MCP riêng theo khu vực.Chọn Tiếp tục.
ChatGPT chỉ yêu cầu đúng các phạm vi đã nhập trong Phạm vi (không bắt buộc). ChatGPT không tự động thêm các phạm vi rộng hơn từ mẫu.
Kết nối và kiểm tra
Dù chọn cách thiết lập OAuth nào, hãy hoàn tất các bước kiểm tra kết nối và quyền truy cập sau đây.
Xem lại thông tin ứng dụng, các thao tác và cài đặt xác thực.
Nếu bạn là quản trị viên không gian làm việc, hãy bật ứng dụng cho không gian làm việc và cấu hình những người được sử dụng theo chính sách của không gian làm việc.
Bắt đầu quy trình kết nối từ ChatGPT bằng tài khoản người dùng thử nghiệm được phép truy cập, rồi đăng nhập vào Databricks.
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.
Xem lại các phạm vi được yêu cầu, rồi chọn Cấp quyền.
Xác minh rằng trình duyệt quay lại ChatGPT và ứng dụng hiển thị trạng thái đã kết nối.
Chạy một thao tác đọc ít rủi ro phù hợp với các tính năng của kết nối. Với kết nối Genie, hãy gửi yêu cầu đến Genie về dữ liệu mà người dùng thử nghiệm được phép truy cập. Với các tính 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 các phạm vi OAuth không cấp quyền truy cập dữ liệu.
Nếu các thao tác ghi đã được bật, hãy thử nghiệm bằng một quy trình Databricks được xác định rõ là ít rủi ro trước khi triển khai rộng hơn.
Khi thiết lập cho không gian làm việc, hãy nhờ một thành viên được phép truy cập nhưng không có quyền quản trị viên kết nối và thực hiện lại phép thử ít rủi ro.
Quản lý quyền truy cập
Cả Databricks và ChatGPT đều tham gia kiểm soát quyền truy cập.
Trong ChatGPT, quản trị viên không gian làm việc quyết định ứng dụng có được cung cấp hay không và cách các thành viên có thể sử dụng. Với Business, quản trị viên quyết định có bật ứng dụng cho toàn bộ không gian làm việc hay không. Xem các tùy chọn quản trị ứng dụng Databricks (Cài đặt không gian làm việc > Ứng dụng hoặc Bảng điều khiển quản trị > Plugin > Quản lý ứng dụng cũ) để kiểm tra:
Quyền truy cập của người dùng, để cấu hình những vai trò trong không gian làm việc được sử dụng ứng dụng tại các không gian làm việc Enterprise và Edu được hỗ trợ.
Kiểm soát thao tác, để cấu hình những thao tác Databricks được bật.
Quyền ứng dụng, để cấu hình khi nào ChatGPT hỏi ý kiến thành viên trước khi sử dụng ứng dụng.
Các quyền ứng dụng này áp dụng cho cuộc trò chuyện trong ChatGPT. Các tác nhân trong không gian làm việc sử dụng những tùy chọn kiểm soát riêng do người tạo tác nhân thiết lập để xác định các thao tác ứng dụng được phép thực hiện và khi nào cần yêu cầu người dùng cuối phê duyệt. Để tìm hiểu cách tác nhân hoạt động, hãy xem: Tác nhân trong không gian làm việc ChatGPT dành cho Enterprise và Business.
Trong Databricks, quản trị viên quyết định những người dùng được phép cấp quyền cho ứng dụng OAuth và các tài nguyên Databricks mà họ được truy cập. Các quyền do nhà cung cấp quy định vẫn áp dụng sau khi ứng dụng được bật trong ChatGPT.
Để tìm hiểu 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, hãy xem: Các biện pháp quản trị, bảo mật và tuân thủ trong ứng dụng.
Khắc phục sự cố khi thiết lập ứng dụng Databricks
URI chuyển hướng không khớp: Nếu bạn sử dụng ứng dụng khách OAuth tùy chỉnh, hãy xác nhận rằng giá trị URL chuyển hướng trong Databricks khớp hoàn toàn với URL gọi lại hiển thị trong ChatGPT, bao gồm cả đường dẫn và ID gọi lại. Không xóa ID gọi lại, thêm dấu gạch chéo ở cuối hoặc thay bằng URL chuyển hướng ChatGPT khác.
Thiếu mã bí mật: Nếu bạn sử dụng ứng dụng khách OAuth tùy chỉnh, hãy lưu ý rằng mã bí mật của Databricks chỉ hiển thị một lần. Tạo mã bí mật mới cho ứng dụng khách nếu bạn chưa sao chép mã cũ.
Ứng dụng OAuth chưa dùng được ngay: Theo Databricks, các bản cập nhật ứng dụng OAuth có thể mất đến 30 phút để xử lý.
Phạm vi không đủ hoặc không khớp: Nếu bạn sử dụng ứng dụng khách OAuth tùy chỉnh, hãy so sánh Phạm vi (không bắt buộc) trong ChatGPT với Phạm vi truy cập trên ứng dụng OAuth của Databricks. Mọi phạm vi mà ChatGPT yêu cầu đều phải được bật trên ứng dụng đó. Xác nhận rằng các phạm vi hỗ trợ điểm cuối và những tính 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,dashboardsvàoffline_access, hãy giữ các phạm vi đó trong ChatGPT và đảm bảo ứng dụng Databricks cho phép cả ba. Nếu ứng dụng chỉ cho phépall-apis, hãy cập nhật hoặc tạo lại ứng dụng để cho phép ba phạm vi chi tiết đó.Nếu không có các phạm vi chi tiết, hãy dùng phương án thay thế có phạm vi rộng hơn được hỗ trợ: đặt phạm vi trong ChatGPT thành
all-apisvàoffline_access, đồng thời đảm bảo ứng dụng Databricks cho phép cả hai. Ứng dụng chỉ cho phépall-apiskhông đáp ứng yêu cầu của ChatGPT vềai-gateway,dashboardsvàoffline_access. Quyền truy cập chỉ dành cho SQL chỉ phù hợp với ứng dụng giới hạn ở các API Databricks SQL; quyền này không đủ cho các thao tác với 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 ở các API Databricks SQL, hãy kiểm tra phạm vi SQL, cấu hình kho dữ liệu và quyền trong Databricks.
Sai không gian làm việc ChatGPT: Tạo và bật ứng dụng trong đúng không gian làm việc ChatGPT mà người dùng sẽ kết nối ứng dụng.
Sai tài khoản hoặc không gian làm việc Databricks: Kiểm tra giá trị Tên máy chủ của không gian làm việc (bắt buộc), sau đó đăng nhập lại 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 cấp quyền cho ứng dụng OAuth. Với Business, hãy xác nhận rằng ứng dụng đã được bật cho toàn bộ không gian làm việc. Trong các không gian làm việc Enterprise và Edu được hỗ trợ, hãy xác nhận thêm rằng mục Quyền truy cập của người dùng trong ChatGPT cho phép sử dụng ứng dụng.
Chính sách mạng của Databricks chặn ứng dụng: 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 truy cập của tài khoản hoặc không gian làm việc liên quan, cơ chế kiểm soát lưu lượng vào theo ngữ cảnh, tường lửa hoặc các quy tắc mạng khác do khách hàng quản lý.
Cho phép kết nối đến từ các dải IP đầu ra hiện tại của ứng dụng 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 quản lý. Danh sách này tách biệt với danh sách IP được phép truy cập không gian làm việc ChatGPT.
Các dải IP đã công bố có thể thay đổi. Tự động hóa việc cập nhật từ tệp JSON khi có thể.
Không thay mã bí mật của ứng dụng khách hoặc thay đổi phạm vi OAuth để tìm cách vượt qua việc chặn mạng. Trước tiên, hãy xác nhận xem Databricks có đang từ chối các IP nguồn của ứng dụng hay không.