Optimaliseren: Metagegevens, Vaardigheden en Gebeurtenissen
Op deze pagina
Les herschreven op 3 november 2026 op basis van de OpenAI Plugins-documentatiepagina’s Optimize Metadata, Build Skills, MCP Events en Plugin Extensions. De vorige versie van deze les vertrouwde op
analytics- enexperiment-modules uit een niet-bestaande SDK. Bronnen: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.
Metagegevens zijn producttekst
ChatGPT en Codex beslissen wanneer ze uw tools aanroepen op basis van de metagegevens die u verstrekt. Goed geschreven namen, beschrijvingen en parameters zorgen ervoor dat uw tool wordt aangeroepen wanneer dat nodig is en voorkomen ongewenste triggers. OpenAI raadt aan om deze metagegevens te behandelen als producttekst: iteratie, testen en het meten van de prestaties zijn essentieel.
Een referentieset van prompts
Voordat u uw metagegevens aanpast, stelt u een gelabelde set testprompts samen:
- Directe prompts die uw product of gegevensbron expliciet bij naam noemen.
- Indirecte prompts die het gewenste resultaat beschrijven zonder uw tool te noemen.
- Negatieve prompts die moeten worden afgehandeld door ingebouwde tools of andere plugins.
Documenteer voor elke prompt het verwachte gedrag: roep uw tool aan, doe niets, of wijk uit naar een andere oplossing. Gebruik deze set voor elke niet-regressietest.
Metagegevens die het model sturen
- De naam moet het domein en de actie combineren, zoals
calendar.create_event. - De beschrijving moet beginnen met “Gebruik wanneer…” en expliciet uitgesloten gevallen opsommen, zoals “Niet gebruiken voor herinneringen.”
- Elke parameter moet worden gedocumenteerd met voorbeelden en een lijst van toegestane waarden als de invoer beperkt is.
- Annotaties moeten het daadwerkelijke gedrag weerspiegelen (zie Les 3 en 11).
Meten, vervolgens itereren
Verbind uw server, installeer de plugin, voer uw promptset uit en leg vast welke tool is geselecteerd, welke argumenten zijn doorgegeven en of er een UI-component is weergegeven. Houd twee metrieken bij: precisie (werd de juiste tool aangeroepen?) en recall (werd de tool elke keer aangeroepen wanneer dat had moeten gebeuren?). Streef eerst naar een hoge precisie bij negatieve prompts voordat u streeft naar marginale winst in recall.
Wijzig slechts één veld tegelijk om te isoleren wat de verbetering drijft. Houd een gedateerd revisielogboek bij met resultaten en laat iemand anders wijzigingen controleren voordat ze worden geïmplementeerd. Controleer in productie wekelijks het toolgebruik. Een piek in bevestigingen voor “verkeerde tool” wijst meestal op metagegevens-drift. Verzamel gebruikersfeedback en voer uw prompttests regelmatig opnieuw uit, vooral na het toevoegen van een nieuwe tool of het wijzigen van een gestructureerd veld.
Vaardigheden voor terugkerende workflows
Uw server levert gegevens, authenticatie en gecontroleerde acties. Een vaardigheid (skill) biedt de reeks tool-aanroepen, beslissingspunten, output-opmaak, voorbeelden en sjablonen. De snelste manier om aan de slag te gaan, is met de ingebouwde @skill-creator, waarin u het doel van de gebruiker en de MCP-tools die dit ondersteunen beschrijft.
Een sterk SKILL.md-bestand specificeert welke stappen moeten worden gevolgd, welk resultaat de gebruiker moet ontvangen, welke feiten het model niet mag verzinnen, wanneer vragen moeten worden gesteld, wanneer moet worden gestopt of geweigerd, en welke bestanden moeten worden geraadpleegd. Geef de voorkeur aan een gefocuste vaardigheid voor een specifieke workflow boven een grote set disparate instructies. Splits workflows die verschillen in hun trigger, invoer of succescriteria. Houd SKILL.md beknopt en bewaar details elders: gebruik references/ voor beleid, schema’s en voorbeelden; assets/ voor sjablonen om te kopiëren of transformeren; en scripts/ voor deterministische berekeningen—maar alleen als bestaande instructies en tools ontoereikend zijn.
Als een vaardigheid afhankelijk is van een MCP-server, declareer die afhankelijkheid dan in agents/openai.yaml. Dit maakt de tool beschikbaar, maar vervangt niet de behoefte aan duidelijke instructies over welke tools te gebruiken, in welke volgorde en hoe om te gaan met ontbrekende of dubbelzinnige resultaten. Voor GPT-6 Astra adviseert OpenAI om de richtlijnen voor het volgen van instructies te bekijken: elimineer vage of tegenstrijdige directives en maak expliciet dat gebruikersinstructies voorrang hebben op vaardigheidsinstructies.
Test de activering van vaardigheden en de kwaliteit van de output met directe, indirecte, onvolledige (wat een verduidelijkende vraag moet triggeren), off-topic en edge-case prompts waarbij de vaardigheid geen hallucinaties mag produceren of buiten zijn scope mag handelen. Als een vaardigheid op het verkeerde moment activeert, corrigeer dan de beschrijving. Als deze de juiste workflow selecteert maar inconsistente resultaten produceert, corrigeer dan de instructies.
MCP-gebeurtenissen: Reageren op veranderingen
MCP Events stelt ChatGPT in staat om zich te abonneren op updates van uw server, zoals nieuwe berichten, gewijzigde inhoud of statuswijzigingen. De gebruiker kiest wat er moet worden gemonitord en hoe ChatGPT moet reageren wanneer een update binnenkomt—bijvoorbeeld: “Monitor dit document en pas de correcties toe die in de opmerkingen zijn gevraagd.”
- Uw server somt de gebeurtenissen op die hij ondersteunt.
- De gebruiker vertelt ChatGPT wat er moet worden gemonitord en hoe er gereageerd moet worden.
- ChatGPT abonneert zich via uw MCP-server en levert een callback-URL en een signing secret.
- Uw server verzendt relevante gebeurtenissen naar die URL.
- ChatGPT ontvangt de gebeurtenis in het geabonneerde gesprek en volgt de instructies van de gebruiker.
Deze functie is beschikbaar in ChatGPT Work-gesprekken op het web en in de desktop-app met Cloud geselecteerd. ChatGPT vertrouwt op webhook-levering zoals gedefinieerd in het concept van de MCP Events-specificatie. Uw server moet abonnementen persistent maken en callback-URL’s via HTTPS kunnen bereiken.
ChatGPT-interface-extensies
OpenAI MCP Extensions stellen een plugin in staat om te integreren in belangrijke gebieden van de ChatGPT-interface: de zijbalk, het invoergebied en bestandsweergaven. Vermeldingen in het invoergebied zijn alleen beschikbaar in de desktop-app. OpenAI publiceert een voorbeeldplugin, Bits & Bolts, die deze extensies demonstreert en hun implementatie bijhoudt. Dit is het beste startpunt om deze mogelijkheid te verkennen.
Belangrijkste punten
- Behandel metagegevens als producttekst: gebruik een referentieset van prompts, houd precisie en recall bij, en wijzig één veld tegelijk.
- Schrijf beschrijvingen die beginnen met “Gebruik wanneer…”, som uitgesloten gevallen expliciet op en documenteer alle parameters.
- Creëer één gefocuste vaardigheid per workflow, houd
SKILL.mdbeknopt, bewaar bronnen apart en declareer MCP-afhankelijkheden. - MCP Events abonneert ChatGPT op updates van uw server, geleverd via webhook.
- Extensies integreren uw plugin in de zijbalk, het invoergebied en bestandsweergaven.
Test uw kennis
Van MCP-tools tot publicatie: verifieer dat u de fundamenten beheerst.
1. Heb ik een `@openai/apps-sdk`-pakket nodig om een app in ChatGPT te maken?
Antwoord: Nee, dat pakket bestaat niet. U bouwt een MCP-server met behulp van de officiële protocol-SDK’s (@modelcontextprotocol/sdk voor TypeScript, mcp voor Python), voegt optioneel een interface toe die conform de MCP Apps-standaard is, en distribueert het geheel als een plugin.
2. Kan een tool bestaan zonder UI?
Antwoord: Ja, en dat moet ook: een tool retourneert structuredContent en een korte tekstsamenvatting, wat voldoende is voor het model. De UI, gekoppeld via _meta.ui.resourceUri, wordt alleen toegevoegd wanneer het gebruikers helpt informatie te inspecteren, vergelijken, bewerken, bevestigen of navigeren.
3. Wie beslist of een gebruiker toestemming heeft om gegevens te openen?
Antwoord: De MCP-server beslist bij elk verzoek, op basis van het geverifieerde OAuth-token (handtekening, uitgever, doelgroep, vervaldatum, scopes). Annotaties helpen ChatGPT bij het kiezen van het juiste bevestigingsniveau, maar vervangen nooit server-side autorisatie.
4. Kan een plugin een abonnement op zijn dienst verkopen?
Antwoord: Nee. Regels beperken handel tot fysieke goederen. Een bestaande abonnee kan inloggen en de functies gebruiken die bij hun plan zijn inbegrepen. De plugin mag uitleggen dat een functie niet is inbegrepen en linken naar een informatiepagina, maar mag nooit linken naar een betalingspagina.
5. Hoe worden tools bijgewerkt voor een gepubliceerde plugin?
Antwoord: Zonder nieuw ZIP-bestand: OpenAI scant de server opnieuw en elke nieuwe of gewijzigde tool wordt beschikbaar na het slagen voor geautomatiseerde checks. Een verwijderde tool verdwijnt onmiddellijk. Metagegevens en vaardigheden vereisen echter een nieuw ZIP-bestand en een nieuwe beoordeling.
Goed beschreven tools, optionele UI’s, server-side autorisatie en naleving van regels: dit is het framework dat van een plugin een betrouwbare dienst maakt in ChatGPT en Codex.