Tìm hiểu cách nhập chợ tiện ích từ GitHub, quản lý quyền truy cập trong không gian làm việc và luôn cập nhật các tiện ích.

Tổng quan

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

Việc đồng bộ chợ tiện ích chỉ nhập nội dung tiện ích, không kết nối tài khoản của thành viên không gian làm việc hay cấp quyền truy cập vào các ứng dụng có trong tiện ích.

Để tìm hiểu về tiện ích và các ứng dụng đi kèm, hãy xem: Tiện ích trong ChatGPT và Codex.

Trước khi bắt đầu

Dùng tài khoản GitHub có quyền đọc kho lưu trữ chứa chợ tiện ích và mọi kho lưu trữ khác mà chợ tiện ích tham chiếu đến. Cả kho lưu trữ công khai và riêng tư trên github.com đều được hỗ trợ.
Hoàn tất mọi thủ tục phê duyệt mà tổ chức trên GitHub yêu cầu để tài khoản thực hiện việc nhập có thể truy cập các kho lưu trữ đó.
Xem xét nội dung kho lưu trữ. Quá trình nhập xử lý tất cả tiện ích hợp lệ mà không có bước phê duyệt riêng cho từng tiện ích, và các lần đồng bộ sau có thể thêm tiện ích mới.

Tiện ích mới có chính sách cài đặt ban đầu là Có sẵn và yêu cầu xác thực khi cài đặt. Các chợ tiện ích mới được bật tính năng đồng bộ tự động hằng ngày. Sau khi nhập, hãy xem lại các thiết lập trong không gian làm việc và các ứng dụng cần thiết của từng tiện ích.

Nhập chợ tiện ích

Truy cập Bảng điều khiển quản trị, chọn không gian làm việc ChatGPT bạn muốn dùng rồi mở Tiện ích. Sau đó chọn Thêm rồi chọn Nhập chợ tiện ích.
Trong mục Nguồn, nhập URL kho lưu trữ, chẳng hạn như https://github.com/example/team-plugins. Chỉ dùng URL kho lưu trữ, không dùng URL của nhánh hay thư mục.
Nếu chợ tiện ích nằm trong thư mục con, hãy nhập thư mục đó vào mục Đường dẫn. Ví dụ: nhập team-tools cho team-tools/.agents/plugins/marketplace.json. Để trống mục Đường dẫn nếu dùng thư mục gốc của kho lưu trữ. Không nhập tên tệp cấu hình.
Bạn có thể nhập Nhánh, thẻ hoặc commit nếu muốn. Để trống để dùng nhánh mặc định của kho lưu trữ. Dùng một nhánh để nhận các commit trong tương lai. Nếu chọn một commit cố định, nội dung sẽ giữ nguyên ở phiên bản đó.
Chọn Nhập chợ tiện ích và cấp quyền truy cập GitHub khi được nhắc.
Xem lại Kết quả nhập, sau đó mở từng tiện ích đã nhập để cấu hình chính sách cài đặt và các ứng dụng cần thiết.

Lần nhập đầu tiên có thể mất tới 1 giờ với các chợ tiện ích rất lớn. Các lần đồng bộ hằng ngày tiếp theo thường mất vài phút.

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

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

Thư mục đã chọn phải chứa một tệp cấu hình được hỗ trợ:

.agents/plugins/marketplace.json cho chợ tiện ích Codex.
.claude-plugin/marketplace.json cho chợ tiện ích tương thích với Claude.
.claude-plugin/plugin.json cho tiện ích Claude độc lập khi không có tệp cấu hình chợ tiện ích.

Các mục trong chợ tiện ích có thể tham chiếu đến thư mục tiện ích trong cùng kho lưu trữ hoặc các nguồn kho lưu trữ GitHub được hỗ trợ. Tính năng nhập vào không gian làm việc không hỗ trợ các dịch vụ lưu trữ Git khác và nguồn từ các kho đăng ký gói như npm.

Để biết các định dạng được hỗ trợ, ví dụ JSON và các trường nguồn, hãy xem: Quản lý tiện ích.

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

GitHub cung cấp nội dung tiện ích, còn các thiết lập của không gian làm việc kiểm soát việc cài đặt và xác thực. Quá trình nhập và đồng bộ không áp dụng các giá trị chính sách trong kho lưu trữ, chẳng hạn như AVAILABLE hoặc ON_USE. Hãy cấu hình các thiết lập này cho từng tiện ích trong không gian làm việc của bạn.

Dùng Chính sách cài đặt để chọn Có sẵn hoặc Đã cài đặt cho từng vai trò đủ điều kiện. Các ứng dụng cần thiết cũng phải được bật, và thành viên phải có quyền truy cập dịch vụ được kết nối cũng như hoàn tất mọi yêu cầu xác thực.

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

Để tìm hiểu cách điều hướng trong không gian làm việc, quyền truy cập ứng dụng và các tùy chọn kiểm soát trong không gian làm việc, hãy xem: Các tùy chọn kiểm soát dành cho quản trị viên, bảo mật và tuân thủ đối với tiện ích và ứng dụng.

Luôn cập nhật tiện ích

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

Truy cập Bảng điều khiển quản trị, chọn không gian làm việc ChatGPT bạn muốn dùng rồi mở Tiện ích.
Mở Chợ tiện ích rồi chọn chợ tiện ích cần đồng bộ.
Chọn Đồng bộ ngay.

Quá trình đồng bộ có thể thêm các mục mới từ chợ tiện ích và cập nhật các tiện ích hiện có. Hãy xem xét các thay đổi trong kho lưu trữ trước khi hợp nhất, vì quá trình đồng bộ tự động có thể nhập các tiện ích mới mà không cần thực hiện lại bước nhập.

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

Sau mỗi lần đồng bộ, hãy xem lại trạng thái và báo cáo đã lưu. Đã hoàn tất — N lỗi nghĩa là quá trình đồng bộ đã kết thúc, nhưng không xử lý được một số tiện ích.

Nếu bản cập nhật của một tiện ích hiện có không hợp lệ, phiên bản hoạt động được gần nhất của tiện ích đó 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. Khắc phục sự cố được báo cáo trên GitHub, sau đó chọn Đồng bộ ngay để thử lại.

Nếu giao diện quản trị của bạn hiển thị Làm mới cho một tiện ích được nhập riêng lẻ, hãy dùng tùy chọn đó để làm mới tiện ích. Làm mới danh sách tiện ích chỉ tải lại danh sách đang hiển thị, không đồng bộ từ GitHub.

Tìm hiểu về việc gỡ bỏ và xóa

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

Xóa chợ tiện ích trong ChatGPT sẽ xóa tất cả tiện ích đã nhập từ chợ đó. Không xóa chợ tiện ích để 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

Quá trình đồng bộ chợ tiện ích sử dụng kết nối GitHub của quản trị viên đã nhập chợ tiện ích đó. Tài khoản đó cần duy trì quyền truy cập vào kho lưu trữ chứa chợ tiện ích và mọi kho lưu trữ được tham chiếu.

Kết nối lại tài khoản ban đầu

Xác nhận rằng tài khoản GitHub dùng để nhập vẫn có quyền truy cập tất cả kho lưu trữ cần thiết.
Yêu cầu quản trị viên đã nhập chợ tiện ích ban đầu mở tiện ích GitHub trong ChatGPT và kết nối lại tài khoản của họ.

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

Quản trị viên mới của không gian làm việc có thể nhập cùng chợ tiện ích đó bằng kết nối GitHub của chính họ:

Truy cập Bảng điều khiển quản trị, chọn không gian làm việc ChatGPT bạn muốn dùng rồi mở Tiện ích. Sau đó chọn Thêm > Nhập chợ tiện ích.
Nhập các giá trị Nguồn, Đường dẫn và Nhánh, thẻ hoặc commit giống với các giá trị đã dùng cho chợ tiện ích hiện có.
Chọn Nhập chợ tiện ích và cấp quyền truy cập GitHub khi được nhắc.

Các lần đồng bộ sau 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ó quyền đọc kho lưu trữ chứa chợ tiện ích và mọi kho lưu trữ mà chợ tiện ích tham chiếu đến.

Chuyển tiện ích hiện có sang quản lý bằng GitHub

Bạn có thể dùng chợ tiện ích để quản lý một tiện ích hiện có trong không gian làm việc, được tải lên dưới dạng tệp lưu trữ hoặc chưa được quản lý qua nguồn GitHub. Tiện ích hiện có phải nằm trong cùng không gian làm việc và có cùng tên tiện ích. Không thể tiếp quản theo cách này một tiện ích đang được quản lý qua nguồn GitHub khác.

Để xác định tiện ích hiện có trong chợ tiện ích của bạn:

Truy cập Bảng điều khiển quản trị, chọn không gian làm việc ChatGPT bạn muốn dùng rồi mở Tiện ích. Mở tiện ích.
Sao chép ID tiện ích nằm sau /admin/plugins/ trong URL của tiện ích.
Thêm ID đó dưới dạng pluginId bên cạnh name và source trong mục tương ứng của mảng plugins thuộc chợ tiện ích. Không thêm ID này vào tệp plugin.json của tiện ích.

Tiện ích vẫn giữ nguyên ID, thiết lập chia sẻ và các chính sách trong không gian làm việc. GitHub trở thành nguồn cung cấp các bản cập nhật sau này, nên các tệp lưu trữ được tải lên sau đó không thể thay thế tiện ích.

Để xem ví dụ và các yêu cầu về việc chuyển đổi, hãy xem: Quản lý tiện ích.

Tham chiếu đến một ứng dụng hiện có

Tiện ích có thể tham chiếu đến một ứng dụng hiện có trong tệp .app.json ở thư mục gốc của tiện ích. Giữ dấu chấm ở đầu tên tệp và dùng ID của ứng dụng thay vì ID của tiện ích. Với tiện ích gốc, hãy đặt trường apps trong .codex-plugin/plugin.json thành ./.app.json.

Tham chiếu này không tạo ứng dụng hay cấp thêm quyền. Các thiết lập hiện có của ứng dụng về quyền truy cập trong không gian làm việc, xác thực, kiểm soát hành động và quyền đối với dịch vụ được kết nối vẫn áp dụng.

Để biết định dạng JSON, hãy xem: Quản lý tiện ích.

Tìm hiểu nhãn Chỉ trên máy tính

Tiện ích được gắn nhãn Chỉ trên máy tính không thể chạy trong ChatGPT trên web. Tiện ích đã nhập có thể được gắn nhãn này nếu có khai báo máy chủ MCP, chẳng hạn trong mcp.json hoặc .mcp.json, ngay cả khi máy chủ dùng URL HTTPS từ xa.

Chỉ thêm tham chiếu .app.json sẽ không gỡ bỏ nhãn Chỉ trên máy tính. Mọi ứng dụng được tham chiếu vẫn phải khả dụng cho vai trò của thành viên, và các yêu cầu thông thường về quyền truy cập và xác thực của ứng dụng vẫn áp dụng.

Nhập và đồng bộ chợ tiện ích từ GitHub