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 formátu promptů používaného s Completions použít zprávy ve formátu chatu.
Funguje to takto:
Místo jednoho řetězce s promptem odešlete jako vstup seznam objektů zpráv.
Každá zpráva má roli a obvykle také obsah.
Mezi běžné role patří system, user, assistant, developer a tool. Zprávy nástrojů slouží k předávání výsledků nástrojů či funkcí a musí odpovídat voláním nástrojů od asistenta. Kvůli zpětné kompatibilitě mohou být zprávy funkcí nadále přijímány a při zpracování na serveru převedeny na zprávy nástrojů. Zprávy vývojáře mohou být v závislosti na podpoře modelu převedeny na jinou roli.
Pole content obsahuje text zprávy od dané role.
Systémová instrukce může obsahovat obecné pokyny pro konverzaci.
Zprávy se zpracovávají v pořadí, v jakém jsou uvedeny v seznamu, a asistent podle toho odpovídá.
Prostřednictvím Chat Completions lze vyřídit i základní požadavky Completions, jak vidíte níže:
| Dříve | Nyní |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Nyní je snazší než kdy dříve vést s modelem dialog – stačí rozšiřovat seznam 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.