Pakker pluginnet
På denne side
Lektionen er omskrevet den 3. november 2026 baseret på siden Package your plugin i OpenAI Plugins-dokumentationen. Den tidligere lektion beskrev opbygning af en “pakke” til en ikke-eksisterende “ChatGPT Store” ved hjælp af et manglende manifest. Et plugin pakkes med et
plugin.json-manifest, der følger Agent Plugins-skemaet. Kilde: Package your plugin.
Hvorfor pakke
Når du har skrevet dine færdigheder og om nødvendigt bygget MCP-serveren, er det sidste skridt at samle dem til en installerbar enhed. Pakning giver dit plugin en stabil identitet og fortæller ChatGPT og Codex, hvilke færdigheder, MCP-serverforbindelser og ressourcer der hører sammen. Brugerfladen og autentificeringslogikken forbliver inde i MCP-serveren; manifestet linker blot denne integration til resten af bundten.
Struktur af en bærbar pakke
Et bærbart plugin har et plugin.json-manifest i roden, der erklærer Agent Plugins-skemaet. Mappen kan også indeholde en skills/-mappe, en mcp.json-fil til MCP-servere, der distribueres med pluginnet, og visuelle aktiver i assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Det minimale manifest fylder kun få linjer. Navnet, som er stabilt og i kebab-case, fungerer både som identifikator og navnerum for komponenter; færdigheder opdages automatisk i skills/ uden behov for eksplicit erklæring.
{
"$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"
}
Hver færdighed ligger i skills/<name>/SKILL.md med en header, der angiver navn og beskrivelse, efterfulgt af instrukser:
---
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.
Erklæring af MCP-serveren
MCP-servere, der distribueres med pluginnet, erklæres i mcp.json i roden ved hjælp af det tilsvarende skema og med angivelse af en transporttype for hver server:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Serverautentificering erklæres i denne samme fil under extensions["com.openai"].auth for hver server – det tilhører serveren, ikke manifestet. Ved offentlig indsendelse indsender du det eksterne HTTPS-endpoint; lokale servere følger en separat sti, der er reserveret til desktop-plugins.
OpenAI-specifikke metadata
Mappepræsentation, mappings til allerede registrerede MCP-servere og hooks erklæres i extensions.com.openai-objektet i rodens plugin.json, mens den bærbare identitet (name, version, description) forbliver i roden:
{
"$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"
}
}
}
}
Stier i dette objekt er relative til plugin-roden og starter med ./. Visuelle aktiver (composerIcon, logo, screenshots) bør fortrinsvis placeres i ./assets/. Feltet apps bruges kun til at pege på en .app.json-fil, der indeholder mappings til MCP-servere, der allerede er registreret i ChatGPT.
Du kan også erklære en onboarding-færdighed via extensions.com.openai.onboardingSkill (for eksempel ./skills/setup/SKILL.md): den guider brugeren efter installationen til at vælge et arbejdsområde eller indstille præferencer. Test den i en ny samtale og under en igangværende installation.
Et ældre format med et manifest i .codex-plugin/plugin.json accepteres stadig af kompatibilitetsårsager: det bruges kun, hvis extensions.com.openai-objektet mangler, da de to ikke flettes sammen. Nye pakker bør bruge rodens plugin.json.
Hurtigsporet: @plugin-creator
ChatGPT og Codex inkluderer en færdighed, @plugin-creator, der genererer strukturen for dig – aktuelt i kompatibilitetsformatet .codex-plugin/. For at knytte en MCP-server til den skal du først forbinde den server i ChatGPT (Add custom MCP server, derefter Create as a plugin), notere det tekniske forbindelses-ID fra browserens URL – det starter med plugin_asdk_app – og give det til @plugin-creator i Work-tilstand (eller til $plugin-creator i Codex). Færdigheden kan også oprette en personlig markedsplads-post, så du kan installere og teste pluginnet fra din lokale mappekilde.
Lokale markedspladser
En markedsplads er et JSON-katalog over plugins. Den bruges til skrivning, test og teamdistribution ved siden af den offentlige mappe: i Work-tilstand eller i Codex vises hver markedsplads som en valgbar kilde i plugin-mappen. Det er sådan, du tester det komplette plugin, før du indsender det (Lektion 9).
Hooks: Kun til desktop
Lifecycle-hooks understøttes kun for plugins, der installeres manuelt i Codex-desktopappen, og et plugin, der indeholder dem, er ikke berettiget til den offentlige mappe. Hvis dit plugin målretter mod offentliggørelse, skal du udelade dem.
Vigtige pointer
- En bærbar pakke:
plugin.json(Agent Plugins-skema),skills/,mcp.json,assets/ - MCP-serveren erklæres i
mcp.jsonmed sin transporttype; autentificering hører også til her - Præsentation, mappings og onboarding-færdigheden placeres i
extensions.com.openai @plugin-creatorgenererer strukturen; en lokal markedsplads er til test- Et plugin med hooks er ikke berettiget til den offentlige mappe