Supakuokite įskiepi
Šiame puslapyje
Pamoka perrašyta 2026 m. lapkričio 3 d. remiantis Package your plugin puslapiu OpenAI įskiepių dokumentacijoje. Ankstesnė pamoka aprašė „paketo“ kūrimą neegzistuojančiai „ChatGPT Store“ parduotuvei naudojant trūkstamą manifestą. Įskiepis supakuojamas su
plugin.jsonmanifestu, laikantis Agent Plugins schemos. Šaltinis: Package your plugin.
Kodėl reikia supakuoti
Kai jau parašei savo įgūdžius ir, jei reikia, sukūrei MCP serverį, paskutinis žingsnis – surinkti juos į diegiamą vienetą. Pakavimas suteikia tavo įskiepiui stabilų identitetą ir nurodo ChatGPT bei Codex, kurie įgūdžiai, MCP serverio ryšiai ir ištekliai priklauso vienam dariniui. Vartotojo sąsajos ir autentifikavimo logika lieka MCP serveryje; manifestas tiesiog susieja tą integraciją su likusia paketo dalimi.
Perkeliamo paketo struktūra
Perkeliamas įskiepis savo šaknyje turi plugin.json manifestą, kuriame deklaruojama Agent Plugins schema. Aplanke taip pat gali būti skills/ katalogas, mcp.json failas MCP serveriams, platinamiems su įskiepiu, ir vizualiniai ištekliai aplanke assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Minimalus manifestas telpa į kelias eilutes. Pavadinimas, stabilus ir parašytas kebab-case formatu, tarnauja kaip identifikatorius ir komponentų vardų sritis; įgūdžiai automatiškai aptinkami aplanke skills/, todėl jų nereikia deklaruoti atskirai.
{
"$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"
}
Kiekvienas įgūdis gyvena aplanke skills/<name>/SKILL.md, kurio antraštėje pateikiamas jo pavadinimas ir aprašymas, o po jų eina instrukcijos:
---
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 serverio deklaravimas
MCP serveriai, platinami su įskiepiu, deklaruojami mcp.json faile šakniniame aplanke, naudojant atitinkamą schemą ir nurodant kiekvienam serveriui transporto tipą:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Serverio autentifikavimas deklaruojamas tame pačiame faile, skiltyje extensions["com.openai"].auth kiekvienam serveriui – tai priklauso serveriui, o ne manifestui. Viešam pateikimui siunčiate nuotolinį HTTPS galinį tašką; vietiniams serveriams taikomas atskiras kelias, skirtas darbalaukio įskiepiams.
OpenAI specifiniai metaduomenys
Katalogo pateikimas, susiejimai su jau registruotais MCP serveriais ir įvesties taškai (hooks) deklaruojami šakninio plugin.json failo objekte extensions.com.openai, tuo tarpu perkeliamas identitetas (name, version, description) lieka šaknyje:
{
"$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"
}
}
}
}
Kelias šiame objekte yra santykinis įskiepio šaknies atžvilgiu ir prasideda ./. Vizualiniai ištekliai (composerIcon, logo, screenshots) turėtų būti talpinami aplanke ./assets/. Laukas apps naudojamas tik nuorodai į .app.json failą, kuriame yra susiejimai su MCP serveriais, jau registruotais ChatGPT sistemoje.
Taip pat gali deklaruoti įvadinį įgūdį (onboarding skill) naudodamas extensions.com.openai.onboardingSkill (pavyzdžiui, ./skills/setup/SKILL.md): jis nukreipia vartotoją po diegimo pasirinkti darbo sritį arba nustatyti nuostatas. Išbandyk tai naujame pokalbyje ir vykstančio diegimo metu.
Senesnis formatas su manifestu .codex-plugin/plugin.json vis dar priimamas suderinamumo sumetimais: jis naudojamas tik tada, kai objektas extensions.com.openai nėra pateiktas, nes šie du nesijungia. Nauji paketai turėtų naudoti šakninį plugin.json.
Greitasis kelias: @plugin-creator
ChatGPT ir Codex turi įgūdį @plugin-creator, kuris sugeneruoja struktūrą už tave – šiuo metu suderinamu .codex-plugin/ formatu. Norėdamas prie jo pridėti MCP serverį, pirmiausia prijunk tą serverį ChatGPT (Add custom MCP server, tada Create as a plugin), užsirašyk techninį ryšio ID iš naršyklės URL – jis prasideda plugin_asdk_app – ir pateik jį @plugin-creator darbo režimu (arba $plugin-creator Codex sistemoje). Šis įgūdis taip pat gali sukurti asmeninę rinkos vietos įrašą, leisiantį tau įdiegti ir išbandyti įskiepį iš savo vietinio katalogo šaltinio.
Vietinės rinkos vietos
Rinkos vieta (marketplace) yra JSON formato įskiepių katalogas. Ji skirta rašymui, testavimui ir platinimui komandoje greta viešojo katalogo: darbo režimu arba Codex sistemoje kiekviena rinkos vieta rodoma kaip pasirenkamas šaltinis įskiepių kataloge. Būtent taip išbandysi visą įskiepį prieš jį pateikdamas (9 pamoka).
Įvesties taškai (Hooks): tik darbalaukiui
Gyvenimo ciklo įvesties taškai (lifecycle hooks) palaikomi tik įskiepiams, rankiniu būdu įdiegtiems Codex darbalaukio programėlėje, ir įskiepis, kuriame jų yra, netinka viešajam katalogui. Jei tavo įskiepis skirtas publikavimui, jų nenaudok.
Svarbiausi punktai
- Perkeliamas paketas:
plugin.json(Agent Plugins schema),skills/,mcp.json,assets/ - MCP serveris deklaruojamas
mcp.jsonfaile nurodant jo transporto tipą; ten pat talpinamas ir autentifikavimas - Pateikimas, susiejimai ir įvadinis įgūdis dedami į
extensions.com.openai @plugin-creatorsugeneruoja struktūrą; vietinė rinkos vieta skirta testavimui- Įskiepis su įvesties taškais (hooks) netinka viešajam katalogui