Chat Completions — це стандартний API для використання з найновішими моделями OpenAI. Дізнатися, як почати роботу з ним, можна в нашому посібнику розробника з генерації тексту.
Станом на 11 березня 2025 року ми випустили базові компоненти нашої нової платформи агентів. Докладніше див. в нашій документації API для Responses API, інструментів, зокрема вебпошуку, пошуку файлів і використання комп’ютера, а також нашого SDK для агентів із трасуванням.
Від запитів до повідомлень
Щоб спілкування з нашими моделями було інтерактивнішим і динамічнішим, замість застарілого формату запитів, що використовувався з Completions, можна використовувати повідомлення у форматі чату.
Ось як це працює:
Замість одного рядка запиту ви передаєте на вхід список об’єктів повідомлень.
Кожне повідомлення має поле role і зазвичай поле content.
Поширені ролі: system, user, assistant, developer і tool. Повідомлення інструментів містять результати роботи інструментів або функцій і мають відповідати викликам інструментів з боку асистента. Для зворотної сумісності повідомлення функцій можуть і далі прийматися та перетворюватися на повідомлення інструментів під час обробки на сервері. Повідомлення розробника можуть переназначатися залежно від підтримки моделлю.
Поле 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.