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 promptstijl die bij completions wordt gebruikt.
Zo werkt het:
In plaats van één enkele tekenreeks als je prompt te sturen, stuur je een lijst met berichten als invoer.
Elk bericht heeft een
roleencontent.Veelgebruikte rollen zijn
system,user,assistant,developerentool. Toolberichten worden gebruikt voor resultaten van tools/functies en moeten overeenkomen met toolaanroepen van de assistant. Voor achterwaartse compatibiliteit kunnen functieberichten nog steeds worden geaccepteerd en bij serververwerking worden omgezet naar toolberichten. Developerberichten kunnen opnieuw worden toegewezen, afhankelijk van de ondersteuning door het model.De
contentbevat de tekst van het bericht van de rol.De systeeminstructie kan algemene instructies voor het gesprek geven
De berichten worden verwerkt in de volgorde waarin ze in de lijst staan, en de assistant reageert dienovereenkomstig.
Zelfs eenvoudige Completions-aanvragen kunnen via Chat Completions worden voltooid, zoals je hieronder kunt zien:
| Toen | Nu | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |
Nu is het eenvoudiger dan ooit om een heen-en-weergesprek met het model te voeren door de lijst met berichten in het gesprek uit te breiden.
'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.