Xây dựng plugin

Để xây dựng hoặc gửi một plugin, hãy sử dụng toàn bộ tài liệu dành cho nhà phát triển trên developers.openai.com.

Xây dựng và gửi một plugin

Trang này cung cấp phần giới thiệu ngắn gọn. Plugin là một gói có thể cài đặt, có thể chứa các kỹ năng, một máy chủ MCP hoặc cả hai. Máy chủ MCP cũng có thể trả về UI tùy chọn.

ChatGPT và Codex dùng chung một thư mục plugin toàn cục. Chỉ cần phát hành plugin công khai một lần để cùng một mục niêm yết có thể được tìm thấy trên các giao diện được hỗ trợ của cả hai sản phẩm. Trong quá trình phát triển, hãy dùng marketplace cục bộ để kiểm thử gói trước khi gửi gói đó lên thư mục toàn cục.

Để phân phối trong workspace thông qua GitHub, hãy xem Quản lý plugin.

Hãy bắt đầu với một kỹ năng khi bạn vẫn đang tinh chỉnh một quy trình cá nhân. Hãy xây dựng plugin khi muốn chia sẻ quy trình đó, đóng gói các kỹ năng liên quan, kết nối với một dịch vụ bên ngoài hoặc phân phối một chức năng ổn định cho nhóm.

Tạo plugin bằng @plugin-creator

Để thiết lập nhanh nhất, hãy dùng kỹ năng @plugin-creator tích hợp sẵn trong chế độ ChatGPT Work hoặc $plugin-creator trong Codex.

@plugin-creator Create a plugin named meeting-follow-up.
Include a skill that turns meeting notes into decisions, owners, and next steps.
Add it to a personal marketplace so I can test it locally.

Kỹ năng này tạo một tệp kê khai tương thích .codex-plugin/plugin.json được hỗ trợ, sắp xếp thư mục plugin và có thể thêm plugin vào một kho plugin cục bộ. Bộ khung này khác với định dạng plugin.json ở thư mục gốc của gói có thể dùng trên nhiều môi trường trong ví dụ tạo thủ công. Xem bố cục bộ khung để biết các tệp và thư mục tùy chọn.

1. Rà soát .codex-plugin/plugin.json.
2. Kiểm tra từng kỹ năng đi kèm trong skills/ theo hướng dẫn tuân thủ chỉ dẫn.
3. Làm mới ChatGPT hoặc Codex rồi cài đặt plugin từ nguồn kho plugin cục bộ của nó.
4. Kiểm thử plugin trong một cuộc trò chuyện mới với các yêu cầu tiêu biểu.

Nếu plugin có MCP server, trước tiên hãy xây dựng và kiểm thử server đó, sau đó cung cấp cho @plugin-creator thông tin chi tiết về kết nối đã đăng ký. Hãy làm theo toàn bộ quy trình MCP server cho các công cụ, quá trình xác thực, triển khai và kiểm thử.

Tạo plugin chỉ gồm các kỹ năng theo cách thủ công

Một gói Agent Plugins tối thiểu có thể dùng trên nhiều môi trường chứa một tệp kê khai ở thư mục gốc và ít nhất một kỹ năng:

meeting-follow-up/
├── plugin.json
└── skills/
    └── meeting-follow-up/
        └── SKILL.md

Tạo plugin.json tại thư mục gốc của plugin:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "meeting-follow-up",
  "version": "1.0.0",
  "description": "Turn meeting notes into decisions and next steps"
}

Các gói có thể dùng trên nhiều môi trường tự động tìm kỹ năng trong skills/. Thêm skills/meeting-follow-up/SKILL.md:

---
name: meeting-follow-up
description: Extract decisions, owners, and next steps from meeting notes.
---

Review the meeting notes. Return:

1. Decisions
2. Action items with owners
3. Open questions

Hãy dùng tên plugin ổn định theo kiểu kebab case. Giữ phần mô tả kỹ năng đủ cụ thể để ChatGPT và Codex nhận biết khi nào quy trình này áp dụng.

Dùng @plugin-creator để thêm thư mục vào marketplace cục bộ, sau đó cài đặt và kiểm thử trước khi chia sẻ.

Tiếp tục với tài liệu dành cho nhà phát triển

Để xem toàn bộ tài liệu dành cho nhà phát triển, hãy sử dụng tài liệu về Plugin. Tài liệu này đề cập đến:

• Kiến trúc plugin
• Xây dựng kỹ năng
• Xây dựng MCP server
• Thêm UI tùy chọn
• Đóng gói plugin
• Kiểm thử plugin
• Gửi và phát hành

Để duyệt, cài đặt, bật hoặc gỡ bỏ plugin, hãy xem Sử dụng plugin.