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 det ældre promptformat, der bruges med Completions.
Sådan fungerer det:
I stedet for at sende en enkelt promptstreng sender du en liste over beskedobjekter som input.
Hver besked har en role og som regel content.
Almindelige roller omfatter system, user, assistant, developer og tool. Tool-beskeder bruges til resultater fra værktøjer eller funktioner og skal svare til assistentens værktøjskald. Af hensyn til bagudkompatibilitet accepteres function-beskeder muligvis stadig og konverteres til tool-beskeder under serverbehandlingen. Developer-beskeder kan blive tilknyttet en anden rolle afhængigt af modellens understøttelse.
Feltet content indeholder teksten i beskeden fra den pågældende rolle.
Systeminstruktionen kan angive overordnede instruktioner for samtalen
Beskederne behandles i den rækkefølge, de står på listen, og assistenten svarer derefter.
Selv enkle Completions-anmodninger kan udføres via Chat Completions, som du kan se nedenfor:
| Før | Nu |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Nu er det nemmere end nogensinde at føre en dialog med modellen ved at føje flere beskeder til samtalens liste.
'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.