Chat Completions je standardni API za uporabo z najnovejšimi modeli OpenAI. Kako začeti z njim, si lahko preberete v našem razvojnem vodniku za ustvarjanje besedila.
Od 11. marca 2025 smo izdali gradnike naše nove platforme Agents. Za podrobnosti glejte našo dokumentacijo API za API Responses, orodja, vključno z spletnim iskanjem, iskanjem datotek in uporabo računalnika, ter naš SDK za agente s sledenjem.
Od pozivov do sporočil
Za bolj interaktiven in dinamičen pogovor z našimi modeli lahko namesto starejšega načina s pozivi, ki se uporablja pri dokončevanju, uporabite sporočila v obliki klepeta.
Deluje tako:
Namesto enega poziva v obliki niza kot vhod pošljete seznam predmetov sporočil.
Vsako sporočilo ima vlogo in običajno tudi vsebino.
Običajne vloge so system, user, assistant, developer in tool. Sporočila orodij se uporabljajo za rezultate orodij oziroma funkcij in se morajo ujemati s pomočnikovimi klici orodij. Zaradi združljivosti s starejšimi različicami so lahko sporočila funkcij še vedno sprejeta in pri strežniški obdelavi pretvorjena v sporočila orodij. Sporočila razvijalca se lahko preslikajo drugače glede na podporo modela.
Vsebina vsebuje besedilo sporočila, ki ga je poslala posamezna vloga.
Sistemsko navodilo lahko določi splošne smernice za pogovor.
Sporočila se obdelajo v vrstnem redu, v katerem so navedena na seznamu, pomočnik pa se ustrezno odzove.
Prek funkcije Chat Completions je mogoče izvesti tudi osnovne zahteve Completions, kot je prikazano spodaj:
| Prej | Zdaj |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Zdaj je pogovor z modelom preprostejši kot kdaj koli prej: seznamu sporočil v pogovoru preprosto dodajate nova sporočila.
'messages': [{'role':'user', 'content':'povej mi šalo'},
{'role':'assistant', 'content':'zakaj je kokoš prečkala cesto'},
{'role':'user', 'content':'Ne vem, zakaj je kokoš prečkala cesto'}]Sistemska navodila
Uporabite lahko tudi navodilo na sistemski ravni, da usmerjate vedenje modela skozi celoten pogovor. Na primer z uporabo sistemskega navodila in sporočila, kot je to
'messages': [{'role':'system', 'content':'Ste pomočnik, ki govori kot Shakespeare.'},
{'role':'user', 'content':'povej mi šalo'}, bo privedlo do nečesa podobnega
{...
'message': {'role':'assistant',
'content':'Zakaj je kokoš prečkala cesto? Da bi prišla na drugo stran, toda resnično je bila druga stran polna nevarnosti in tveganja, zato se je hitro vrnila, od koder je prišla, zares!'}
...}Če želite raziskati možnosti, pri katerih vam ni treba sami upravljati zgodovine pogovora s sporočili, si oglejte API Assistants.