Uw GPT verbinden met externe API's
Op deze pagina
Status per 5 november 2026: GPT’s bevinden zich in hun laatste weken. OpenAI stopt op 11 december 2026 met aangepaste GPT’s (voor bepaalde Enterprise-workspaces met een vrijstelling is dit 11 februari 2027). Persoonlijke accounts (Free, Go, Plus en Pro) kunnen geen nieuwe GPT’s meer maken of publiceren. In Business-, Enterprise- en Edu-workspaces hangt de creatiemogelijkheid af van de instellingen; in getroffen Enterprise-workspaces is dit per 26 oktober 2026 stopgezet. Bestaande GPT’s blijven bruikbaar en bewerkbaar zolang uw abonnement dit toelaat tot aan de stopzetting; uw gesprekken hiermee blijven daarna toegankelijk. De migratie (Migreren naar plug-in, in Mijn GPT’s) zet instructies om in een vaardigheid, de kennisbank in referentiebestanden en gekoppelde apps in apps; aangepaste acties worden niet overgezet. Deze les legt uit hoe GPT’s werken om u te helpen ze te onderhouden, te migreren en hun principes toe te passen op een plug-in (lessen 15–17).
Voorbij de geïsoleerde GPT
Tot nu toe opereerde uw GPT in een silo: zijn instructies bepalen het gedrag en uw documenten vormen de kennis. Dat is krachtig, maar het blijft afgesloten van de live wereld. De GPT kan niet real-time uw CRM controleren, een agenda-afspraak maken of uw database bevragen; hij weet alleen wat u hebt geüpload, bevroren op het moment van uploaden. Acties heffen deze beperking op: ze stellen uw GPT in staat om tijdens een gesprek externe API’s aan te roepen om gegevens in uw tools te lezen en te schrijven.
Wat is een actie?
Een actie is een verbinding tussen uw GPT en een externe dienst via diens API. De flow is altijd hetzelfde: de gebruiker stelt een vraag of geeft een opdracht, de GPT constateert dat hij externe gegevens nodig heeft om te antwoorden, roept de API van de dienst aan, ontvangt het antwoord en verwerkt dit in zijn uiteindelijke reactie. Denk aan een verkoop-GPT die gekoppeld is aan een CRM: wanneer een gebruiker vraagt “Wat is de status van het dossier Dupont?”, bevraagt de GPT de CRM-API, haalt het klantrecord op en antwoordt met de gegevens van vandaag – niet met een herinnering aan een bestand dat drie maanden geleden is geüpload. Dit gebeurt allemaal transparant voor de gebruiker, die simpelweg het gevoel heeft met een goed geïnformeerde assistent te praten.
Het OpenAPI-schema
Om een API aan te roepen, moet de GPT deze kunnen beschrijven. Dat is de rol van het OpenAPI-schema (voorheen Swagger), een JSON- of YAML-bestand dat fungeert als de handleiding van de API. Het beschrijft de endpoints – de URL’s die uw GPT kan aanroepen – de bijbehorende methoden (GET om te lezen, POST om aan te maken, PUT om bij te werken, DELETE om te verwijderen), de parameters die per endpoint worden verwacht en het formaat van de geretourneerde antwoorden. Op basis van dit document besluit de GPT zelfstandig tijdens het gesprek welk endpoint hij moet aanroepen en met welke parameters.
Zo ziet een minimaal schema eruit voor een fictieve weer-API:
openapi: 3.1.0
info:
title: Weather API
version: 1.0.0
servers:
- url: https://example.com
paths:
/forecast:
get:
operationId: getForecast
summary: Get weather forecast for a city
parameters:
- name: city
in: query
required: true
schema:
type: string
responses:
"200":
description: Weather forecast
Goed nieuws: u zult dit bestand bijna nooit vanaf nul hoeven schrijven. Veel diensten publiceren hun OpenAPI-schema direct in hun API-documentatie. Als dat niet het geval is, kunnen tools zoals Swagger Editor – of ChatGPT zelf, als u de API beschrijft – het genereren. En als uw technische team met Postman werkt: de collecties daarvan exporteren naar het OpenAPI-formaat.
Een actie configureren in de GPT-editor
De installatie vindt plaats in uw GPT-editor op het web: ga naar het gedeelte Acties, klik op Nieuwe actie maken, plak uw OpenAPI-schema in het daarvoor bestemde veld, configureer de authenticatie (behandeld in de volgende les) en test de actie vervolgens vanuit het voorbeeldvenster.
De kwaliteit van uw schema bepaalt de kwaliteit van de aanroepen. Houd drie gewoonten aan. Geef ten eerste expliciete namen aan operationId-waarden: de GPT gebruikt deze om te beslissen welke actie hij moet aanroepen, en getForecast leidt hem veel beter dan op_42. Schrijf ten tweede duidelijke beschrijvingen voor elk endpoint en elke parameter – in natuurlijke taal, alsof u de API aan een collega uitlegt. Stel ten slotte alleen de endpoints bloot die u daadwerkelijk nodig hebt: als uw GPT slechts twee of drie routes nodig heeft, stel dan niet alle veertig routes van de volledige API bloot. Elk blootgesteld endpoint neemt ruimte in beslag in de context van de GPT en vergroot het risico dat hij de verkeerde kiest.
Aan de slag: een publieke API
Uw eerste actie, of het plan daarvoor. De beste oefenomgeving is een gratis, publieke API – voor weer, wisselkoersen, nieuws – die geen complexe authenticatie vereist. Kies er een, haal het OpenAPI-schema op of maak er een, en voeg deze toe als actie in uw GPT. Vergeet niet de actie te koppelen aan uw instructies door specificeren wanneer deze gebruikt moet worden: “Wanneer de gebruiker om het weer vraagt, gebruik dan de actie getForecast.” Test vervolgens met verschillende formuleringen om te verifiëren dat de GPT de aanroep op het juiste moment activeert.
Er wachten enkele valkuilen op eerste pogingen. Een misvormd schema – een enkele ontbrekende komma in de JSON – blokkeert alles: valideer uw schema altijd in Swagger Editor voordat u het plakt. Ontbrekende beschrijvingen maken de GPT blind: zonder deze weet hij niet wanneer een actie relevant is. Anticipeer ook op API-fouten, die vroeg of laat zullen optreden: specificeer het gedrag in uw instructies, bijvoorbeeld: “Als de API niet reageert, vraag de gebruiker dan het later opnieuw te proberen” – anders improviseert de GPT, soms door gegevens te verzinnen. En vertrouw niet alleen op het voorbeeldvenster: test onder reële omstandigheden, met echte gegevens en echte gebruikersformuleringen.
Ken twee beperkingen voordat u begint: een GPT gebruikt gekoppelde apps óf acties, niet beide, en acties werken niet in de Pro-modus. Het allerbelangrijkste: aangepaste acties worden niet overgezet naar een plug-in tijdens migratie. Controleer eerst of de plug-in-directory al een app biedt voor uw doeldienst; zo niet, dan moet u de integratie opnieuw opbouwen, bijvoorbeeld met een MCP-server.
Officiële bronnen: Configuring actions in GPTs (OpenAI Help Center: authenticatie, OpenAPI-schema, testen, limieten) · Custom GPT retirement and migration FAQ (acties worden niet overgezet) · OpenAPI Specification (schema-indeling)
Belangrijkste punten
- Acties verbinden uw GPT met externe diensten via hun API’s
- U moet een OpenAPI-schema aanleveren dat de beschikbare endpoints beschrijft
- Beschrijvingen in het schema zijn essentieel – de GPT gebruikt deze om te beslissen welke actie hij moet aanroepen
- Begin met een gratis publieke API om vertrouwd te raken met het proces
- Beperk de blootgestelde endpoints tot het strikte minimum voor uw use case