Împachetați pluginul
Pe această pagină
Lecție rescrisă la 3 noiembrie 2026 pe baza paginii Package your plugin din documentația OpenAI Plugins. Lecția anterioară descria construirea unui „pachet“ pentru un „Magazin ChatGPT“ inexistent, folosind un manifest lipsă. Un plugin este împachetat cu un manifest
plugin.jsoncare respectă schema Agent Plugins. Sursă: Package your plugin.
De ce să împachetați
Odată ce ați scris competențele (skills) și, dacă este necesar, ați construit serverul MCP, pasul final este asamblarea lor într-o unitate instalabilă. Împachetarea oferă pluginului dumneavoastră o identitate stabilă și indică ChatGPT și Codex ce competențe, conexiuni la servere MCP și resurse aparțin împreună. Logica de interfață utilizator și de autentificare rămâne în interiorul serverului MCP; manifestul leagă pur și simplu acea integrare de restul pachetului.
Structura unui pachet portabil
Un plugin portabil are un manifest plugin.json la rădăcina sa, declarând schema Agent Plugins. Dosarul poate conține, de asemenea, un director skills/, un fișier mcp.json pentru serverele MCP distribuite împreună cu pluginul și elemente vizuale în assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Manifestul minim se încadrează în doar câteva linii. Numele, stabil și scris în kebab-case, servește atât ca identificator, cât și ca spațiu de nume pentru componente; competențele sunt descoperite automat în skills/ fără a necesita o declarare explicită.
{
"$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"
}
Fiecare competență residează în skills/<nume>/SKILL.md, având un antet care furnizează numele și descrierea acesteia, urmat de instrucțiuni:
---
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.
Declararea serverului MCP
Serverele MCP distribuite împreună cu pluginul sunt declarate în mcp.json la rădăcină, folosind schema corespunzătoare și specificând un tip de transport pentru fiecare server:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Autentificarea serverului este declarată în același fișier, sub extensions["com.openai"].auth pentru fiecare server – aceasta aparține serverului, nu manifestului. Pentru submiterea publică, transmiteți endpoint-ul HTTPS la distanță; serverele locale urmează o cale separată rezervată pentru pluginurile desktop.
Metadate specifice OpenAI
Prezentarea directorului, mapările către serverele MCP deja înregistrate și hook-urile sunt declarate în obiectul extensions.com.openai din fișierul plugin.json de la rădăcină, în timp ce identitatea portabilă (name, version, description) rămâne la rădăcină:
{
"$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"
}
}
}
}
Căile din acest obiect sunt relative la rădăcina pluginului și încep cu ./. Elementele vizuale (composerIcon, logo, screenshots) ar trebui preferabil plasate în ./assets/. Câmpul apps este utilizat doar pentru a indica un fișier .app.json care conține mapări către servere MCP deja înregistrate în ChatGPT.
Puteți declara, de asemenea, o competență de onboardare prin extensions.com.openai.onboardingSkill (de exemplu, ./skills/setup/SKILL.md): aceasta ghidează utilizatorul după instalare pentru a alege un spațiu de lucru sau pentru a seta preferințe. Testați-o într-o conversație nouă și în timpul unei instalări în curs de desfășurare.
Un format mai vechi, cu un manifest în .codex-plugin/plugin.json, este încă acceptat pentru compatibilitate: acesta este utilizat doar dacă obiectul extensions.com.openai este absent, deoarece cele două nu se îmbină. Pachetele noi ar trebui să utilizeze plugin.json de la rădăcină.
Calea rapidă: @plugin-creator
ChatGPT și Codex includ o competență, @plugin-creator, care generează structura pentru dumneavoastră – actualmente în formatul de compatibilitate .codex-plugin/. Pentru a atașa un server MCP la acesta, conectați mai întâi acel server în ChatGPT (Add custom MCP server, apoi Create as a plugin), notați ID-ul tehnic de conexiune din URL-ul browserului – acesta începe cu plugin_asdk_app – și furnizați-l către @plugin-creator în modul Work (sau către $plugin-creator în Codex). Competența poate crea, de asemenea, o intrare în marketplace-ul personal, permițându-vă să instalați și să testați pluginul din sursa directorului local.
Marketplace-uri locale
Un marketplace este un catalog JSON de pluginuri. Acesta servește pentru scriere, testare și distribuire în echipă, alături de directorul public: în modul Work sau în Codex, fiecare marketplace apare ca o sursă selectabilă în directorul de pluginuri. Așa veți testa pluginul complet înainte de a-l submita (Lecția 9).
Hook-uri: doar pentru desktop
Hook-urile de ciclu de viață sunt suportate doar pentru pluginurile instalate manual în aplicația desktop Codex, iar un plugin care le conține nu este eligibil pentru directorul public. Dacă pluginul dumneavoastră vizează publicarea, omiteți-le.
Puncte cheie
- Un pachet portabil:
plugin.json(schema Agent Plugins),skills/,mcp.json,assets/ - Serverul MCP este declarat în
mcp.jsoncu tipul său de transport; autentificarea merge tot acolo - Prezentarea, mapările și competența de onboardare merg în
extensions.com.openai @plugin-creatorgenerează structura; un marketplace local este pentru testare- Un plugin cu hook-uri nu este eligibil pentru directorul public