OpenAI
Tato stránka byla přeložena strojově. Zobrazit původní článek v angličtině.

Přechod z Completions na Chat Completions v rozhraní OpenAI API

Jak přejít ze zastaralého OpenAI Completions API na Chat Completions

Aktualizováno: 11 days ago

Chat Completions je standardní API pro použití s nejnovějšími modely OpenAI. Jak s ním začít, se dozvíte v naší vývojářské příručce pro generování textu.

K 11. březnu 2025 jsme vydali stavební bloky naší nové platformy Agents. Podrobnosti najdete v našich dokumentech API pro Responses API, nástroje včetně Web Search, File Search a Computer Use a pro naše Agents SDK s Tracing.

Od promptů ke zprávám

Chcete-li s našimi modely vést interaktivnější a dynamičtější konverzaci, můžete místo staršího stylu promptů používaného u completions použít zprávy ve formátu chatu.

Funguje to takto:

  • Místo odeslání jednoho řetězce jako promptu odešlete jako vstup seznam zpráv.

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

  • Mezi běžné role patří system, user, assistant, developer a tool. Zprávy nástrojů se používají pro výsledky nástrojů/funkcí a musí odpovídat voláním nástrojů asistentem. Kvůli zpětné kompatibilitě mohou být zprávy funkcí stále přijímány a při zpracování na serveru převáděny na zprávy nástrojů. Zprávy vývojáře mohou být přemapovány podle podpory modelu.

  • Pole content obsahuje text zprávy od dané role.

  • Systémový pokyn může zadat pokyny na vysoké úrovni pro konverzaci

  • Zprávy se zpracovávají v pořadí, v jakém se objevují v seznamu, a asistent podle toho odpovídá.

I základní požadavky Completions lze dokončit přes Chat Completions, jak vidíte níže:

| Dříve | Nyní | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |

Nyní je snazší než kdy dříve vést s modelem konverzaci tam a zpět rozšiřováním seznamu zpráv v konverzaci.

'messages': [{'role':'user', 'content':'řekni mi vtip'}, 
{'role':'assistant', 'content':'proč kuře přešlo silnici'}, 
{'role':'user', 'content':'Nevím, proč kuře přešlo silnici'}]

Systémové pokyny

K usměrnění chování modelu v průběhu celé konverzace můžete použít také pokyn na systémové úrovni. Například při použití systémového pokynu a takovéto zprávy

'messages': [{'role':'system', 'content':'Jsi asistent, který mluví jako Shakespeare.'}, 
{'role':'user', 'content':'řekni mi vtip'},

výsledkem bude něco jako

{...
'message': {'role':'assistant',
              'content':'Proč kuře přešlo silnici? Aby se dostalo na druhou stranu, ale věru byla druhá strana plná nástrah a nebezpečí, takže se rychle vrátilo odkud přišlo, pročež!'}
...}

Pokud chcete prozkoumat možnosti, u kterých nemusíte sami spravovat historii konverzace se zprávami, podívejte se na Assistants API.

Byl tento článek užitečný?