Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Pakendi loomine

Õppetund 10 / 14 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Miks pakendit vaja on
  2. Kaasaskantava pakendi struktuur
  3. MCP serveri deklareerimine
  4. OpenAI-spetsiifilised metaandmed
  5. Kiirtee: @plugin-creator
  6. Kohalikud turuplatsid
  7. Konksud: ainult töölauarakendus
  8. Peamised punktid

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.json manifestiga, 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.json koos selle edastustüübiga; sinna kuulub ka autentimine
  • Esitlus, kaardistused ja sissejuhatav oskus asuvad väljal extensions.com.openai
  • @plugin-creator genereerib struktuuri; kohalik turuplats on mõeldud testimiseks
  • Konkse sisaldav pistikprogramm ei kvalifitseeru avalikku kataloogi