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 å få en mer interaktiv og dynamisk samtale med modellene våre kan du bruke meldinger i chatformat i stedet for den eldre promptbaserte metoden som brukes med Completions.
Slik fungerer det:
I stedet for å sende én enkelt promptstreng sender du inn en liste med meldingsobjekter.
Hver melding har en role og vanligvis content.
Vanlige roller er blant annet system, user, assistant, developer og tool. Verktøymeldinger brukes til verktøy-/funksjonsresultater og må samsvare med assistentens verktøykall. Av hensyn til bakoverkompatibilitet kan funksjonsmeldinger fortsatt bli godtatt og konvertert til verktøymeldinger under behandling på serveren. Utviklermeldinger kan tilordnes på nytt, avhengig av hva modellen støtter.
content inneholder teksten i meldingen fra den aktuelle rollen.
Systeminstruksjonen kan gi overordnede instruksjoner for samtalen
Meldingene behandles i den rekkefølgen de står i listen, og assistenten svarer deretter.
Selv enkle Completions-forespørsler kan utføres via Chat Completions, som vist nedenfor:
| Før | Nå |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Nå er det enklere enn noensinne å føre en dialog 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.