Chat Completions je standardní API pro použití s nejnovějšími modely OpenAI. Jak s ním začít, se můžete dozvědět v našem průvodci pro vývojáře generováním textu.
Od 11. března 2025 jsme vydali základní stavební prvky naší nové platformy Agents. Podrobnosti najdete v dokumentaci API pro naše Responses API, nástroje včetně Web Search, File Search a Computer Use a naše Agents SDK s funkcí Tracing.
Od promptů ke zprávám
Chcete-li vést interaktivnější a dynamičtější konverzaci s našimi modely, 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 pošlete jako vstup seznam zpráv.
Každá zpráva v seznamu má dvě vlastnosti: role a content.
'role' může nabývat jedné ze tří hodnot: 'system', 'user' nebo 'assistant'
'content' obsahuje text zprávy dané role.
Systémová instrukce může pro konverzaci poskytnout pokyny na vysoké úrovni
Zprávy se zpracovávají v pořadí, v jakém se v seznamu objevují, 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' : 'řekni mi vtip' | 'messages': [{'role':'user', 'content':'řekni mi vtip'}] |
Nyní je snazší než kdy dřív vést s modelem dialog 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é instrukce
Můžete také použít instrukci na systémové úrovni, která bude řídit chování modelu v průběhu celé konverzace. Například použití systémové instrukce a zprávy, jako je tato,
'messages': [{'role':'system', 'content':'Jsi asistent, který mluví jako Shakespeare.'},
{'role':'user', 'content':'řekni mi vtip'}, povede k něčemu takovému
{...
'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, které nevyžadují, abyste historii konverzace zpráv spravovali sami, podívejte se na Assistants API.