Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Pakiranje vtičnika

Lekcija 10 od 14 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Zakaj pakirati
  2. Struktura prenosnega paketa
  3. Razglasitev strežnika MCP
  4. Metapodatki, specifični za OpenAI
  5. Hitra pot: @plugin-creator
  6. Lokalne tržnice
  7. Kljuke (Hooks): samo za namizne aplikacije
  8. Ključne ugotovitve

Lekcija je bila ponovno napisana 3. novembra 2026 na podlagi strani Package your plugin v dokumentaciji za vtičnike OpenAI. Prejšnja lekcija je opisovala gradnjo „paketa” za neobstoječo „trgovino ChatGPT” z uporabo manjkajočega manifesta. Vtičnik se pakira z manifestom plugin.json, ki sledi shemi Agent Plugins. Vir: Package your plugin.

Zakaj pakirati

Ko si napisal svoje veščine in po potrebi zgradil strežnik MCP, je zadnji korak združevanje v namestljivo enoto. Pakiranje daje tvojemu vtičniku stabilno identiteto in sporoča ChatGPT ter Codexu, katere veščine, povezave s strežniki MCP in viri spadajo skupaj. Logika uporabniškega vmesnika in avtentikacije ostaja znotraj strežnika MCP; manifest zgolj poveže to integracijo z ostalim delom paketa.

Struktura prenosnega paketa

Prenosni vtičnik ima v korenski mapi manifest plugin.json, ki razglaša shemo Agent Plugins. Mapa lahko vsebuje tudi imenik skills/, datoteko mcp.json za strežnike MCP, ki so distribuirani z vtičnikom, in vizualna sredstva v mapi assets/.

mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│   └── compte-rendu/
│       └── SKILL.md
└── assets/
    ├── icon.png
    └── logo.png

Najmanjši manifest zajame le nekaj vrstic. Ime, ki je stabilno in zapisano v kebab-case, služi kot identifikator in imenski prostor za komponente; veščine se samodejno odkrijejo v mapi skills/, zato jih ni treba izrecno navajati.

{
  "$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"
}

Vsaka veščina se nahaja v skills/<ime>/SKILL.md, z glavo, ki navaja njeno ime in opis, sledijo pa navodila:

---
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.

Razglasitev strežnika MCP

Strežniki MCP, ki so distribuirani z vtičnikom, so razglašeni v datoteki mcp.json v korenu, z uporabo ustrezne sheme in določitvijo vrste prenosa za vsak strežnik:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
  "mcpServers": {
    "notes": {
      "type": "streamable-http",
      "url": "https://notes.example.com/mcp"
    }
  }
}

Avtentikacija strežnika je razglašena v tej isti datoteki pod extensions["com.openai"].auth za vsak strežnik – spada k strežniku, ne k manifestu. Za javno predložitev oddaljiš končno točko HTTPS; lokalni strežniki sledijo ločeni poti, rezervirani za namizne vtičnike.

Metapodatki, specifični za OpenAI

Predstavitev imenika, preslikave na že registrirane strežnike MCP in kljuke (hooks) so razglašene v objektu extensions.com.openai korenske datoteke plugin.json, medtem ko prenosna identiteta (name, version, description) ostane v korenu:

{
  "$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"
      }
    }
  }
}

Poti v tem objektu so relativne glede na koren vtičnika in se začnejo z ./. Vizualna sredstva (composerIcon, logo, screenshots) naj bodo po možnosti v mapi ./assets/. Polje apps se uporablja samo za指向 na datoteko .app.json, ki vsebuje preslikave na strežnike MCP, že registrirane v ChatGPT.

Prav tako lahko razglasiš veščino za uvajanje (onboarding skill) prek extensions.com.openai.onboardingSkill (na primer ./skills/setup/SKILL.md): ta vodi uporabnika po namestitvi pri izbiri delovnega prostora ali nastavitvi preferenc. Preizkusi jo v novem pogovoru in med namestitvijo, ki je že v teku.

Starejša oblika z manifestom v .codex-plugin/plugin.json je še vedno sprejeta zaradi združljivosti: uporabi se le, če objekt extensions.com.openai ni prisoten, saj se oba ne združujeta. Novi paketi naj uporabljajo korenski plugin.json.

Hitra pot: @plugin-creator

ChatGPT in Codex vključujeta veščino @plugin-creator, ki za tebe ustvari strukturo – trenutno v združljivi obliki .codex-plugin/. Če želiš nanjo pripeti strežnik MCP, najprej poveži ta strežnik v ChatGPT (Add custom MCP server, nato Create as a plugin), zabeleži tehnični ID povezave iz URL-ja brskalnika – začne se z plugin_asdk_app – in ga posreduj veščini @plugin-creator v načinu Work (ali $plugin-creator v Codexu). Veščina lahko ustvari tudi vnos v osebno tržnico, kar ti omogoča namestitev in testiranje vtičnika neposredno iz tvoje lokalne mape.

Lokalne tržnice

Tržnica je katalog vtičnikov v formatu JSON. Služi za pisanje, testiranje in distribucijo znotraj ekipe ob javnem imeniku: v načinu Work ali v Codexu se vsaka tržnica prikaže kot izbirni vir v imeniku vtičnikov. Tako boš pred predložitvijo testiral celoten vtičnik (lekcija 9).

Kljuke (Hooks): samo za namizne aplikacije

Kljuke življenjskega cikla so podprte le za vtičnike, ročno nameščene v namizni aplikaciji Codex, in vtičnik, ki jih vsebuje, ni upravičen do javnega imenika. Če ciljaš na objavo vtičnika, jih izpusti.

Ključne ugotovitve

  • Prenosni paket: plugin.json (shema Agent Plugins), skills/, mcp.json, assets/
  • Strežnik MCP je razglašen v mcp.json z njegovo vrsto prenosa; tam spada tudi avtentikacija
  • Predstavitev, preslikave in veščina za uvajanje gredo v extensions.com.openai
  • @plugin-creator ustvari strukturo; lokalna tržnica služi za testiranje
  • Vtičnik s kljukami ni upravičen do javnega imenika