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.