OpenAI
Táto stránka bola strojovo preložená. Prečítaj si pôvodný článok v angličtine.

Prechod z Completions na Chat Completions v OpenAI API

Ako migrovať zo staršieho OpenAI Completions API na Chat Completions

Aktualizované: 10 days ago

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 viesť interaktívnejšiu a dynamickejšiu konverzáciu s našimi modelmi, môžete namiesto staršieho štýlu príkazov používaného pri completions použiť správy vo formáte chatu.

Funguje to takto:

  • Namiesto odoslania jedného reťazca ako príkazu odošlete ako vstup zoznam správ.

  • Každá správa má role a content.

  • Medzi bežné roly patria system, user, assistant, developer a tool. Správy nástrojov sa používajú na výsledky nástrojov/funkcií a musia zodpovedať volaniam nástrojov asistenta. Pre spätnú kompatibilitu môžu byť správy funkcií stále prijaté a pri spracovaní na serveri prevedené na správy nástrojov. Správy typu developer sa môžu premapovať v závislosti od podpory modelu.

  • Pole content obsahuje text správy od danej roly.

  • Systémová inštrukcia môže poskytovať všeobecné pokyny pre konverzáciu

  • Správy sa spracúvajú v poradí, v akom sa zobrazujú v zozname, a asistent podľa toho odpovedá.

Aj základné požiadavky Completions možno vykonať cez Chat Completions, ako vidíte nižšie:

| Predtým | Teraz | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |

Teraz je jednoduchšie než kedykoľvek predtým viesť s modelom obojsmernú konverzáciu rozširovaním zoznamu správ v konverzácii.

'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.

Bol tento článok užitočný?