Chat Completions is de standaard-API voor gebruik met de nieuwste modellen van OpenAI. Meer informatie om ermee aan de slag te gaan vind je in onze ontwikkelaarsgids voor tekstgeneratie.
Vanaf 11 maart 2025 hebben we de bouwstenen van ons nieuwe agent-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.
Prompts naar berichten
Voor een meer interactieve en dynamische conversatie met onze modellen kun je berichten in chatindeling gebruiken in plaats van de verouderde prompt-stijl die bij completions werd gebruikt.
Zo werkt het:
In plaats van één enkele tekenreeks als prompt te sturen, stuur je een lijst met berichten als invoer.
Elk bericht in de lijst heeft twee eigenschappen: role en content.
De 'role' kan een van drie waarden hebben: 'system', 'user' of 'assistant'
De 'content' bevat de tekst van het bericht van de rol.
De system-instructie kan instructies op hoog niveau voor de conversatie geven
De berichten worden verwerkt in de volgorde waarin ze in de lijst staan, en de assistent reageert dienovereenkomstig.
Zelfs eenvoudige Completions-verzoeken kunnen via Chat Completions worden afgehandeld, zoals je hieronder kunt zien:
| Toen | Nu |
'prompt' : 'vertel me een grap' | 'messages': [{'role':'user', 'content':'vertel me een grap'}] |
Nu is het makkelijker dan ooit om een heen-en-weergesprek met het model te voeren door de lijst met berichten in de conversatie 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'}]System-instructies
Je kunt ook een instructie op systeemniveau gebruiken om het gedrag van het model tijdens de hele conversatie te sturen. Bijvoorbeeld, het gebruik van een system-instructie en een bericht als dit
'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 niet zelf de berichtgeschiedenis van de conversatie hoeft te beheren, bekijk dan de Assistants API.