Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Pakker pluginnet

Lektion 10 af 14 Opdateret 3. november 2026 Udvikler
På denne side
  1. Hvorfor pakke
  2. Struktur af en bærbar pakke
  3. Erklæring af MCP-serveren
  4. OpenAI-specifikke metadata
  5. Hurtigsporet: @plugin-creator
  6. Lokale markedspladser
  7. Hooks: Kun til desktop
  8. Vigtige pointer

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.json med sin transporttype; autentificering hører også til her
  • Præsentation, mappings og onboarding-færdigheden placeres i extensions.com.openai
  • @plugin-creator genererer strukturen; en lokal markedsplads er til test
  • Et plugin med hooks er ikke berettiget til den offentlige mappe