Chat Completions е стандартният API за използване с най-новите модели на OpenAI. Можете да научите как да започнете с него от нашето ръководство за разработчици за генериране на текст.
Към 11 март 2025 г. пуснахме градивните елементи на нашата нова платформа за агенти. За подробности вижте нашата API документация за Responses API, инструментите, включително уеб търсене, търсене във файлове и използване на компютър, както и нашия Agents SDK с проследяване.
От подкани към съобщения
За по-интерактивен и динамичен разговор с нашите модели можете да използвате съобщения във формат за чат вместо наследения формат с подкани, използван при Completions.
Ето как работи:
Вместо да изпращате един низ с подкана, подавате като вход списък от обекти за съобщения.
Всяко съобщение има role и обикновено content.
Често използваните роли включват system, user, assistant, developer и tool. Съобщенията от тип tool се използват за резултати от инструменти или функции и трябва да съответстват на извикванията на инструменти от assistant. За обратна съвместимост съобщенията от тип function все още може да се приемат и при обработката на сървъра да се преобразуват в съобщения от тип tool. Съобщенията от тип developer може да бъдат преобразувани в друг тип в зависимост от поддръжката на модела.
Полето content съдържа текста на съобщението от съответната роля.
Системната инструкция може да задава общи насоки за разговора
Съобщенията се обработват в реда, в който са подредени в списъка, а асистентът отговаря съобразно тях.
Дори основните заявки към Completions могат да се изпълняват чрез Chat Completions, както е показано по-долу:
| Преди | Сега |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Вече е по-лесно от всякога да водите диалог с модела, като разширявате списъка със съобщения в разговора.
'messages': [{'role':'user', 'content':'разкажи ми виц'},
{'role':'assistant', 'content':'защо пилето пресече пътя'},
{'role':'user', 'content':'Не знам, защо пилето пресече пътя'}]Системни инструкции
Можете също да използвате инструкция на системно ниво, за да насочвате поведението на модела през целия разговор. Например чрез системна инструкция и съобщение като това
'messages': [{'role':'system', 'content':'Ти си асистент, който говори като Шекспир.'},
{'role':'user', 'content':'разкажи ми виц'}, ще доведе до нещо подобно
{...
'message': {'role':'assistant',
'content':'Защо пилето пресече пътя? За да стигне до другата страна, но наистина другата страна бе пълна с риск и опасност, затова то бързо се върна откъдето дойде, тъй да бъде!'}
...}Ако искате да разгледате опции, които не изискват сами да управлявате хронологията на разговора със съобщения, вижте Assistants API.