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é: 4 hours 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.

Z príkazov na správy

Ak chcete viesť s našimi modelmi interaktívnejšiu a dynamickejšiu konverzáciu, namiesto staršieho štýlu príkazov používaného pri completions môžete použiť správy vo formáte četu.

Funguje to takto:

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

  • Každá správa má položku role a zvyčajne aj 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. Z dôvodu spätnej kompatibility môžu byť správy funkcií stále prijaté a pri spracovaní na serveri prevedené na správy nástrojov. Správy vývojára sa môžu premapovať podľa toho, či ich model podporuje.

  • 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 sa zobrazujú v zozname, a asistent podľa toho odpovedá.

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

| Vtedy | 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 obojstrannú 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ý?