Chat Completions er standard-API'en til brug med de nyeste modeller fra OpenAI. Du kan lære, hvordan du kommer i gang med den, i vores udviklervejledning til tekstgenerering.
Pr. 11. marts 2025 har vi udgivet byggeklodserne til vores nye Agents-platform. Se vores API-dokumentation for flere oplysninger om vores Responses API, værktøjer, herunder websøgning, filsøgning og computerbrug, samt vores Agents SDK med sporing.
Fra prompts til meddelelser
For at få en mere interaktiv og dynamisk samtale med vores modeller kan du bruge meddelelser i chatformat i stedet for den ældre prompt-stil, der blev brugt med completions.
Sådan fungerer det:
I stedet for at sende en enkelt streng som din prompt sender du en liste over meddelelser som dit input.
Hver meddelelse har en
roleogcontent.Almindelige roller omfatter
system,user,assistant,developerogtool. Værktøjsmeddelelser bruges til værktøjs-/funktionsresultater og skal svare til assistentens værktøjskald. Af hensyn til bagudkompatibilitet kan funktionsmeddelelser stadig accepteres og konverteres til værktøjsmeddelelser i serverhåndteringen. Udviklermeddelelser kan blive ommappet afhængigt af modelunderstøttelsen.contentindeholder teksten i meddelelsen fra rollen.Systeminstruktionen kan give overordnede instruktioner til samtalen
Meddelelserne behandles i den rækkefølge, de vises på listen, og assistenten svarer derefter.
Selv grundlæggende Completions-anmodninger kan gennemføres via Chat Completions, som du kan se nedenfor:
| Før | Nu | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |
Nu er det nemmere end nogensinde at have frem-og-tilbage-samtaler med modellen ved at udvide listen over meddelelser i samtalen.
'messages': [{'role':'user', 'content':'fortæl mig en vittighed'},
{'role':'assistant', 'content':'hvorfor krydsede kyllingen vejen'},
{'role':'user', 'content':'Det ved jeg ikke, hvorfor krydsede kyllingen vejen'}]Systeminstruktioner
Du kan også bruge en instruktion på systemniveau til at styre modellens adfærd gennem hele samtalen. For eksempel ved at bruge en systeminstruktion og en meddelelse som denne
'messages': [{'role':'system', 'content':'Du er en assistent, der taler som Shakespeare.'},
{'role':'user', 'content':'fortæl mig en vittighed'}, vil resultere i noget i stil med
{...
'message': {'role':'assistant',
'content':'Hvorfor krydsede kyllingen vejen? For at komme over på den anden side, men sandelig, den anden side var fuld af fare og farer, så den vendte hurtigt tilbage, hvorfra den kom, forsooth!'}
...}Hvis du vil udforske muligheder, hvor du ikke selv behøver at administrere samtalehistorikken for meddelelser, kan du se Assistants API.