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: 27 days 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 Enterprise cho tổ chức của bạn của GitHub. Mẫu không phải là ứng dụng cuối cùng mà thành viên sử dụng. Đó là 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 GitHub Enterprise bắt buộc.

Đối với GitHub Enterprise, quá trình thiết lập 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 Ứng dụng GitHub, đăng ký URL gọi lại ChatGPT, tạo thông tin xác thực, rồi dán các giá trị đó vào luồng thiết lập mẫu ChatGPT. Sau khi ChatGPT tạo ứng dụng nháp, bạn có thể xuất bản và quản lý ứng dụng đó như các ứng dụng không gian làm việc khác.

Bạn đang thiết lập gì

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

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

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

  • Khóa riêng của Ứng dụng GitHub để ChatGPT có thể tạo token cài đặt cho các thao tác trên kho lưu trữ.

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

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

Tạo Ứng dụng GitHub, không phải Ứng dụng OAuth GitHub độc lập. Thiết lập mẫu ChatGPT yêu cầu thông tin xác thực Ứng dụng GitHub, khóa riêng và cài đặt webhook.

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 GitHub Enterprise hoặc chủ sở hữu tổ chức có thể tạo và cài đặt Ứng dụng GitHub.

  • Chỉ tên máy chủ GitHub Enterprise, không có https:// hoặc đường dẫn.

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

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

Giữ ChatGPT và GitHub Enterprise mở trong các tab riêng biệt. Không tự tạo 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ừ luồng thiết lập mẫu ChatGPT.

  • ID máy khách của Ứng dụng GitHub.

  • Mã bí mật máy khách của Ứng dụng GitHub.

  • PEM khóa riêng của Ứng dụng GitHub.

  • Mã bí mật webhook do ChatGPT tạo.

  • URL webhook được tạo sau khi ứng dụng nháp đượ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 nơi ứng dụng sẽ được cung cấp.

  2. Mở Cài đặt không gian làm việc > Ứng dụng.

  3. Chọn Thư mục.

  4. Tìm kiếm GitHub Enterprise.

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

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

  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 mã bí mật webhook được tạo nếu mã 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 thế bằng URL ChatGPT chung.

Tạo Ứng dụng GitHub trong GitHub Enterprise

  1. Mở 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 > Ứng dụng GitHub.

  4. Chọn Ứng dụng GitHub mới.

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

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

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

  8. Giữ bật Hết hạn token ủy quyền người dùng trừ khi nhóm bảo mật của bạn có lý do cụ thể để thay đổi.

  9. Bật Yêu cầu ủy quyền người dùng trong khi cài đặt để người dùng có thể ủy quyền ứng dụng trong luồng cài đặt hoặc kết nối.

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

  11. Tạo Ứng dụng GitHub.

Định 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 các hành động ChatGPT mà bạn định bật.

Để khám phá kho lưu trữ chỉ đọc và Hỏi-Đáp, 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 siêu dữ liệu cho Ứng dụng GitHub.

  • 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 đề.

  • Yêu cầu hợp nhất: chỉ đọc, nếu cần tìm kiếm yêu cầu hợp nhất hoặc ngữ cảnh đánh giá.

  • Hành động: chỉ đọc, nếu cần trạng thái chạy quy trình, công việc, nhật ký hoặc hiện vật.

Đối với quy trình ghi, chỉ thêm quyền ghi khi cần, chẳng hạn như Nội dung, Yêu cầu hợp nhất, Vấn đề, Hành động hoặc Quy trình. Sử dụng các quyền hẹp nhất hỗ trợ các hành động ChatGPT dự định.

Sự kiện webhook phải khớp với các quy trình bạn hỗ trợ. Các sự kiện phổ biến gồm Cài đặt, Kho lưu trữ cài đặt, Đẩy, Yêu cầu hợp nhất, Vấn đề, Bình luận vấn đề, Chạy quy trình và Công việc quy trình.

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

  1. Trong cài đặt Ứng dụng GitHub, sao chép ID máy khách.

  2. Tạo mã bí mật máy khách và sao chép ngay.

  3. Trong Khóa riêng, tạo khóa riêng.

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

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

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

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

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

  2. Dán ID máy khách của Ứng dụng GitHub vào ID máy khách OAuth.

  3. Dán mã bí mật máy khách của Ứng dụng GitHub vào Mã bí mật máy khách OAuth.

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

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

  6. Dán hoặc tải lên PEM khóa riêng của Ứng dụng GitHub vào khóa riêng của Ứng dụng GitHub.

  7. Xác nhận mã bí mật webhook đã tạo có mặt.

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

  9. Mở chi tiết ứng dụng nháp đã tạo trong ChatGPT và sao chép URL webhook được tạo.

URL webhook sẽ 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 cài đặt Ứng dụng GitHub trong GitHub Enterprise.

  2. Mở cài đặt Chung của Ứng dụng GitHub.

  3. Bật Webhook đang hoạt động nếu chưa được bật.

  4. Dán URL webhook ChatGPT vào URL webhook.

  5. Dán mã bí mật webhook ChatGPT vào Mã bí mật webhook.

  6. Giữ bật xác minh SSL.

  7. Xác nhận các sự kiện webhook đã đăng ký khớp với 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 ứng dụng nháp không tự động cung cấp ứng dụng đó cho thành viên. Sau khi xem xét bản nháp:

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

  2. 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.

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

  4. Xem lại Kiểm soát hành động cho các hành động đọc và ghi.

  5. Xem lại Quyền ứ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.

  6. 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 cuộc trò chuyện ChatGPT. Tác nhân trong không gian làm việc sử dụng các quyền kiểm soát theo từng tác nhân do người 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. Để biết hành vi của tác nhân, hãy xem: Tác nhân không gian làm việc ChatGPT cho Enterprise và Business.

Cài đặt và kiểm thử Ứng dụng GitHub

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

  2. Chọn tất cả kho lưu trữ hoặc các kho lưu trữ đã chọn theo chính sách không gian làm việc.

  3. Bắt đầu luồng kết nối từ ChatGPT với tư cách người dùng được phép.

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

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

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

Tên máy chủ và hành vi OAuth

ChatGPT sử dụng tên máy chủ để suy ra các điểm cuối GitHub Enterprise. Chỉ nhập 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 đó là máy chủ GitHub Enterprise chính xác 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 URL gọi lại của Ứng dụng GitHub 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 ứng dụng nháp: xác nhận tất cả trường bắt buộc đều có, bao gồm tên máy chủ, ID máy khách OAuth, mã bí mật máy khách OAuth, khóa riêng và mã bí mật webhook.

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

  • API trả về 403 hoặc không đủ quyền: thêm quyền Ứng dụng GitHub còn thiếu và yêu cầu chủ sở hữu cài đặt phê duyệt 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 bản cài đặt ứng dụng bao gồm các kho lưu trữ dự kiến và người dùng ủy quyền trong ChatGPT có quyền truy cập vào chúng.

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

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

Tài liệu tham khảo

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