Pakendi loomine
Sellel lehel
Tund kirjutati ümber 3. novembril 2026, tuginedes OpenAI pistikprogrammide dokumentatsiooni lehele Package your plugin. Eelmine tund kirjeldas olematu „ChatGPT Store’i“ jaoks „pakendi“ loomist, kasutades puuduvat manifesti. Pistikprogramm pakendatakse koos
plugin.jsonmanifestiga, mis järgib Agent Plugins skeemi. Allikas: Package your plugin.
Miks pakendit vaja on
Kui oled oma oskused kirja pannud ja vajadusel MCP serveri üles ehitanud, on viimane samm nende koondamine installitavaks tervikuks. Pakendamine annab sinu pistikprogrammile stabiilse identiteedi ning annab ChatGPT-le ja Codexile teada, millised oskused, MCP serveri ühendused ja ressursid kuuluvad kokku. Kasutajaliides ja autentimisloogika jäävad MCP serveri sisse; manifest lihtsalt seob selle integratsiooni ülejäänud paketiga.
Kaasaskantava pakendi struktuur
Kaasaskantaval pistikprogrammil on juurkataloogis plugin.json manifest, mis deklareerib Agent Plugins skeemi. Kaust võib sisaldada ka skills/ kataloogi, mcp.json faili pistikprogrammiga kaasas levitatavate MCP serverite jaoks ning visuaalseid ressursse kataloogis assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Minimaalne manifest mahub vaid mõnele reale. Nimi, mis on stabiilne ja vormingus kebab-case, toimib nii identifikaatori kui ka komponentide nimeruumina; oskused avastatakse automaatselt kataloogist skills/ ilma neid eraldi deklareerimata.
{
"$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"
}
Iga oskus asub failis skills/<nimi>/SKILL.md, mille päises on selle nimi ja kirjeldus, millele järgnevad juhised:
---
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 serveri deklareerimine
Pistikprogrammiga kaasas levitatavad MCP serverid deklareeritakse juurkataloogis asuvas failis mcp.json, kasutades vastavat skeemi ja määrates iga serveri jaoks edastustüübi:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Serveri autentimine deklareeritakse samas failis, iga serveri jaoks võtme extensions["com.openai"].auth all – see kuulub serverile, mitte manifestile. Avalikuks esitamiseks esitad kaugserveri HTTPS-lõpppunkti; kohalikud serverid järgivad eraldi rada, mis on reserveeritud töölaua pistikprogrammidele.
OpenAI-spetsiifilised metaandmed
Kataloogi esitlus, kaardistused juba registreeritud MCP serveritega ja konksud (hooks) deklareeritakse juurfaili plugin.json objektis extensions.com.openai, samal ajal kui kaasaskantav identiteet (name, version, description) jääb juurtasandile:
{
"$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"
}
}
}
}
Selles objektis olevad teed on suhtelised pistikprogrammi juure suhtes ja algavad sümbolitega ./. Visuaalsed ressursid (composerIcon, logo, screenshots) peaksid eelistatult asuma kataloogis ./assets/. Välja apps kasutatakse ainult .app.json failile viitamiseks, mis sisaldab kaardistusi ChatGPT-s juba registreeritud MCP serveritega.
Samuti saad deklareerida sissejuhatava oskuse (onboarding skill) võtmega extensions.com.openai.onboardingSkill (näiteks ./skills/setup/SKILL.md): see juhendab kasutajat pärast installimist tööruumi valimisel või eelistuste seadistamisel. Testi seda uues vestluses ja käimasoleva installimise ajal.
Vanemat vormingut, mille manifest asub failis .codex-plugin/plugin.json, aktsepteeritakse endiselt ühilduvuse huvides: seda kasutatakse ainult siis, kui objekt extensions.com.openai puudub, kuna need kaks ei ühendu. Uued paketid peaksid kasutama juurfaili plugin.json.
Kiirtee: @plugin-creator
ChatGPT ja Codex sisaldavad oskust @plugin-creator, mis genereerib sinu eest struktuuri – praegu veel ühilduvas vormingus .codex-plugin/. Et sellega MCP server siduda, ühenda see server esmalt ChatGPT-ga (Add custom MCP server, seejärel Create as a plugin), märgi üles tehniline ühenduse ID brauseri URL-ist – see algab sõnaga plugin_asdk_app – ja edasta see oskusele @plugin-creator režiimis Work (või $plugin-creator rakenduses Codex). See oskus suudab luua ka isikliku turuplatsi kirje, võimaldades sul pistikprogrammi installida ja testida oma kohalikust kataloogist.
Kohalikud turuplatsid
Turuplats on pistikprogrammide JSON-kataloog. See teenib kirjutamist, testimist ja meeskonnasisest levitamist kõrvuti avaliku kataloogiga: režiimis Work või rakenduses Codex ilmub iga turuplats pistikprogrammide kataloogis valitava allikana. Nii testid kogu pistikprogrammi enne selle esitamist (9. tund).
Konksud: ainult töölauarakendus
Elutsükli konksud (lifecycle hooks) on toetatud ainult pistikprogrammide puhul, mis on käsitsi installitud Codexi töölauarakendusse, ja selliseid konkse sisaldav pistikprogramm ei kvalifitseeru avalikku kataloogi. Kui sihid avaldamist, jäta need välja.
Peamised punktid
- Kaasaskantav pakett:
plugin.json(Agent Plugins skeem),skills/,mcp.json,assets/ - MCP server deklareeritakse failis
mcp.jsonkoos selle edastustüübiga; sinna kuulub ka autentimine - Esitlus, kaardistused ja sissejuhatav oskus asuvad väljal
extensions.com.openai @plugin-creatorgenereerib struktuuri; kohalik turuplats on mõeldud testimiseks- Konkse sisaldav pistikprogramm ei kvalifitseeru avalikku kataloogi