Iepakojiet spraudni
Šajā lapā
Nodarbība pārrakstīta 2026. gada 3. novembrī, pamatojoties uz lapu Package your plugin OpenAI spraudņu dokumentācijā. Iepriekšējā nodarbība aprakstīja “pakotnes” veidošanu neeksistējošam “ChatGPT veikalam”, izmantojot trūkstošu manifestu. Spraudnis tiek iepakots ar
plugin.jsonmanifestu, kas atbilst Agent Plugins shēmai. Avots: Package your plugin.
Kāpēc iepakot
Kad esi uzrakstījis savas prasmes un, ja nepieciešams, izveidojis MCP serveri, pēdējais solis ir apkopot tos instalējamā vienībā. Iepakošana piešķir tavam spraudnim stabilu identitāti un norāda ChatGPT un Codex, kuras prasmes, MCP servera savienojumi un resursi pieder kopā. Lietotāja saskarne un autentifikācijas loģika paliek MCP serverī; manifests vienkārši sasaista šo integrāciju ar pārējo pakotni.
Pārvietojamas pakotnes struktūra
Pārvietojamam spraudnim saknē ir plugin.json manifests, kas deklarē Agent Plugins shēmu. Mape var saturēt arī skills/ direktoriju, mcp.json failu MCP serveriem, kas tiek izplatīti kopā ar spraudni, un vizuālos resursus mapē assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Minimālais manifests ietilpst tikai dažās rindās. Nosaukums, kas ir stabils un rakstīts kebab-case, kalpo gan kā identifikators, gan kā komponentu nosaukumtelpa; prasmes tiek automātiski atrastas mapē skills/, bez nepieciešamības tās deklarēt eksplicīti.
{
"$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"
}
Katra prasme atrodas failā skills/<nosaukums>/SKILL.md, kur galvene satur tās nosaukumu un aprakstu, kam seko instrukcijas:
---
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 servera deklarēšana
MCP serveri, kas tiek izplatīti kopā ar spraudni, tiek deklarēti failā mcp.json saknē, izmantojot atbilstošo shēmu un norādot katra servera transporta veidu:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Servera autentifikācija tiek deklarēta tajā pašā failā, sadaļā extensions["com.openai"].auth katram serverim — tā pieder serverim, nevis manifestam. Publiskai iesniegšanai tu iesniedz attālo HTTPS galapunktu; lokālie serveri seko atsevišķam ceļam, kas paredzēts darbvirsmas spraudņiem.
OpenAI specifiskie metadati
Direktorija noformējums, kartējumi uz jau reģistrētiem MCP serveriem un āķi (hooks) tiek deklarēti objekta extensions.com.openai ietvaros saknes plugin.json failā, savukārt pārvietojamā identitāte (name, version, description) paliek saknē:
{
"$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"
}
}
}
}
Ceļi šajā objektā ir relatīvi pret spraudņa sakni un sākas ar ./. Vizuālie resursi (composerIcon, logo, screenshots) vēlams izvietot mapē ./assets/. Lauks apps tiek izmantots tikai norādei uz .app.json failu, kas satur kartējumus uz MCP serveriem, kas jau ir reģistrēti ChatGPT.
Tu vari deklarēt arī ievadprasmī (onboarding skill), izmantojot extensions.com.openai.onboardingSkill (piemēram, ./skills/setup/SKILL.md): tā vada lietotāju pēc instalēšanas, lai izvēlētos darbvietu vai iestatītu preferences. Pārbaudi to jaunā sarunā un instalēšanas procesa laikā.
Vecāks formāts ar manifestu failā .codex-plugin/plugin.json joprojām tiek pieņemts saderības nolūkos: to izmanto tikai tad, ja objekts extensions.com.openai nav norādīts, jo abi nesaplūst. Jaunām pakotnēm jāizmanto saknes plugin.json.
Ātrā metode: @plugin-creator
ChatGPT un Codex ietver prasmi @plugin-creator, kas ģenerē struktūru tavā vietā — pašlaik saderības .codex-plugin/ formātā. Lai tai pievienotu MCP serveri, vispirms izveido savienojumu ar šo serveri ChatGPT (Add custom MCP server, tad Create as a plugin), pieraksti tehnisko savienojuma ID no pārlūka URL — tas sākas ar plugin_asdk_app — un norādi to prasmei @plugin-creator darba režīmā (vai $plugin-creator vidē Codex). Prasme var izveidot arī personīgu tirgus vietas ierakstu, ļaujot instalēt un testēt spraudni no tava lokālā direktorija avota.
Lokālās tirgus vietas
Tirgus vieta ir JSON formāta spraudņu katalogs. Tā kalpo rakstīšanai, testēšanai un izplatībai komandas ietvaros līdzās publiskajam direktorijam: darba režīmā vai Codex katrā tirgus vietā parādās kā izvēlams avots spraudņu direktorijā. Tieši tā tu testēsi pilno spraudni pirms tā iesniegšanas (9. nodarbība).
Āķi (Hooks): tikai darbvirsmai
Dzīves cikla āķi tiek atbalstīti tikai spraudņiem, kas manuāli instalēti Codex darbvirsmas lietotnē, un spraudnis, kas tos satur, nav tiesīgs iekļūt publiskajā direktorijā. Ja tavs spraudnis ir paredzēts publicēšanai, izlaid tos.
Galvenās atziņas
- Pārvietojama pakotne:
plugin.json(Agent Plugins shēma),skills/,mcp.json,assets/ - MCP serveris tiek deklarēts failā
mcp.jsonar tā transporta veidu; autentifikācija norādāma turpat - Noformējums, kartējumi un ievadprasme norādāma sadaļā
extensions.com.openai @plugin-creatorģenerē struktūru; lokālā tirgus vieta paredzēta testēšanai- Spraudnis ar āķiem nav tiesīgs iekļūt publiskajā direktorijā