Chat Completions je štandardné API na používanie s najnovšími modelmi OpenAI. Ako s ním začať, sa dozviete v našej vývojárskej príručke na generovanie textu.
K 11. marcu 2025 sme vydali stavebné prvky našej novej platformy Agents. Podrobnosti nájdete v našej dokumentácii API pre Responses API, nástroje vrátane Web Search, File Search a Computer Use a pre naše Agents SDK s funkciou Tracing.
Od príkazov k správam
Ak chcete s našimi modelmi viesť interaktívnejšiu a dynamickejšiu konverzáciu, namiesto staršieho formátu príkazov používaného s Completions môžete použiť správy vo formáte chatu.
Funguje to takto:
Namiesto jedného textového reťazca s príkazom odošlete ako vstup zoznam objektov správ.
Každá správa má rolu a zvyčajne aj obsah.
Medzi bežné roly patria system, user, assistant, developer a tool. Správy nástrojov sa používajú na výsledky nástrojov alebo funkcií a musia zodpovedať volaniam nástrojov zo strany asistenta. Z dôvodu spätnej kompatibility môžu byť správy funkcií naďalej prijímané a pri spracovaní na serveri konvertované na správy nástrojov. Správy vývojára môžu byť premapované v závislosti od podpory modelu.
Pole content obsahuje text správy od danej roly.
Systémová inštrukcia môže určiť všeobecné pokyny pre konverzáciu
Správy sa spracúvajú v poradí, v akom sú uvedené v zozname, a asistent podľa toho odpovedá.
Cez Chat Completions možno spracovať aj základné požiadavky Completions, ako vidíte nižšie:
| Predtým | Teraz |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Rozvíjaním zoznamu správ v konverzácii je teraz jednoduchšie než kedykoľvek predtým viesť s modelom dialóg.
'messages': [{'role':'user', 'content':'povedz mi vtip'},
{'role':'assistant', 'content':'prečo sliepka prešla cez cestu'},
{'role':'user', 'content':'Neviem, prečo sliepka prešla cez cestu'}]Systémové inštrukcie
Na usmernenie správania modelu počas celej konverzácie môžete použiť aj inštrukciu na úrovni systému. Napríklad použitím systémovej inštrukcie a takejto správy
'messages': [{'role':'system', 'content':'Ste asistent, ktorý hovorí ako Shakespeare.'},
{'role':'user', 'content':'povedz mi vtip'}, výsledkom bude niečo ako
{...
'message': {'role':'assistant',
'content':'Prečo sliepka prešla cez cestu? Aby sa dostala na druhú stranu, ale veru, tá druhá strana bola plná nástrah a nebezpečenstva, a tak sa rýchlo vrátila odkiaľ prišla, veruže!'}
...}Ak chcete preskúmať možnosti, pri ktorých nemusíte sami spravovať históriu konverzácie správ, pozrite si Assistants API.