Chat Completions on vakio-API, jota käytetään OpenAI:n uusimpien mallien kanssa. Voit tutustua käytön aloittamiseen tekstintuotannon kehittäjäoppaassamme.
11. maaliskuuta 2025 julkaisimme uuden Agents-alustamme rakennuspalikat. Lisätietoja saat API-dokumentaatiostamme koskien Responses API:a, työkaluja, kuten Web Search, File Search ja Computer Use, sekä Agents SDK:mme ja sen Tracing.
Kehotteista viesteihin
Jos haluat käydä malliemme kanssa vuorovaikutteisemman ja dynaamisemman keskustelun, voit käyttää chat-muotoisia viestejä vanhan completions-tyylisen kehotemuodon sijaan.
Näin se toimii:
Sen sijaan, että lähettäisit yhden merkkijonon kehotteena, lähetät syötteenä viestiluettelon.
Luettelon jokaisella viestillä on kaksi ominaisuutta: role ja content.
'role' voi olla yksi kolmesta arvosta: 'system', 'user' tai 'assistant'
'content' sisältää viestin tekstin kyseiseltä roolilta.
Järjestelmätason ohje voi antaa keskustelulle korkean tason ohjeita
Viestit käsitellään siinä järjestyksessä kuin ne esiintyvät luettelossa, ja avustaja vastaa sen mukaisesti.
Myös tavalliset Completions-pyynnöt voidaan tehdä Chat Completionsin kautta, kuten alla näkyy:
| Silloin | Nyt |
'prompt' : 'kerro minulle vitsi' | 'messages': [{'role':'user', 'content':'kerro minulle vitsi'}] |
Nyt edestakainen keskustelu mallin kanssa on helpompaa kuin koskaan, kun voit jatkaa keskustelua laajentamalla viestiluetteloa.
'messages': [{'role':'user', 'content':'kerro minulle vitsi'},
{'role':'assistant', 'content':'miksi kana ylitti tien'},
{'role':'user', 'content':'En tiedä, miksi kana ylitti tien'}]Järjestelmäohjeet
Voit myös käyttää järjestelmätason ohjetta ohjaamaan mallin toimintaa koko keskustelun ajan. Esimerkiksi järjestelmäohjeen ja tällaisen viestin käyttäminen
'messages': [{'role':'system', 'content':'Olet avustaja, joka puhuu kuin Shakespeare.'},
{'role':'user', 'content':'kerro minulle vitsi'}, johtaa tämänkaltaiseen tulokseen
{...
'message': {'role':'assistant',
'content':'Miksi kana ylitti tien? Päästäkseen toiselle puolelle, mutta totisesti toisella puolella oli täynnä vaaraa ja uhkaa, joten se palasi nopeasti takaisin sinne, mistä oli tullut, totta vieköön!'}
...}Jos haluat tutkia vaihtoehtoja, joissa sinun ei tarvitse itse hallita viestikeskustelun historiaa, tutustu Assistants API:in.