Преминаване от Completions към Chat Completions в OpenAI API

Chat Completions е стандартният API за използване с най-новите модели на OpenAI. Можете да научите как да започнете с него от нашето ръководство за разработчици за генериране на текст.

Към 11 март 2025 г. пуснахме основните градивни елементи на новата ни платформа Agents. За подробности вижте нашата API документация за Responses API, инструментите, включително Web Search, File Search и Computer Use, както и нашия Agents SDK с Tracing.

От подкани към съобщения

За да водите по-интерактивен и динамичен разговор с нашите модели, можете да използвате съобщения в чат формат вместо стария стил с подкана, използван при completions.

Ето как работи:

• Вместо да изпращате един-единствен низ като подкана, изпращате списък от съобщения като вход.

• Всяко съобщение в списъка има две свойства: role и content.

  • 'role' може да приема една от три стойности: 'system', 'user' или 'assistant'

  • 'content' съдържа текста на съобщението от съответната роля.

• Системната инструкция може да даде общи инструкции за разговора

• Съобщенията се обработват в реда, в който се появяват в списъка, и асистентът отговаря съответно.

Дори базови заявки към Completions могат да бъдат изпълнени чрез Chat Completions, както можете да видите по-долу:

Сега е по-лесно от всякога да водите диалог с модел, като разширявате списъка със съобщения в разговора.

'messages': [{'role':'user', 'content':'разкажи ми виц'}, 
{'role':'assistant', 'content':'защо пилето пресече пътя'}, 
{'role':'user', 'content':'Не знам, защо пилето пресече пътя'}]

Системни инструкции

Можете също да използвате инструкция на системно ниво, за да насочвате поведението на модела през целия разговор. Например използването на системна инструкция и съобщение като това

'messages': [{'role':'system', 'content':'Ти си асистент, който говори като Шекспир.'}, 
{'role':'user', 'content':'разкажи ми виц'},  

ще доведе до нещо такова

{...
'message': {'role':'assistant',
              'content':'Защо пилето пресече пътя? За да стигне до другата страна, но наистина другата страна бе пълна с риск и опасност, затова то бързо се върна откъдето дойде, тъй да бъде!'}
...}

Ако искате да разгледате опции, които не включват сами да управлявате хронологията на разговора чрез съобщения, вижте Assistants API.