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 đang thiết lập mẫu ứng dụng Databricks cho tổ chức của mình. Mẫu không phải là ứng dụng cuối cùng mà các thành viên sử dụng. Đó là một luồng thiết lập tạo ứng dụng nháp dành riêng cho không gian làm việc sau khi bạn cung cấp cấu hình Databricks bắt buộc.
Với Databricks, phần lớn quá trình thiết lập diễn ra trong Databricks Account Console. Bạn tạo kết nối ứng dụng OAuth tùy chỉnh, đăng ký URL gọi lại của ChatGPT, sao chép thông tin xác thực máy khách đã tạo, rồi dán các giá trị đó vào luồng thiết lập mẫu của ChatGPT. Sau khi ChatGPT tạo ứng dụng nháp, bạn có thể phát hành và quản lý ứng dụng đó như các ứng dụng khác trong không gian làm việc.
Bạn đang thiết lập gì
Bạn đang tạo một ứng dụng Databricks dành riêng cho không gian làm việc trong ChatGPT. Ứng dụng sử dụng:
Kết nối ứng dụng Databricks OAuth được tạo trong Databricks Account Console của bạn.
ID máy khách và bí mật máy khách OAuth của Databricks.
URL gọi lại chính xác được sao chép từ ChatGPT.
Các phạm vi Databricks khớp với những khả năng của trình kết nối mà bạn muốn bật.
Mọi chi tiết nhà cung cấp Databricks mà luồng thiết lập ChatGPT yêu cầu, chẳng hạn như máy chủ 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
Bạn cần:
Quyền truy cập quản trị viên hoặc chủ sở hữu không gian làm việc ChatGPT.
Quyền truy cập quản trị viên tài khoản Databricks. Quyền truy cập quản trị viên không gian làm việc có thể đủ cho một số tác vụ, nhưng các kết nối ứng dụng tùy chỉnh được cấu hình từ Databricks Account Console.
Databricks Account Console được mở trong một tab riêng.
Màn hình thiết lập mẫu ứng dụng Databricks được mở trong ChatGPT để bạn có thể sao chép URL gọi lại chính xác.
Quyết định xem ứng dụng cần quyền truy cập API Databricks chung hay chỉ quyền truy cập Databricks SQL.
Một nơi an toàn để xử lý bí mật máy khách Databricks.
Không tự tạo URL gọi lại. Sao chép URL gọi lại chính xác hiển thị trong ChatGPT.
Các giá trị cần chuẩn bị
URL gọi lại: sao chép URL này từ luồng thiết lập mẫu ChatGPT.
ID máy khách OAuth của Databricks.
Bí mật máy khách OAuth của Databricks.
Phạm vi truy cập Databricks, chẳng hạn như ALL APIs hoặc SQL.
Các trường không gian làm việc hoặc tài khoản Databricks mà luồng thiết lập ChatGPT yêu cầu.
Phát hành và quản lý ứng dụng trong ChatGPT
Việc tạo ứng dụng nháp không tự động làm cho ứng dụng đó có sẵn cho các thành viên. Sau khi xem xét bản nháp:
Phát hành ứng dụng nháp.
Xác nhận ứng dụng xuất hiện trong Cài đặt không gian làm việc > Ứng dụng > Đã bật.
Cấu hình Quyền truy cập của người dùng cho các vai trò sẽ sử dụng ứng dụng.
Xem lại Kiểm soát hành động cho các hành động Databricks mà ứng dụng cung cấp.
Xem lại Quyền của ứng dụng để chọn thời điểm ChatGPT hỏi thành viên trước khi sử dụng ứng dụng.
Yêu cầu một người dùng thử nghiệm được phép mở Ứng dụng trong ChatGPT và xác nhận ứng dụng xuất hiện.
Các quyền ứng dụng này áp dụng cho các cuộc trò chuyện ChatGPT. Tác nhân trong không gian làm việc sử dụng các biện pháp kiểm soát theo từng tác nhân do trình tạo tác nhân đặt để xác định những hành động ứng dụng nào có sẵn và khi nào người dùng cuối được yêu cầu phê duyệt chúng. Để biết hành vi của tác nhân, xem: Tác nhân trong không gian làm việc ChatGPT dành cho Enterprise và Business.
Bắt đầu thiết lập mẫu trong ChatGPT
Trong ChatGPT, chuyển sang không gian làm việc nơi ứng dụng sẽ có sẵn.
Mở Cài đặt không gian làm việc > Ứng dụng.
Chọn Thư mục.
Tìm kiếm Databricks.
Chọn mẫu ứng dụng Databricks và bắt đầu thiết lập.
Nhập tên và mô tả ứng dụng rõ ràng, chẳng hạn như Databricks hoặc Databricks - Data Platform.
Trong phần máy khách OAuth, sao chép URL gọi lại từ ChatGPT. Giữ tab này mở.
URL gọi lại ví dụ: 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 thế bằng URL ChatGPT chung.
Tạo kết nối ứng dụng OAuth trong Databricks
Mở Databricks Account Console 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 Connector.
Trong URL chuyển hướng, dán URL gọi lại chính xác đã sao chép từ ChatGPT.
Trong Phạm vi truy cập, chọn các phạm vi mà ứng dụng cần.
Sử dụng ALL APIs cho ứng dụng Databricks chung cần các API Databricks ngoài SQL.
Chỉ sử dụng SQL cho ứng dụng bị giới hạn trong các API Databricks SQL.
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ể.
Bật Tạo bí mật máy khách. ChatGPT cần một máy khách OAuth bảo mật cho luồng 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 Client ID.
Sao chép Client secret ngay lập tức và lưu trữ an toàn.
Nếu bạn đóng hộp thoại trước khi sao chép bí mật, hãy tạo hoặc xoay vòng thông tin xác thực ứng dụng OAuth và sử dụng bí mật mới.
Databricks chỉ hiển thị bí mật một lần. Hãy coi bí mật đó 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 trong ChatGPT
Quay lại tab thiết lập mẫu ChatGPT.
Dán Client ID của Databricks vào OAuth client ID.
Dán Client secret của Databricks vào OAuth client secret.
Giữ nguyên Scopes trừ khi bạn có chủ ý cần ghi đè các giá trị mặc định của mẫu.
Điền mọi trường nhà cung cấp Databricks mà luồng thiết lập yêu cầu, chẳng hạn như máy chủ không gian làm việc, máy chủ tài khoản, ID tài khoản, kho dữ liệu hoặc các giá trị khác dành riêng cho Databricks.
Tạo ứng dụng nháp.
Kiểm thử ứng dụng với tư cách người dùng
Bắt đầu luồng kết nối từ ChatGPT với tư cách người dùng thử nghiệm được phép.
Xác nhận trình duyệt mở đúng tài khoản hoặc không gian làm việc Databricks dự kiến.
Phê duyệt các phạm vi được yêu cầu.
Xác minh rằng trình duyệt quay lại ChatGPT và ứng dụng hiển thị là đã kết nối.
Trước tiên, chạy một hành động đọc có rủi ro thấp, chẳng hạn như 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.
Nếu hành động ghi được bật, hãy kiểm thử bằng một quy trình làm việc Databricks có rủi ro thấp rõ ràng trước khi triển khai rộng hơn.
Quản lý quyền truy cập
Databricks và ChatGPT đều góp phần vào việc kiểm soát quyền 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 đã phát hành có sẵn hay không, những vai trò nào trong không gian làm việc có thể sử dụng ứng dụng, những hành động nào được bật và khi nào ChatGPT hỏi người dùng trước khi sử dụng ứng dụng.
Trong Databricks, quản trị viên quản lý những người dùng nào có thể ủy quyền cho ứng dụng OAuth và những tài nguyên Databricks nào mà các người dùng đó có thể truy cập. Quyền của nhà cung cấp vẫn áp dụng sau khi ứng dụng được bật trong ChatGPT.
Khắc phục sự cố
URI chuyển hướng không khớp: xác nhận URL chuyển hướng Databricks khớp chính xác với URL gọi lại hiển thị trong ChatGPT, bao gồm đường dẫn và ID gọi lại.
Thiếu bí mật: bí mật Databricks chỉ hiển thị một lần. Tạo bí mật máy khách mới nếu chưa sao chép bí mật đó.
Ứng dụng OAuth không có sẵn ngay lập tức: Databricks cho biết các bản cập nhật ứng dụng OAuth có thể mất tối đa 30 phút để xử lý.
Phạm vi không đủ: nếu ChatGPT có thể xác thực nhưng lệnh gọi API Databricks không thành công, hãy xác nhận ứng dụng Databricks có ALL APIs khi ứng dụng cần các API không phải SQL.
Hành động SQL không thành công: xác nhận phạm vi SQL, cấu hình kho dữ liệu và quyền Databricks.
Sai không gian làm việc: tạo và phát hành ứng dụng trong cùng không gian làm việc ChatGPT nơi người dùng sẽ kết nối ứng dụng.
Người dùng không thể kết nối: xác nhận người dùng có quyền truy cập Databricks và được phép ủy quyền cho ứng dụng OAuth.