OpenAI
Trang này được dịch bằng máy học. Xem bài viết gốc bằng tiếng Anh.

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

Tìm hiểu cách quản trị viên không gian làm việc có thể cấu hình mẫu ứng dụng GitHub Enterprise trong ChatGPT bằng Ứng dụng GitHub riêng của tổ chức.

Đã cập nhật: 9 hours ago

Tổng quan

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 đang thiết lập mẫu ứng dụng GitHub Enterprise cho tổ chức của mình. Mẫu không phải là ứng dụng hoàn chỉnh mà các thành viên sử dụng. Đây là quy trình thiết lập giúp tạo bản nháp ứng dụng riêng cho không gian làm việc sau khi bạn cung cấp cấu hình GitHub Enterprise cần thiết.

Với GitHub Enterprise, quá trình thiết lập sẽ kết nối ChatGPT với máy chủ GitHub Enterprise của tổ chức bạn. Bạn tạo một GitHub App, đăng ký URL gọi lại của ChatGPT, tạo thông tin xác thực rồi dán các giá trị đó vào quy trình thiết lập mẫu trong ChatGPT. Sau khi ChatGPT tạo bản nháp ứng dụng, bạn có thể xuất bản và quản lý ứng dụng đó như các ứng dụng khác trong không gian làm việc.

Để biết cách điều hướng trong không gian làm việc và quản lý quyền truy cập ứng dụng, xem: Các biện pháp 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 đang thiết lập gì

Bạn đang tạo một ứng dụng GitHub Enterprise riêng cho không gian làm việc trong ChatGPT. Ứng dụng sử dụng:

  • Một GitHub App được đăng ký trên máy chủ GitHub Enterprise của bạn.

  • ID ứng dụng khách và bí mật ứng dụng khách của GitHub App để người dùng ủy quyền qua OAuth.

  • Khóa riêng tư của GitHub App để ChatGPT có thể tạo mã thông báo cho bản cài đặt nhằm thực hiện các thao tác trên kho lưu trữ.

  • Bí mật webhook và URL webhook để GitHub Enterprise có thể gửi các sự kiện về bản cài đặt và kho lưu trữ về ChatGPT.

  • Tên máy chủ GitHub Enterprise của bạn, chẳng hạn như github.example.com.

Hãy tạo một GitHub App, không phải GitHub OAuth App độc lập. Quá trình thiết lập mẫu trong ChatGPT yêu cầu thông tin xác thực GitHub App, khóa riêng tư và cài đặt webhook.

Trước khi bắt đầu

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.

  • Quyền quản trị viên GitHub Enterprise hoặc chủ sở hữu tổ chức, cho phép tạo và cài đặt GitHub App.

  • Chỉ tên máy chủ GitHub Enterprise, không kèm https:// hay đường dẫn.

  • Xác định những hành động trên kho lưu trữ mà ChatGPT cần hỗ trợ, chẳng hạn như tìm kiếm kho lưu trữ ở chế độ chỉ đọc, quy trình xử lý pull request, quy trình xử lý vấn đề, chỉnh sửa tệp, GitHub Actions hoặc các quy trình Codex có phạm vi rộng hơn.

  • Một nơi an toàn để xử lý khóa riêng tư và bí mật ứng dụng khách của GitHub App.

Giữ ChatGPT và GitHub Enterprise mở trong các tab riêng biệt. Không tự đặt URL gọi lại. 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ị

  • Tên máy chủ GitHub Enterprise: ví dụ: github.example.com.

  • URL gọi lại: sao chép từ quy trình thiết lập mẫu trong ChatGPT.

  • ID ứng dụng khách của GitHub App.

  • Bí mật ứng dụng khách của GitHub App.

  • Khóa riêng tư của GitHub App ở định dạng PEM.

  • Bí mật webhook do ChatGPT tạo.

  • URL webhook được tạo sau khi bản nháp ứng dụng được tạo trong ChatGPT.

Bắt đầu thiết lập mẫu trong ChatGPT

  1. Trong ChatGPT, chuyển sang không gian làm việc mà bạn muốn cung cấp ứng dụng.

  2. Mở Cài đặt không gian làm việc > Ứng dụng. Bạn cũng có thể vào 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ở Plugin. Chọn Quản lý ứng dụng cũ để mở trang Ứng dụng được giữ lại.

  3. Chọn Danh mục.

  4. Tìm GitHub Enterprise.

  5. Chọn mẫu ứng dụng GitHub Enterprise rồi bắt đầu thiết lập.

  6. Nhập tên và mô tả rõ ràng cho ứng dụng, chẳng hạn như GitHub Enterprise hoặc GitHub Enterprise - Kỹ thuật.

  7. Nhập tên máy chủ GitHub Enterprise, chẳng hạn như github.example.com.

  8. Sao chép URL gọi lại hiển thị trong ChatGPT. Giữ tab này mở.

  9. Sao chép bí mật webhook được tạo nếu giá trị này hiển thị trong quá trình thiết lập.

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 URL này bằng URL ChatGPT chung.

Tạo GitHub App trong GitHub Enterprise

  1. Truy cập máy chủ GitHub Enterprise của bạn, chẳng hạn như https://github.example.com.

  2. Đi đến tổ chức hoặc tài khoản sẽ sở hữu ứng dụng.

  3. Mở Cài đặt > Cài đặt dành cho nhà phát triển > GitHub Apps.

  4. Chọn GitHub App mới.

  5. Nhập tên rõ ràng cho ứng dụng, chẳng hạn như Trình kết nối GitHub Enterprise cho ChatGPT.

  6. Nhập URL trang chủ. Nếu không có trang nội bộ riêng, hãy dùng URL của tổ chức trên GitHub Enterprise.

  7. Trong mục URL gọi lại, dán chính xác URL gọi lại đã sao chép từ ChatGPT.

  8. Giữ tùy chọn Hết hạn mã thông báo ủy quyền của người dùng ở trạng thái bật, trừ khi đội ngũ bảo mật của bạn có lý do cụ thể để thay đổi.

  9. Bật Yêu cầu người dùng ủy quyền trong quá trình cài đặt để người dùng có thể ủy quyền cho ứng dụng trong quy trình cài đặt hoặc kết nối.

  10. Trong mục Có thể cài đặt GitHub App này ở đâu?, chọn tùy chọn có phạm vi hẹp nhất phù hợp với kế hoạch triển khai của bạn.

  11. Tạo GitHub App.

Cấu hình quyền và sự kiện

Chọn các quyền tối thiểu cần thiết cho những hành động ChatGPT mà bạn dự định bật.

Để tìm kho lưu trữ và hỏi đáp ở chế độ chỉ đọc, hãy bắt đầu với các quyền đọc như:

  • Siêu dữ liệu: chỉ đọc. GitHub yêu cầu quyền truy cập siêu dữ liệu đối với GitHub App.

  • Nội dung: chỉ đọc, để truy cập tệp và nội dung kho lưu trữ.

  • Vấn đề: chỉ đọc, nếu cần tìm kiếm hoặc đọc vấn đề.

  • Pull request: chỉ đọc, nếu cần tìm kiếm pull request hoặc lấy ngữ cảnh phục vụ việc rà soát.

  • Hành động: chỉ đọc, nếu cần trạng thái chạy quy trình, tác vụ, nhật ký hoặc sản phẩm đầu ra.

Với các quy trình có thao tác ghi, chỉ thêm quyền ghi ở những mục cần thiết, chẳng hạn như Nội dung, Pull request, Vấn đề, Hành động hoặc Quy trình. Sử dụng phạm vi quyền hẹp nhất vẫn hỗ trợ được các hành động ChatGPT dự kiến.

Các sự kiện webhook phải phù hợp với các quy trình mà bạn hỗ trợ. Các sự kiện thường dùng bao gồm Cài đặt, Kho lưu trữ của bản cài đặt, Đẩy, Pull request, Vấn đề, Bình luận về vấn đề, Lần chạy quy trình và Tác vụ trong quy trình.

Tạo và sao chép thông tin xác thực GitHub App

  1. Trong phần cài đặt GitHub App, sao chép ID ứng dụng khách.

  2. Tạo Bí mật ứng dụng khách rồi sao chép ngay.

  3. Trong mục Khóa riêng tư, tạo một khóa riêng tư.

  4. Tải tệp .pem xuống và lưu trữ an toàn.

  5. Mở tệp .pem trên máy của bạn rồi sao chép toàn bộ văn bản PEM, bao gồm cả dòng bắt đầu và dòng kết thúc.

Khóa riêng tư là thông tin nhạy cảm. Hãy bảo vệ khóa này như thông tin xác thực. Nếu khóa bị lộ, hãy tạo khóa riêng tư mới, cập nhật thiết lập ứng dụng trong ChatGPT rồi xóa khóa bị lộ trong GitHub Enterprise.

Hoàn tất thiết lập trong ChatGPT

  1. Quay lại tab thiết lập mẫu trong ChatGPT.

  2. Dán ID ứng dụng khách của GitHub App vào ID ứng dụng khách OAuth.

  3. Dán bí mật ứng dụng khách của GitHub App vào Bí mật ứng dụng khách OAuth.

  4. Giữ nguyên Phạm vi, trừ khi tổ chức của bạn chủ động muốn ghi đè các giá trị mặc định của mẫu.

  5. Xác nhận rằng tên máy chủ GitHub Enterprise chỉ chứa tên máy chủ, chẳng hạn như github.example.com.

  6. Dán hoặc tải lên khóa riêng tư của GitHub App ở định dạng PEM vào mục Khóa riêng tư của GitHub App.

  7. Xác nhận rằng bí mật webhook được tạo đã có trong mục tương ứng.

  8. Tạo bản nháp ứng dụng.

  9. Mở phần chi tiết của bản nháp ứng dụng vừa tạo trong ChatGPT rồi sao chép URL webhook được tạo.

URL webhook phải có dạng: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Hoàn tất thiết lập webhook trong GitHub Enterprise

  1. Quay lại phần cài đặt GitHub App trong GitHub Enterprise.

  2. Mở phần Cài đặt chung của GitHub App.

  3. Bật tùy chọn Kích hoạt webhook nếu chưa bật.

  4. Dán URL webhook của ChatGPT vào mục URL webhook.

  5. Dán bí mật webhook của ChatGPT vào mục Bí mật webhook.

  6. Giữ xác minh SSL ở trạng thái bật.

  7. Xác nhận rằng các sự kiện webhook đã đăng ký nhận phù hợp với những quyền và hành động bạn đã bật.

  8. Lưu thay đổi.

Xuất bản và quản lý ứng dụng trong ChatGPT

Việc tạo bản nháp ứng dụng không tự động cho phép các thành viên sử dụng ứng dụng đó. Sau khi kiểm tra bản nháp:

  1. Xuất bản bản nháp ứng dụng.

  2. Trong Cài đặt không gian làm việc, mở trang Ứng dụng, mở mục Đã bật rồi xác nhận rằng ứng dụng xuất hiện. Bạn cũng có thể mở trang Ứng dụng bằng cách chọn Quản lý ứng dụng cũ trong Bảng điều khiển quản trị > Plugin.

  3. Cấu hình Quyền truy cập của người dùng cho các vai trò cần sử dụng ứng dụng.

  4. Kiểm tra Kiểm soát hành động đối với các hành động đọc và ghi.

  5. Kiểm tra Quyền ứng dụng để chọn thời điểm ChatGPT hỏi ý kiến thành viên trước khi sử dụng ứng dụng.

  6. Yêu cầu một người dùng thử nghiệm được cấp quyền mở Ứng dụng trong ChatGPT và xác nhận rằng ứ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 trong ChatGPT. Các tác nhân trong không gian làm việc sử dụng các thiết lập kiểm soát riêng do người xây dựng từng tác nhân đặt ra để xác định những hành động ứng dụng nào có thể sử dụng và khi nào cần yêu cầu người dùng cuối phê duyệt. Để biết cách tác nhân hoạt động, xem: Tác nhân trong không gian làm việc ChatGPT dành cho Enterprise và Business.

Cài đặt và thử nghiệm GitHub App

  1. Trong GitHub Enterprise, cài đặt ứng dụng GitHub cho tổ chức hoặc tài khoản.

  2. Chọn tất cả kho lưu trữ hoặc một số kho lưu trữ cụ thể 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 bằng tài khoản người dùng được cấp quyền.

  4. Ủy quyền cho ứng dụng GitHub khi được nhắc.

  5. Trước tiên, thực hiện một hành động đọc đơn giản, chẳng hạn như liệt kê các kho lưu trữ có thể truy cập hoặc lấy một pull request đã biết.

  6. Nếu các hành động ghi được bật, hãy thử nghiệm trên một kho lưu trữ ít rủi ro trước khi triển khai rộng hơn.

Tên máy chủ và cách OAuth hoạt động

ChatGPT dùng tên máy chủ để xác định các điểm cuối GitHub Enterprise. Chỉ nhập tên máy chủ, chẳng hạn như github.example.com hoặc octocorp.ghe.com.

Không nhập đường dẫn API, đường dẫn kho lưu trữ hoặc github.com, trừ khi đó chính xác là máy chủ GitHub Enterprise dùng cho ứng dụng này.

Khắc phục sự cố

  • URI chuyển hướng không khớp: xác nhận rằng URL gọi lại của GitHub App khớp chính xác với URL gọi lại hiển thị trong ChatGPT.

  • ChatGPT không thể tạo hoặc lưu bản nháp ứng dụng: xác nhận rằng tất cả các trường bắt buộc đã được điền, bao gồm tên máy chủ, ID ứng dụng khách OAuth, Bí mật ứng dụng khách OAuth, khóa riêng tư và bí mật webhook.

  • Xác thực thành công nhưng các lệnh gọi đến kho lưu trữ thất bại: xác nhận rằng GitHub App đã được cài đặt và có quyền truy cập kho lưu trữ.

  • API trả về lỗi 403 hoặc không đủ quyền: thêm quyền còn thiếu cho GitHub App và yêu cầu chủ sở hữu bản cài đặt phê duyệt các quyền đã cập nhật nếu được nhắc.

  • Không có kho lưu trữ nào xuất hiện: xác nhận rằng bản cài đặt ứng dụng bao gồm các kho lưu trữ mong muốn và người dùng thực hiện ủy quyền trong ChatGPT có quyền truy cập các kho đó.

  • Gửi webhook thất bại: xác nhận rằng URL webhook và bí mật webhook khớp với các giá trị từ ChatGPT, giữ xác minh SSL ở trạng thái bật và đảm bảo máy chủ GitHub Enterprise có thể kết nối đến connectors.api.openai.org.

  • Lỗi khóa riêng tư: xác nhận rằng bạn đã sao chép toàn bộ nội dung PEM, bao gồm cả dòng bắt đầu và dòng kết thúc.

Tài liệu tham khảo

Bài viết này có hữu ích không?