Станом на 11 березня 2025 року ми випустили базові компоненти нашої нової платформи агентів. Докладніше див. в нашій документації API для Responses API, інструментів, зокрема вебпошуку, пошуку файлів і використання комп’ютера, а також нашого SDK для агентів із трасуванням.
Без автоматичного оновлення: ваші поточні асистенти, потоки й запуски не переносяться до v2 автоматично. Вони залишаються доступними й працездатними через API v1, доки ви не вирішите перенести їх вручну.
Доступ до обох версій: вам повністю доступні версії API v1 і v2. Тобто ви можете й надалі використовувати v1 для наявних асистентів або ознайомитися з новими функціями та вдосконаленнями у v2.
Відмінності у використанні токенів: обсяг використання токенів у v1 і v2 може відрізнятися, особливо для таких інструментів, як file_search і retrieval. Хоча інструмент file_search у v2 зазвичай у середньому споживає менше токенів, ніж інструмент retrieval у v1, за бажання ви все одно можете використовувати старіший інструмент retrieval із заголовком версії v1.
Варіанти міграції: інтерфейс Playground і оновлені версії SDK використовують API v2, а запити до Assistants API мають містити заголовок OpenAI-Beta: assistants=v2. Assistants API v1 визнано застарілим; усі інтеграції, які досі використовують v1, слід перенести на v2. Докладніше про перехід з Assistants v1 на v2 дивіться в цьому посібнику з міграції.
