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
Om een interactiever en dynamischer gesprek met onze modellen te voeren, kun je berichten in chatindeling gebruiken in plaats van de verouderde promptstijl van Completions.
Zo werkt het:
In plaats van één prompttekenreeks te sturen, stuur je een lijst met berichtobjecten als invoer.
Elk bericht heeft een
roleen meestalcontent.Veelgebruikte rollen zijn
system,user,assistant,developerentool. Toolberichten worden gebruikt voor tool-/functieresultaten en moeten overeenkomen met toolaanroepen van de assistant. Voor achterwaartse compatibiliteit kunnen functieberichten nog steeds worden geaccepteerd en bij verwerking op de server worden omgezet in toolberichten. Developerberichten kunnen opnieuw worden toegewezen, afhankelijk van de modelondersteuning.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 overeenkomstig.
Zelfs eenvoudige Completions-aanvragen kunnen via Chat Completions worden voltooid, zoals je hieronder ziet:
| Toen | Nu | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |
Nu is het makkelijker dan ooit om heen-en-weer te praten met het model 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.