Chat Completions är standard-API:t att använda med OpenAI:s senaste modeller. Du kan lära dig hur du kommer igång med det i vår utvecklarguide för textgenerering.
Från och med den 11 mars 2025 har vi släppt byggstenarna i vår nya Agents-plattform. Mer information finns i vår API-dokumentation för vår Responses API, verktyg som Webbsökning, Filsökning och Datoranvändning, samt vår Agents SDK med spårning.
Från prompter till meddelanden
För mer interaktiva och dynamiska samtal med våra modeller kan du använda meddelanden i chattformat i stället för det äldre promptformatet som används med Completions.
Så här fungerar det:
I stället för att skicka en enda promptsträng skickar du en lista med meddelandeobjekt som indata.
Varje meddelande har en roll och vanligtvis ett innehåll.
Vanliga roller är system, user, assistant, developer och tool. Tool-meddelanden används för resultat från verktyg eller funktioner och måste motsvara assistentens verktygsanrop. För bakåtkompatibilitet kan function-meddelanden fortfarande godtas och konverteras till tool-meddelanden vid serverhanteringen. Developer-meddelanden kan mappas om beroende på vad modellen stöder.
Fältet content innehåller meddelandetexten från rollen.
Systeminstruktionen kan ange övergripande instruktioner för samtalet
Meddelandena bearbetas i den ordning de visas i listan, och assistenten svarar utifrån det.
Även enkla Completions-begäranden kan hanteras via Chat Completions, som du ser nedan:
| Förr | Nu |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Nu är det enklare än någonsin att föra en dialog med modellen genom att lägga till fler meddelanden i samtalslistan.
'messages': [{'role':'user', 'content':'berätta ett skämt'},
{'role':'assistant', 'content':'varför gick kycklingen över vägen'},
{'role':'user', 'content':'Jag vet inte, varför gick kycklingen över vägen'}]Systeminstruktioner
Du kan också använda en instruktion på systemnivå för att styra modellens beteende under hela konversationen. Till exempel genom att använda en systeminstruktion och ett meddelande som detta
'messages': [{'role':'system', 'content':'Du är en assistent som talar som Shakespeare.'},
{'role':'user', 'content':'berätta ett skämt'}, leder till något i stil med
{...
'message': {'role':'assistant',
'content':'Varför gick kycklingen över vägen? För att komma till andra sidan, men sannerligen, den andra sidan var full av fara och farligheter, så den återvände snabbt dit varifrån den kom, minsann!'}
...}Om du vill utforska alternativ som inte innebär att du själv behöver hantera meddelandekonversationens historik kan du läsa mer om Assistants API.