Cài đặt mẫu ứng dụng Databricks trong ChatGPT

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 hoặc Pro đang thiết lập kết nối Databricks Genie bằng OAuth tích hợp sẵn hoặc OAuth của tổ chức bạn.

• 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 sử dụng kết nối được cấu hình sẵn. Bạn không cần tạo một ứng dụng OAuth hoặc nhập ID khách hàng hay bí mật khách hàng. Hãy làm theo phần OAuth tích hợp bên dưới.

• Khách hàng OAuth tùy chỉnh:Sử dụng đường dẫn này nếu OAuth tích hợp không khả dụng hoặc tổ chức của bạn yêu cầu client OAuth riêng. Theo dõi phần Client OAuth tùy chỉnh bên dưới.

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

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 đường dẫn đều yêu cầu thông tin nhà cung cấp Databricks được yêu cầu trong ChatGPT và quyền truy cập cho các tài nguyên mà bạn dự định sử dụng. Nếu bạn sử dụng một client OAuth tùy chỉnh, 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 của bạn.

• ID khách hàng OAuth và bí mật khách hàng của Databricks.

• URL callback chính xác sao chép từ ChatGPT.

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

• Bất kỳ chi tiết nhà cung cấp Databricks nào được yêu cầu bởi quy trình thiết lập ChatGPT, chẳng hạn như máy chủ workspace, máy chủ tài khoản, ID tài khoản hoặc kho dữ liệu.

Trước khi bạn bắt đầu

Để thiết lập 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 và mở phần Plugin. Chọn Quản lý Ứng dụng Cũ để mở trang ứng dụng được giữ lại. Để điều hướng không gian làm việc và truy cập ứng dụng cũ, xemQuản lý của quản trị viên, bảo mật và tuân thủ cho các plugin và ứng dụng.

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, hoặc tài khoản ChatGPT Plus hoặc Pro.

• Đối với một khách hàng OAuth tùy chỉnh, cần 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ố nhiệm vụ, nhưng các kết nối ứng dụng tùy chỉnh được cấu hình từ Bảng điều khiển Tài khoản Databricks. Đối với OAuth tích hợp sẵn, một quản trị viên Databricks phải kiểm tra rằng ứ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 một client OAuth tùy chỉnh, Bảng điều khiển Tài khoản Databricks mở trong một tab riêng.

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

• Một quyết định về việc ứng dụng có cần quyền truy cập API Databricks chung hay chỉ quyền truy cập Databricks SQL.

• Đối với một client OAuth tùy chỉnh, một nơi an toàn để quản lý bí mật client 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 thông qua danh sách truy cập IP, kiểm soát luồng dựa trên ngữ cảnh, tường lửa hoặc chính sách mạng khác, cần trợ giúp từ quản trị viên Databricks có thể cho phép hiện tạiPhạm vi IP đầu ra của bộ nối ChatGPT.

Đối với một khách hàng OAuth tùy chỉnh, sao chép chính xácURL gọi lạiđược hiển thị trong ChatGPT.

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

• Đối với một khách hàng OAuth tùy chỉnh,URL gọi lại: sao chép điều này từ quy trình thiết lập kết nối ChatGPT.

• Đối với một khách hàng OAuth tùy chỉnh, ID khách hàng OAuth của Databricks.

• Đối với một khách hàng OAuth tùy chỉnh, mã bí mật khách hàng OAuth của Databricks.

• Đối với một client OAuth tùy chỉnh, phạm vi truy cập Databricks phù hợp với khả năng của ứng dụng, chẳng hạn nhưTẤT CẢ APIhoặcSQL.

• Các trường không gian làm việc hoặc tài khoản Databricks được yêu cầu bởi luồng thiết lập ChatGPT.

OAuth tích hợp sẵn

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

1. Hãy yêu cầu quản trị viên Databricks kiểm tra xem ứng dụng ChatGPT có khả dụng trong Bảng điều khiển Tài khoản khôngcài đặt tích hợp ứng dụngvà đã được bật cho không gian làm việc của bạn. Nếu ứng dụng ChatGPT không được liệt kê trong Bảng điều khiển Tài khoản Databricks của bạn, hãy liên hệ với đại diện tài khoản Databricks của bạn để hỏi xem tính năng này có sẵn 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 nên có sẵn. Đi đếnCài đặt > Tiện íchcho một thiết lập cá nhân hoặcBảng điều khiển quản trị > Pluginnhư một quản trị viên hoặc chủ sở hữu không gian làm việc cho việc thiết lập không gian làm việc.

3. ChọnDatabricks Genie, sau đó chọnThêm kết nối ứng dụng.

4. NhậpTên máy chủ không gian làm việc (bắt buộc)không cóhttps://hoặc một đường dẫn URL.

5. ChọnTiếp tục, sau đó đăng nhập vào Databricks và xem lại yêu cầu đồng ý.

Tiếp tục với 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 thành viên được phép và kiểm tra quyền truy cập không gian làm việc.

Khách hàng OAuth tùy chỉnh

Trước tiên, hoàn thành các yêu cầu cần thiết ở trên. Sử dụng đường dẫn 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 client OAuth riêng. Sau khi thiết lập xong, hoàn thành 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 mà ứng dụng nên có sẵn.

2. Đi đếnCài đặt > Tiện íchcho một thiết lập cá nhân hoặcBảng điều khiển quản trị> Tiện íchnhư một quản trị viên hoặc chủ sở hữu không gian làm việc cho việc thiết lập không gian làm việc.

3. ChọnDatabricks GenietrongThư mục.

4. ChọnThêm kết nối ứng dụng.

5. TrongKết nối Databricks Geniehộp thoại, tìm phần khách hàng OAuth.

6. Sao chépURL gọi lạitừ ChatGPT. Giữ cuộc hội thoại này mở.

Ví dụ URL gọi lại:

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

Không được xóa ID callback, thêm dấu gạch chéo ở cuối, hoặc thay thế nó bằng URL ChatGPT chung. URL đăng ký trong Databricks phải hoàn toàn khớp vớiURL gọi lạiđược hiển thị trong ChatGPT.

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

1. Mở Bảng điều khiển Tài khoản Databricks cho tài khoản Databricks của bạn.

2. Trong thanh bên trái, mởCài đặt.

3. MởKết nối ứng dụngthẻ.

4. ChọnThêm kết nối.

   

5. Nhập tên ứng dụng, chẳng hạn như ChatGPT Databricks Connector.

6. TrongChuyển hướng URL, dán chính xác URL gọi lại đã sao chép từ ChatGPT.

7. DướiPhạm vi truy cập, chọn các phạm vi mà ứng dụng cần.

8. Sử dụngTẤT CẢ APIcho một ứng dụng Databricks tổng quát cần các API của Databricks ngoài SQL.

9. Sử dụngSQLchỉ dành cho một ứng dụng giới hạn ở các API SQL của Databricks.

10. Đảm bảo mọi phạm vi được liệt kê sau này trong ChatGPT đều được kích hoạt trên ứng dụng OAuth Databricks này. Databricks tự động cho phép openid, email, profile và offline_access cho các ứng dụng được tạo trong giao diện người dùng.

11. Giữ giá trị TTL của token ở mức 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.

12. BậtTạo bí mật cho client. ChatGPT cần một client OAuth bảo mật cho luồng này.

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

Sao chép thông tin đăng nhập từ Databricks

1. TrongKết nối đã được tạohộp thoại, sao chépID khách hàng.

2. Sao chépMật khẩu khách hàngngay lập tức và lưu trữ nó một cách an toàn.

3. 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 các 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 nó như thông tin đăng nhập và không bao gồm nó trong ảnh chụp màn hình, vé hỗ trợ, bình luận hoặc trò chuyện.

Hoàn tất cài đặt OAuth tùy chỉnh trong ChatGPT

1. Quay lại vớiKết nối Databricks Geniecuộc đối thoại.

2. Nhập ID khách hàng Databricks vàoID khách hàng OAuth.

3. Nhập bí mật khách hàng Databricks vàoBí mật client OAuth.

4. TrongPhạm vi (tùy chọn), nhập các phạm vi cần thiết cho điểm cuối Databricks và các khả năng của ứng dụng của bạn. Khớp chúng với các phạm vi được bật trên ứng dụng OAuth Databricks.

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

6. NhậpTên máy chủ không gian làm việc (bắt buộc)không có https:// hoặc đường dẫn URL. Điền bất kỳ trường nhà cung cấp Databricks nào khác được yêu cầu hiển thị trong quy trình thiết lập.

7. ChọnTiếp tục.

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

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

Hoàn thành các kiểm tra kết nối và kiểm tra truy cập sau cho bất kỳ đường dẫn OAuth nào.

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

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

3. Bắt đầu luồng kết nối từ ChatGPT như 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ở tài khoản hoặc không gian làm việc Databricks như mong đợi.

5. Xem lại các phạm vi được yêu cầu, sau đó chọnỦy quyền.

   

6. Xác minh rằng trình duyệt quay trở lại ChatGPT và bộ kết nối hiển thị trạng thái đã kết nối.

7. Thực hiện một hành động đọc có rủi ro thấp trước, 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 nguồn Databricks SQL đã được phê duyệt.

8. Nếu các hành động ghi được bật, hãy thử với một luồng công việc Databricks có rủi ro rõ ràng thấp trước khi triển khai rộng rãi.

9. Để thiết lập 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 đượ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 rủi ro thấp.

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

Databricks và ChatGPT đều đóng góp 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ó sẵn hay không và cách thành viên có thể sử dụng nó. Trong Business, quản trị viên quản lý việc ứng dụng có được kích hoạt trên toàn bộ không gian làm việc hay không. Xem lại các quyền điều khiể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ũ) cho:

• Truy cập người dùng, để cấu hình những vai trò trong không gian làm việc có thể sử dụng kết nối trong các không gian làm việc Doanh nghiệp và Giáo dục được hỗ trợ.

• Kiểm soát hành động, để cấu hình các hành động Databricks nào được bật.

• Quyền ứng dụng, để cấu hình khi ChatGPT hỏi các thành viên trước khi sử dụng bộ nối.

Các quyền ứng dụng này áp dụng cho các cuộc trò chuyện của ChatGPT. Các Đại lý Workspace sử dụng các kiểm soát theo từng đại lý được thiết lập bởi người tạo đại lý để xác định các hành động của ứ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. Đối với hành vi của đại lý, xem:Các tác nhân không gian làm việc ChatGPT cho Doanh nghiệp và Kinh doanh.

Trong Databricks, các quản trị viên quản lý 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à những 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 kích hoạt trong ChatGPT.

Để điều hướng không gian làm việc, truy cập ứng dụng và các điều khiển ứng dụng theo kế hoạch, xem:Quản trị viên kiểm soát, bảo mật và tuân thủ trong ứng dụng.

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

• Sai khớp URI chuyển hướng:Nếu bạn sử dụng một khách hàng OAuth tùy chỉnh, hãy xác nhận rằng DatabricksChuyển hướng URLgiá trị khớp chính xác vớiURL gọi lạiđược hiển thị trong ChatGPT, bao gồm đường dẫn và ID callback của nó. Không được xóa ID callback, thêm dấu gạch chéo ở cuối, hoặc thay thế bằng URL chuyển hướng ChatGPT khác.

• Bí mật bị thất lạc:Nếu bạn sử dụng một client OAuth tùy chỉnh, các bí mật của Databricks chỉ được hiển thị một lần. Tạo một client secret mới nếu nó chưa được sao chép.

• Ứng dụng OAuth không có sẵn ngay lập tức:Databricks cho biết việc cập nhật ứng dụng OAuth có thể mất đến 30 phút để xử lý.

• Phạm vi không đầy đủ hoặc không khớp:Nếu bạn sử dụng một khách hàng OAuth tùy chỉnh, hãy so sánhPhạm vi (tùy chọn)trong ChatGPT vớiPhạm vi truy cậptrên ứng dụng OAuth của Databricks. Mọi phạm vi mà ChatGPT yêu cầu phải được kích hoạt tại đó. Xác nhận rằng các phạm vi hỗ trợ endpoint và các khả năng bạn sử dụng, bao gồm quyền truy cập API chung hoặc chỉ truy cập SQL khi thích hợp.

• Các hành động SQL thất bại:Xác nhậnSQLphạm vi, cấu hình kho, và quyền hạn Databricks.

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

• Tài khoản hoặc không gian làm việc Databricks sai:Xác nhậnTên máy chủ không gian làm việc (bắt buộc)giá trị, sau đó lặp lại quy trình đăng nhập và xác minh rằng Databricks mở tài khoản hoặc không gian làm việc như mong đợi.

• 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 cho ứng dụng OAuth. Trong Business, xác nhận rằng ứng dụng được bật trên 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ợ, cũng xác nhận rằng ChatGPTTruy cập người dùngcho phép kết nối.

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

  • Cho phép kết nối đến từ hiện tạiPhạm vi IP đầu ra của bộ 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. Nó tách biệt với việc liệt kê địa chỉ IP được phép của không gian làm việc ChatGPT.

  • Các phạm vi đã công bố có thể thay đổi. Tự động cập nhật từ JSON khi có thể.

  • Không xoay vòng bí mật khách hàng hoặc thay đổi phạm vi OAuth để vượt qua chặn mạng. Trước tiên hãy xác nhận xem Databricks có từ chối các địa chỉ IP nguồn của bộ kết nối hay không.

Tài liệu tham khảo

• Tài liệu Databricks: Xác thực bằng OAuth từ người dùng đến máy

• Tài liệu Databricks: Quản lý kết nối ứng dụng OAuth

• Tài liệu Databricks: Quản lý danh sách truy cập IP