Опаковане на плъгина
На тази страница
Урокът е пренаписан на 3 ноември 2026 г. въз основа на страницата Package your plugin от документацията на OpenAI за плъгини. Предишният урок описваше изграждането на „пакет“ за несъществуващия „ChatGPT Store“, използвайки липсващ манифест. Плъгинът се опакова с манифест
plugin.json, следващ схемата на Agent Plugins. Източник: Package your plugin.
Защо да опаковате
След като сте написали уменията си и, ако е необходимо, сте изградили MCP сървъра, последната стъпка е да ги сглобите в инсталируема единица. Опаковането осигурява стабилна идентичност на вашия плъгин и информира ChatGPT и Codex кои умения, връзки към MCP сървъри и ресурси принадлежат заедно. Логиката на потребителския интерфейс и автентикацията остават вътре в MCP сървъра; манифестът просто свързва тази интеграция с останалата част от пакета.
Структура на преносим пакет
Преносимият плъгин има манифест plugin.json в своя корен, деклариращ схемата на Agent Plugins. Папката може също да съдържа директория skills/, файл mcp.json за MCP сървъри, разпространявани с плъгина, и визуални активи в assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Минималният манифест се събира в няколко реда. Името, стабилно и във формат kebab-case, служи едновременно като идентификатор и като пространство от имена за компонентите; уменията се откриват автоматично в skills/, без да е необходимо изрично деклариране.
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team notes and meeting minutes"
}
Всяко умение се намира в skills/<name>/SKILL.md, със заглавка, предоставяща неговото име и описание, последвана от инструкции:
---
name: compte-rendu
description: Drafts meeting minutes from team notes.
---
Retrieve meeting notes using list_notes, group them by topic,
then draft a summary: decisions, action items with owners, and open points.
Деклариране на MCP сървъра
MCP сървърите, разпространявани с плъгина, се декларират във mcp.json в корена, като се използва съответната схема и се посочва тип транспорт за всеки сървър:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Автентикацията на сървъра се декларира в същия този файл, под extensions["com.openai"].auth за всеки сървър – тя принадлежи на сървъра, а не на манифеста. За публично подаване предоставяте отдалечения HTTPS крайна точка; локалните сървъри следват отделен път, запазен за десктоп плъгини.
Метаданни, специфични за OpenAI
Представянето на директорията, mappings към вече регистрирани MCP сървъри и hooks се декларират в обекта extensions.com.openai на кореновия plugin.json, докато преносимата идентичност (name, version, description) остава в корена:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team notes and meeting minutes",
"extensions": {
"com.openai": {
"interface": {
"displayName": "Team Notes",
"shortDescription": "Notes and meeting minutes",
"developerName": "Your Team",
"category": "Productivity",
"capabilities": ["Read", "Write"],
"websiteURL": "https://example.com",
"privacyPolicyURL": "https://example.com/privacy",
"termsOfServiceURL": "https://example.com/terms",
"defaultPrompt": ["Use Team Notes to draft Monday's meeting minutes."],
"composerIcon": "./assets/icon.png",
"logo": "./assets/logo.png"
}
}
}
}
Пътищата в този обект са относителни спрямо корена на плъгина и започват с ./. Визуалните активи (composerIcon, logo, screenshots) е за предпочитане да се поставят в ./assets/. Полето apps се използва само за насочване към файл .app.json, съдържащ mappings към MCP сървъри, вече регистрирани в ChatGPT.
Можете също да декларирате умение за въвеждане (onboarding skill) чрез extensions.com.openai.onboardingSkill (например ./skills/setup/SKILL.md): то води потребителя след инсталацията да избере работно пространство или да зададе предпочитания. Тествайте го в нов разговор и по време на инсталация в процес на изпълнение.
По-стар формат, с манифест в .codex-plugin/plugin.json, все още се приема за съвместимост: той се използва само ако обектът extensions.com.openai липсва, тъй като двата не се сливат. Новите пакети трябва да използват кореновия plugin.json.
Бързият път: @plugin-creator
ChatGPT и Codex включват умение, @plugin-creator, което генерира структурата за вас – понастоящем във формата за съвместимост .codex-plugin/. За да прикачите MCP сървър към него, първо свържете този сървър в ChatGPT (Add custom MCP server, след това Create as a plugin), запишете техническия ID на връзката от URL адреса на браузъра – той започва с plugin_asdk_app – и го предоставете на @plugin-creator в режим Work (или на $plugin-creator в Codex). Умението може също да създаде запис в личен маркетплейс, позволявайки ви да инсталирате и тествате плъгина от вашия локален изходен код.
Локални маркетплейси
Маркетплейсът е JSON каталог от плъгини. Той служи за писане, тестване и разпространение в екипа успоредно с публичния директорий: в режим Work или в Codex всеки маркетплейс се появява като избираем източник в директорията с плъгини. Така ще тествате целия плъгин, преди да го подадете (Урок 9).
Hooks: само за десктоп
Hooks за жизнен цикъл се поддържат само за плъгини, инсталирани ръчно в десктоп приложението Codex, и плъгин, съдържащ такива, не отговаря на условията за публичния директорий. Ако вашият плъгин е насочен към публикуване, ги пропуснете.
Ключови изводи
- Преносим пакет:
plugin.json(схема на Agent Plugins),skills/,mcp.json,assets/ - MCP сървърът се декларира във
mcp.jsonс неговия тип транспорт; автентикацията отива там също - Представянето, mappings и умението за въвеждане отиват в
extensions.com.openai @plugin-creatorгенерира структурата; локалният маркетплейс е за тестване- Плъгин с hooks не отговаря на условията за публичния директорий