Chat Completions er standard-API-et som brukes med OpenAIs nyeste modeller. Du kan lære hvordan du kommer i gang med det i vår utviklerveiledning for tekstgenerering.
Per 11. mars 2025 har vi lansert byggesteinene i vår nye Agents-plattform. For detaljer, se API-dokumentasjonen vår for Responses API, verktøy som Web Search, File Search og Computer Use, samt vår Agents SDK med Tracing.
Fra prompter til meldinger
For å ha en mer interaktiv og dynamisk samtale med modellene våre kan du bruke meldinger i chat-format i stedet for den eldre prompt-stilen som brukes med completions.
Slik fungerer det:
I stedet for å sende én enkelt streng som prompt, sender du en liste med meldinger som inndata.
Hver melding har en
roleogcontent.Vanlige roller inkluderer
system,user,assistant,developerogtool. Verktøymeldinger brukes for verktøy-/funksjonsresultater og må samsvare med assistentens verktøykall. For bakoverkompatibilitet kan funksjonsmeldinger fortsatt godtas og konverteres til verktøymeldinger i serverhåndteringen. Utviklermeldinger kan tilordnes på nytt avhengig av modellstøtte.contentinneholder meldingsteksten fra rollen.Systeminstruksjonen kan gi overordnede instruksjoner for samtalen
Meldingene behandles i rekkefølgen de vises i listen, og assistenten svarer deretter.
Selv grunnleggende Completions-forespørsler kan fullføres gjennom Chat Completions, som du kan se nedenfor:
| Før | Nå | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |
Nå er det enklere enn noen gang å ha samtaler frem og tilbake med modellen ved å utvide listen over meldinger i samtalen.
'messages': [{'role':'user', 'content':'fortell meg en vits'},
{'role':'assistant', 'content':'hvorfor krysset kyllingen veien'},
{'role':'user', 'content':'Jeg vet ikke, hvorfor krysset kyllingen veien'}]Systeminstruksjoner
Du kan også bruke en instruksjon på systemnivå for å styre modellens atferd gjennom hele samtalen. For eksempel ved å bruke en systeminstruksjon og en melding som denne
'messages': [{'role':'system', 'content':'Du er en assistent som snakker som Shakespeare.'},
{'role':'user', 'content':'fortell meg en vits'}, vil resultere i noe slikt
{...
'message': {'role':'assistant',
'content':'Hvorfor krysset kyllingen veien? For å komme til den andre siden, men sannelig, den andre siden var full av fare og risiko, så den vendte raskt tilbake dit den kom fra, forsooth!'}
...}Hvis du vil utforske alternativer som ikke innebærer at du må administrere meldingssamtalehistorikken selv, kan du ta en titt på Assistants API.
