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 att ha en mer interaktiv och dynamisk konversation med våra modeller kan du använda meddelanden i chattformat i stället för den äldre prompt-stilen som används med completions.
Så här fungerar det:
I stället för att skicka en enda sträng som din prompt skickar du en lista med meddelanden som indata.
Varje meddelande har en
roleochcontent.Vanliga roller är
system,user,assistant,developerochtool. Verktygsmeddelanden används för verktygs-/funktionsresultat och måste motsvara verktygsanrop från assistenten. För bakåtkompatibilitet kan funktionsmeddelanden fortfarande accepteras och konverteras till verktygsmeddelanden vid serverhantering. Utvecklarmeddelanden kan mappas om beroende på modellstöd.contentinnehåller meddelandetexten från rollen.Systeminstruktionen kan ge övergripande instruktioner för konversationen
Meddelandena bearbetas i den ordning de visas i listan, och assistenten svarar därefter.
Även grundläggande Completions-begäranden kan slutföras via Chat Completions, som du ser nedan:
| Då | Nu | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |
Nu är det enklare än någonsin att ha dialoger med modellen genom att utöka listan med meddelanden i konversationen.
'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.