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 beskeder
Hvis du vil have en mere interaktiv og dynamisk samtale med vores modeller, kan du bruge beskeder i chatformat i stedet for den ældre prompt-stil, der bruges med completions.
Sådan fungerer det:
I stedet for at sende én enkelt prompt-streng sender du en liste med beskedobjekter som input.
Hver besked har en
roleog som regelcontent.Almindelige roller omfatter
system,user,assistant,developerogtool. Værktøjsbeskeder bruges til resultater fra værktøjer/funktioner og skal svare til assistentens værktøjskald. Af hensyn til bagudkompatibilitet kan funktionsbeskeder stadig blive accepteret og konverteret til værktøjsbeskeder i serverhåndteringen. Developer-beskeder kan blive omdirigeret afhængigt af modellens understøttelse.contentindeholder teksten i beskeden fra rollen.Systeminstruktionen kan give overordnede instruktioner til samtalen
Beskederne behandles i den rækkefølge, de vises på listen, og assistenten svarer derefter.
Selv grundlæggende Completions-anmodninger kan udfø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 lettere end nogensinde at føre en dialog med modellen ved at udvide listen over beskeder 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.