Chat Completions — это стандартный API для работы с новейшими моделями OpenAI. Начать работу с ним можно по нашему руководству разработчика по генерации текста.
По состоянию на 11 марта 2025 года мы выпустили базовые компоненты нашей новой платформы Agents. Подробности см. в нашей документации API по Responses API, инструментам, включая Web Search, File Search и Computer Use, а также наш Agents SDK с Tracing.
От промптов к сообщениям
Чтобы вести более интерактивный и динамичный диалог с нашими моделями, вы можете использовать сообщения в формате чата вместо устаревшего prompt-формата, применявшегося в completions.
Вот как это работает:
Вместо отправки одной строки в качестве prompt вы отправляете на вход список сообщений.
У каждого сообщения в списке есть два свойства: role и content.
'role' может принимать одно из трёх значений: 'system', 'user' или 'assistant'
'content' содержит текст сообщения от соответствующей роли.
Системная инструкция может задавать высокоуровневые правила для разговора.
Сообщения обрабатываются в том порядке, в котором они идут в списке, и ассистент отвечает соответствующим образом.
Даже базовые запросы Completions можно выполнить через Chat Completions — как показано ниже:
| Раньше | Теперь |
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Теперь как никогда просто вести диалог с моделью в обе стороны — достаточно расширять список сообщений в беседе.
'messages': [{'role':'user', 'content':'tell me a joke'},
{'role':'assistant', 'content':'why did the chicken cross the road'},
{'role':'user', 'content':'I don\'t know, why did the chicken cross the road'}]Системные инструкции
Вы также можете использовать инструкцию системного уровня, чтобы направлять поведение модели на протяжении всей беседы. Например, если использовать системную инструкцию и сообщение вроде этого
'messages': [{'role':'system', 'content':'You are an assistant that speaks like Shakespeare.'},
{'role':'user', 'content':'tell me a joke'}, получится примерно следующее
{...
'message': {'role':'assistant',
'content':'Why did the chicken cross the road? To get to the other side, but verily, the other side was full of peril and danger, so it quickly returned from whence it came, forsooth!'}
...}Если вы хотите изучить варианты, которые не требуют самостоятельно хранить и управлять историей переписки сообщений, посмотрите Assistants API.