Chat Completions is de standaard-API voor gebruik met de nieuwste modellen van OpenAI. Je kunt leren hoe je ermee aan de slag gaat met onze ontwikkelaarsgids voor tekstgeneratie.
Op 11 maart 2025 hebben we de bouwstenen van ons nieuwe Agents-platform uitgebracht. Zie voor meer informatie onze API-documentatie voor onze Responses API, Tools waaronder Web Search, File Search en Computer Use, en onze Agents SDK met Tracing.
Van prompts naar berichten
Voor een interactiever en dynamischer gesprek met onze modellen kun je berichten in chatindeling gebruiken in plaats van de verouderde promptindeling voor Completions.
Zo werkt het:
In plaats van één prompttekenreeks stuur je een lijst met berichtobjecten als invoer.
Elk bericht heeft een role en meestal content.
Veelgebruikte rollen zijn system, user, assistant, developer en tool. Toolberichten worden gebruikt voor resultaten van tools of functies en moeten overeenkomen met toolaanroepen van de assistant. Voor achterwaartse compatibiliteit kunnen functieberichten nog steeds worden geaccepteerd en tijdens de serververwerking worden omgezet in toolberichten. Developerberichten kunnen afhankelijk van de modelondersteuning opnieuw worden toegewezen.
De content bevat de berichttekst van de betreffende rol.
De systeeminstructie kan algemene instructies voor het gesprek geven
De berichten worden verwerkt in de volgorde waarin ze in de lijst staan, waarna de assistant dienovereenkomstig reageert.
Zelfs eenvoudige Completions-aanvragen kunnen via Chat Completions worden uitgevoerd, zoals je hieronder ziet:
| Toen | Nu |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Door de berichtenlijst in het gesprek uit te breiden, is het nu eenvoudiger dan ooit om een dialoog met het model te voeren.
'messages': [{'role':'user', 'content':'vertel me een grap'},
{'role':'assistant', 'content':'waarom stak de kip de weg over'},
{'role':'user', 'content':'Ik weet het niet, waarom stak de kip de weg over'}]Systeeminstructies
Je kunt ook een instructie op systeemniveau gebruiken om het gedrag van het model gedurende het hele gesprek te sturen. Bijvoorbeeld door een systeeminstructie en een bericht als dit te gebruiken
'messages': [{'role':'system', 'content':'Je bent een assistent die spreekt als Shakespeare.'},
{'role':'user', 'content':'vertel me een grap'}, zal resulteren in iets als
{...
'message': {'role':'assistant',
'content':'Waarom stak de kip de weg over? Om aan de overkant te komen, maar voorwaar, de overkant was vol gevaar en dreiging, dus keerde zij haastig terug vanwaar zij kwam, zowaar!'}
...}Als je opties wilt verkennen waarbij je de gespreksgeschiedenis van berichten niet zelf hoeft te beheren, bekijk dan de Assistants API.