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 GitHubMẫu ứng dụng doanh nghiệp cho tổ chức của bạn. Một mẫu không phải là ứng dụng cuối cùng mà các thành viên sử dụng. Nó là một quy trình thiết lập tạo ra một ứng dụng nháp 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.

Đối với GitHub Enterprise, thiết lập kết nối ChatGPT với tổ chức của bạnMáy chủ GitHub Enterprise. Bạn tạo một Ứng dụng GitHub, đăng ký URL callback của ChatGPT, tạo thông tin xác thực, sau đó dán các giá trị đó vào quy trình 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 nó và quản lý như các ứng dụng không gian làm việc khác.

Để điều hướng không gian làm việc và truy cập ứng dụng, xem:Quả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.

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

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 này sử dụng:

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

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

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

• Một bí mật webhook và URL webhook để GitHub Enterprise có thể gửi các 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 một Ứng dụng GitHub, không phải một Ứng dụng OAuth GitHub độc lập. Cài đặt mẫu ChatGPT yêu cầu thông tin xác thực Ứng dụng GitHub, một khóa riêng tư và cài đặt webhook.

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

Bạn cần:

• Quyền truy cập quản trị hoặc chủ sở hữu của không gian làm việc ChatGPT.

• Quản trị viên GitHub Enterprise hoặc quyền 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 kèm theohttps://hoặc một con đường.

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

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

Giữ ChatGPT và GitHub Enterprise mở trong các tab riêng biệt. Đừng tự tạo URL callback. Sao chép chính xác URL callback 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 phản hồi: sao chép điều này từ quy trình thiết lập mẫu ChatGPT.

• ID client của ứng dụng GitHub.

• Bí mật client của ứng dụng GitHub.

• Khóa riêng PEM của ứng dụng GitHub.

• Bí mật webhook được tạo bởi ChatGPT.

• 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 nên có sẵn.

2. MởCài đặt không gian làm việc > Ứng dụng. Bạn cũng có thể đi đếnBảng điều khiển quản trị, chọn không gian làm việc ChatGPT mong muốn, và mởTiện ích mở rộng. ChọnQuản lý ứng dụng cũmở cái giữ lạiỨng dụngtrang.

3. ChọnThư 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 ứng dụng và mô tả rõ rà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 khóa bí mật webhook được tạo nếu nó hiển thị trong quá trình thiết lập.

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.

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 nên sở hữu ứng dụng.

3. Mở Cài đặt > Cài đặt nhà phát triển > Ứng dụng GitHub.

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

5. Nhập một tên ứng dụng rõ ràng, chẳng hạn như ChatGPT GitHub Enterprise Connector.

6. Nhập URL trang chủ. Nếu không có trang nội bộ riêng, hãy sử 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 được sao chép từ ChatGPT.

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

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 quá trình cài đặt hoặc kết nối.

10. Dưới mục Where can this GitHub App be installed?, hãy chọn tùy chọn hẹp nhất phù hợp với việc triển khai của bạn.

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

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

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

Đối với việc 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 metadata cho các Ứng dụng GitHub.

• Nội dung: chỉ đọc, để truy cập nội dung tệp và 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 kéo:chỉ đọc, nếu cần bối cảnh tìm kiếm hoặc xem xét pull request.

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

Đối với các luồng công việc ghi, chỉ thêm quyền ghi ở những nơi cần thiết, chẳng hạn như Nội dung, Yêu cầu kéo, Vấn đề, Hành động hoặc Luồng công việc. Sử dụng quyền hạn hẹp nhất hỗ trợ các hành động ChatGPT dự định.

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

Tạo và sao chép thông tin đăng nhập ứng dụng GitHub

1. Trong cài đặt Ứng dụng GitHub, sao chépID khách hàng.

2. Tạo ra mộtMật khẩu khách hàngvà sao chép nó ngay lập tức.

3. DướiKhóa riêng, tạo một khóa riêng.

4. Tải tệp .pem và lưu trữ nó một cách an toàn.

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

Khóa riêng tư là nhạy cảm. Hãy coi nó như một thông tin đăng nhập. Nếu nó bị lộ, hãy tạo một khóa riêng tư mới, cập nhật cài đặt ứng dụng ChatGPT và xóa khóa bị xâm nhập trên GitHub Enterprise.

Hoàn tất cài đặt trong ChatGPT

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

2. Dán ID Khách hàng Ứng dụng GitHub vàoID khách hàng OAuth.

3. Dán bí mật khách hàng của Ứng dụng GitHub vàoBí mật client OAuth.

4. Rời điPhạm vikhông thay đổi trừ khi tổ chức của bạn cố tình cần ghi đè các mặc định của mẫu.

5. Xác nhận rằng 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 khóa riêng tư PEM của GitHub App vào khóa riêng tư GitHub App.

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

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

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

URL webhook nên trông như sau:https://connectors.api.openai.org/connectors/<connector_id>/webhook

Hoàn tất cài đặt 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 các webhook đang hoạt động nếu chúng chưa được bật.

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

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

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

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

8. Lưu các thay đổi.

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

Tạo ứng dụng bản nháp không tự động làm cho nó có sẵn cho các thành viên. Sau khi xem xét bản nháp:

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

2. Trong cài đặt Workspace, mởỨng dụngtrang, mởĐã bật, và xác nhận ứng dụng xuất hiện. Bạn cũng có thể mở trang Ứng dụng bằng cách sử dụng Quản lý Ứng dụng Cũ trong Bảng điều khiển Quản trị > Tiện ích.

3. Cấu hìnhTruy cập người dùngcho các vai trò nên sử dụng nó.

4. Đánh giáKiểm soát hành độngcho các hành động đọc và ghi.

5. Đánh giáQuyền ứng dụngchọn khi ChatGPT hỏi các 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 ChatGPTvà 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 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.

Cài đặt và kiểm tra Ứ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ả các kho lưu trữ hoặc các kho lưu trữ được 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 như một người dùng được cho phép.

4. Cho phép ứng dụng GitHub khi được nhắc.

5. Chạy một hành động đọc nhỏ trước, 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 kích hoạt, hãy thử nghiệm với một kho lưu trữ có rủi ro thấp trước khi triển khai rộng rãi.

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 của GitHub Enterprise. Chỉ nhập tên máy chủ, chẳng hạn nhưgithub.example.comhoặcoctocorp.ghe.com.

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

Khắc phục sự cố

• Sai khớp URI chuyển hướng:xác nhận rằng 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 bản nháp ứng dụng:xác nhận tất cả các trường bắt buộc đã có, bao gồm tên máy chủ,ID khách hàng OAuth,Bí mật client OAuth, khóa riêng và bí mật webhook.

• Xác thực thành công nhưng các cuộc gọi đến kho lưu trữ thất bại:xác nhận rằng ứ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 quyền không đủ:thêm quyền GitHub App bị thiếu và yêu cầu chủ sở hữu cài đặt phê duyệt các quyền đã cập nhật nếu có thông báo.

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

• Giao hàng webhook thất bại:xác nhận URL webhook và 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ậpconnectors.api.openai.org.

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

Tài liệu tham khảo

• Tài liệu GitHub: Đăng ký một Ứng dụng GitHub

• Tài liệu GitHub: Về URL gọi lại ủy quyền người dùng

• Tài liệu GitHub: Chọn quyền cho một Ứng dụng GitHub

• Tài liệu GitHub: Sử dụng webhook với Ứng dụng GitHub

• Tài liệu GitHub: Quản lý khóa riêng cho Ứng dụng GitHub