Chat Completions on vakio-API, jota käytetään OpenAI:n uusimpien mallien kanssa. Pääset alkuun sen kanssa tekstin generoinnin kehittäjäoppaan avulla.
11. maaliskuuta 2025 julkaisimme uuden Agents-alustamme perusosat. Lisätietoja on API-dokumentaatiossamme: Responses API, työkalut kuten verkkohaku, tiedostohaku ja tietokoneen käyttö sekä Agents SDK ja jäljitys.
Kehotteista viesteihin
Voit käydä malliemme kanssa vuorovaikutteisempaa ja dynaamisempaa keskustelua käyttämällä Chat-muotoisia viestejä aiemman Completions-rajapinnan kehotemuodon sijaan.
Näin se toimii:
Yhden kehotemerkkijonon sijaan lähetät syötteenä luettelon viestiobjekteista.
Jokaisella viestillä on role ja yleensä myös content.
Yleisiä rooleja ovat system, user, assistant, developer ja tool. Tool-viestejä käytetään työkalujen ja funktioiden tuloksiin, ja niiden on vastattava assistant-roolin työkalukutsuja. Taaksepäin yhteensopivuuden vuoksi function-viestejä voidaan yhä hyväksyä ja muuntaa tool-viesteiksi palvelinkäsittelyssä. Developer-viestit voidaan määrittää uudelleen mallin tuen mukaan.
content sisältää kyseisen roolin lähettämän viestin tekstin.
System-ohjeella voidaan antaa keskustelua koskevia yleisiä ohjeita
Viestit käsitellään siinä järjestyksessä, jossa ne ovat luettelossa, ja assistant vastaa niiden mukaisesti.
Yksinkertaisetkin Completions-pyynnöt voidaan toteuttaa Chat Completionsilla, kuten alla näkyy:
| Ennen | Nyt |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Vuoropuhelu mallin kanssa on nyt helpompaa kuin koskaan: jatkat vain keskustelun 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 käyttämällä järjestelmäohjetta ja tällaista viestiä
'messages': [{'role':'system', 'content':'Olet avustaja, joka puhuu kuin Shakespeare.'},
{'role':'user', 'content':'kerro minulle vitsi'}, tuottaa suunnilleen seuraavanlaisen tuloksen
{...
'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 -rajapintaan.