Chat Completions е стандартният API за използване с най-новите модели на OpenAI. Можете да научите как да започнете с него от нашето ръководство за разработчици за генериране на текст.
Към 11 март 2025 г. пуснахме градивните елементи на нашата нова платформа за агенти. За подробности вижте нашата API документация за Responses API, инструментите, включително уеб търсене, търсене във файлове и използване на компютър, както и нашия Agents SDK с проследяване.
От подкани към съобщения
За по-интерактивен и динамичен разговор с нашите модели можете да използвате съобщения в чат формат вместо наследения стил с подкани, използван при completions.
Ето как работи:
Вместо да изпращате един низ като своя подкана, изпращате списък със съобщения като входни данни.
Всяко съобщение има
roleиcontent.Често срещаните роли включват
system,user,assistant,developerиtool. Съобщенията от инструменти се използват за резултати от инструменти/функции и трябва да съответстват на извиквания на инструменти от асистента. За обратна съвместимост съобщенията от функции все още може да се приемат и да се преобразуват в съобщения от инструменти при обработка на сървъра. Съобщенията от разработчика може да бъдат пренасочвани в зависимост от поддръжката от модела.contentсъдържа текста на съобщението от съответната роля.Системната инструкция може да задава инструкции от високо ниво за разговора
Съобщенията се обработват в реда, в който се появяват в списъка, и асистентът отговаря по съответния начин.
Дори базови заявки към Completions могат да бъдат изпълнени чрез Chat Completions, както можете да видите по-долу:
| Тогава | Сега | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'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.