Tổng quan

Quản trị viên không gian làm việc có thể nhập một chợ plugin từ GitHub vào thư mục không gian làm việc của họ. Một chợ là một danh mục JSON liệt kê các plugin cần nhập. Sau khi nhập, đồng bộ hàng ngày sẽ giữ các plugin được cập nhật với các thay đổi từ kho lưu trữ.

Đồng bộ hóa Marketplace nhập nội dung plugin – nó không kết nối tài khoản của các thành viên trong workspace hoặc cấp quyền truy cập vào các ứng dụng được bao gồm trong plugin.

Để tìm hiểu về các plugin và các ứng dụng đi kèm của chúng, xem:Các plugin trong ChatGPT và Codex.

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

• Sử dụng một tài khoản GitHub có thể đọc kho lưu trữ marketplace và mọi kho lưu trữ khác mà nó tham chiếu. Các kho lưu trữ công khai và riêng tư trên github.com đều được hỗ trợ.

• Hoàn tất bất kỳ phê duyệt tổ chức GitHub nào mà tài khoản nhập khẩu yêu cầu để truy cập các kho lưu trữ đó.

• Xem xét nội dung kho lưu trữ. Quá trình nhập khẩu xử lý tất cả các plugin hợp lệ mà không cần bước phê duyệt riêng cho từng plugin, và các đồng bộ trong tương lai có thể thêm các plugin mới.

Các plugin mới bắt đầu vớiCó sẵncài đặt và xác thực khi cài đặt. Các thị trường mới có đồng bộ tự động hàng ngày được bật. Sau khi nhập, xem lại cài đặt không gian làm việc của từng plugin và các ứng dụng cần thiết.

Nhập một thị trường

1. Đ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. Sau đó chọnThêmvà chọnNhập khẩu thị trường.

2. TrongNguồn, nhập URL kho lưu trữ, chẳng hạn nhưhttps://github.com/example/team-plugins. Chỉ sử dụng URL kho lưu trữ, không sử dụng URL của nhánh hoặc thư mục.

3. Nếu chợ nằm trong một thư mục con, hãy nhập thư mục đó vàoĐường dẫn. Ví dụ, nhậpcông cụ độichoteam-tools/.agents/plugins/marketplace.json. Rời điĐường dẫnđể trống cho thư mục gốc của kho lưu trữ. Không nhập tên tệp manifest.

4. Tùy chọn nhập mộtNhánh, thẻ, hoặc cam kết. Để trống để sử dụng nhánh mặc định của kho lưu trữ. Sử dụng một nhánh để nhận các cam kết trong tương lai. Một cam kết cố định sẽ ở nguyên tại phiên bản đó.

5. ChọnNhập khẩu thị trườngvà ủy quyền truy cập GitHub khi được nhắc.

6. Đánh giáNhập kết quả, sau đó mở từng plugin đã nhập để cấu hình chính sách cài đặt và bất kỳ ứng dụng nào cần thiết.

Việc nhập khẩu ban đầu có thể mất tới 1 giờ đối với các thị trường rất lớn. Việc đồng bộ hàng ngày tiếp theo thường mất chỉ vài phút.

Nếu một plugin không thể được nhập khẩu, báo cáo sẽ giải thích lỗi. Các plugin hợp lệ khác vẫn có thể được nhập khẩu.

Các định dạng được hỗ trợ

Thư mục được chọn phải chứa một tệp manifest được hỗ trợ:

• .agents/plugins/marketplace.jsoncho một thị trường Codex.

• .claude-plugin/marketplace.jsoncho một thị trường tương thích với Claude.

• .claude-plugin/plugin.jsoncho một plugin Claude độc lập khi không có tệp manifest của thị trường.

Các mục trên thị trường có thể tham chiếu đến các thư mục plugin trong cùng kho lưu trữ hoặc các nguồn kho lưu trữ GitHub được hỗ trợ. Các máy chủ Git khác và các nguồn đăng ký gói, chẳng hạn như npm, không được hỗ trợ bởi việc nhập từ không gian làm việc.

Đối với các định dạng được hỗ trợ, ví dụ JSON và các trường nguồn, xem:Quản lý plugin.

Cấu hình quyền truy cập không gian làm việc

GitHub cung cấp nội dung plugin, trong khi cài đặt không gian làm việc kiểm soát việc cài đặt và xác thực. Nhập và đồng bộ không áp dụng các giá trị chính sách kho lưu trữ, chẳng hạn nhưCÓ SẴNhoặcKHI_SỬ_DỤNG. Cấu hình các cài đặt này cho từng plugin trong không gian làm việc của bạn.

Sử dụngChính sách cài đặtchọnCó sẵnhoặcĐã cài đặtcho mỗi vai trò đủ điều kiện. Các ứng dụng bắt buộc cũng phải được bật, và các thành viên phải có quyền truy cập vào dịch vụ được kết nối và hoàn thành bất kỳ xác thực cần thiết nào.

Đồng bộ hóa bản cập nhật plugin hoặc chuyển một plugin hiện có sang quản lý trên GitHub sẽ giữ nguyên các chính sách không gian làm việc của nó. Việc nhập plugin không cấp quyền truy cập ứng dụng hoặc kết nối tài khoản của các thành viên.

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

Giữ các plugin luôn cập nhật

Các chợ mới kiểm tra cập nhật hàng ngày. Để yêu cầu cập nhật mà không phải chờ đồng bộ tự động:

1. Đ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.

2. MởChợvà chọn thị trường.

3. ChọnĐồng bộ ngay.

Đồng bộ có thể thêm các mục thị trường mới và cập nhật các plugin hiện có. Xem xét các thay đổi trong kho trước khi gộp chúng, vì đồng bộ tự động có thể nhập các plugin mới mà không cần bước nhập khẩu khác.

Xem lại kết quả đồng bộ

Sau khi đồng bộ, hãy kiểm tra trạng thái và báo cáo đã lưu của nó.Hoàn tất — N lỗinghĩa là việc đồng bộ đã kết thúc, nhưng một số plugin không thể được xử lý.

Nếu bản cập nhật cho một plugin hiện có là không hợp lệ, phiên bản hoạt động cuối cùng của nó sẽ được giữ lại. Các bản cập nhật hợp lệ khác vẫn có thể hoàn tất. Sửa vấn đề đã được báo cáo trên GitHub, sau đó chọnĐồng bộ ngaythử lại.

Nếu chế độ xem quản trị của bạn hiển thịLàm mớiđối với một plugin được nhập khẩu riêng lẻ, hãy sử dụng nó để làm mới plugin đó.Làm mới danh sách pluginchỉ tải lại danh sách hiển thị; nó không đồng bộ từ GitHub.

Hiểu về việc loại bỏ và xóa

Việc gỡ bỏ một mục khỏi kho lưu trữ không xóa bản sao không gian làm việc đã nhập của nó. Plugin được đánh dấuKhông còn trong nguồn.

Xóa chợ ứng dụng trong ChatGPT sẽ xóa tất cả các plugin đã nhập từ đó. Không xóa chợ ứng dụng để kết nối lại GitHub hoặc thay đổi quyền sở hữu.

Kết nối lại hoặc thay đổi quyền truy cập GitHub

Đồng bộ hóa thị trường sử dụng kết nối GitHub của quản trị viên đã nhập nó. Tài khoản đó cần tiếp tục truy cập vào kho lưu trữ thị trường và bất kỳ kho lưu trữ nào được tham chiếu.

Kết nối lại tài khoản gốc

1. Xác nhận rằng tài khoản GitHub được sử dụng để nhập liệu vẫn có quyền truy cập vào tất cả các kho lưu trữ cần thiết.

2. Hỏi quản trị viên người đã nhập thị trường ban đầu để mở plugin GitHub trong ChatGPT và kết nối lại tài khoản của họ.

Chuyển cho quản trị viên mới

Quản trị viên không gian làm việc mới có thể nhập cùng một thị trường sử dụng kết nối GitHub của riêng họ:

1. Đ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. Sau đó chọnThêm > Nhập thị trường.

2. Nhập giống nhauNguồn,Đường dẫn, vàNhánh, thẻ, hoặc cam kếtcác giá trị được sử dụng cho thị trường hiện có.

3. ChọnNhập khẩu thị trườngvà ủy quyền truy cập GitHub khi được nhắc.

Các đồng bộ trong tương lai sẽ sử dụng kết nối GitHub của quản trị viên mới. Tài khoản của quản trị viên mới phải có khả năng đọc kho lưu trữ thị trường và mọi kho lưu trữ mà nó tham chiếu.

Chuyển một plugin hiện có sang quản lý trên GitHub

Bạn có thể sử dụng một thị trường để quản lý một plugin workspace hiện có đã được tải lên dưới dạng tệp lưu trữ hoặc chưa được quản lý bởi nguồn GitHub. Plugin hiện có phải nằm trong cùng một workspace và có cùng tên plugin. Một plugin được quản lý bởi nguồn GitHub khác không thể được tiếp quản theo cách này.

Để xác định plugin hiện có trong thị trường của bạn:

1. Đ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. Mở plugin.

2. Sao chép ID plugin sau/quản trị/plugin/trong URL của nó.

3. Thêm ID đó làmpluginIdbên cạnhtênvànguồntrong mục tương ứng của chợpluginmảng. Không thêm nó vào pluginplugin.jsontệp.

Plugin giữ ID, chính sách chia sẻ và không gian làm việc của nó. GitHub trở thành nguồn cho các bản cập nhật trong tương lai, vì vậy việc tải lên kho lưu trữ sau này không thể thay thế nó.

Để xem ví dụ về di cư và các yêu cầu, hãy xem:Quản lý plugin.

Tham khảo một ứng dụng hiện có

Một plugin có thể tham chiếu đến một ứng dụng hiện có trong.app.jsontại thư mục gốc của plugin. Bao gồm dấu chấm dẫn đầu trong tên tệp, và sử dụng ID của ứng dụng thay vì ID của plugin. Đối với một plugin gốc, hãy đặtứng dụngnhập vào trường.codex-plugin/plugin.jsonđến./.app.json.

Tham chiếu không tạo ra một ứng dụng hoặc cấp quyền bổ sung. Quyền truy cập không gian làm việc hiện có của ứng dụng, xác thực, kiểm soát hành động và các quyền dịch vụ được kết nối vẫn được áp dụng.

Đối với định dạng JSON, xem:Quản lý plugin.

Hiểu nhãn chỉ dành cho Máy tính để bàn

Một plugin được đánh dấuChỉ máy tính để bànkhông thể chạy trong ChatGPT trên web. Các plugin được nhập khẩu có thể nhận nhãn này khi chúng khai báo các máy chủ MCP, ví dụ như trongmcp.jsonhoặc.mcp.json, ngay cả khi một máy chủ sử dụng URL HTTPS từ xa.

Thêm một.app.jsontham chiếu tự nó không loại bỏChỉ máy tính để bànnhãn. Bất kỳ ứng dụng nào được tham chiếu vẫn phải có sẵn cho vai trò của thành viên, và các yêu cầu truy cập và xác thực bình thường của nó vẫn được áp dụng.