Поширені запитання

Що таке Assistants API?

Assistants API дає розробникам змогу легко створювати потужних ШІ-асистентів у своїх застосунках. Цей API усуває потребу керувати історією розмов і надає доступ до інструментів, розміщених на серверах OpenAI, як-от інтерпретатор коду та пошук у файлах. API також підтримує вдосконалений виклик функцій для сторонніх інструментів.

Чи можна й надалі використовувати бета-версію v1 API асистентів?

Ні. З 18 грудня 2024 року користувачі більше не мають доступу до бета-версії v1 API асистентів. Наразі ми підтримуємо лише v2. Ознайомтеся з цим посібником із міграції, щоб перевести виклики API з v1 на v2.

Як отримати до нього доступ?

Assistants API доступний усім, хто має обліковий запис OpenAI API, але він застарілий і буде вилучений у серпні 2026 року. Для нових проєктів натомість використовуйте Responses API. Якщо ви вже використовуєте Assistants API, заплануйте міграцію до Responses API. Ви все ще можете отримувати доступ до наявних асистентів у Assistants Playground, поки API залишається доступним.

Що таке асистент?

Асистент — це ШІ, створений для конкретних завдань, який використовує моделі OpenAI й може отримувати доступ до файлів, підтримувати постійні гілки розмов і викликати інструменти.

Що таке гілка?

Гілка — це сеанс розмови між асистентом і користувачем. Гілки спрощують розробку застосунків: вони зберігають історію повідомлень і обрізають її, коли розмова перевищує довжину контексту моделі.

Що таке інструмент пошуку у файлах?

Інструмент file_search за замовчуванням застосовує кілька найкращих практик пошуку, щоб допомогти вам знаходити потрібні дані у файлах і доповнювати ними відповіді моделі.

За замовчуванням інструмент file_search використовує такі налаштування:

• Розмір фрагмента: 800 токенів

• Перекриття фрагментів: 400 токенів

• Модель векторних подань: text-embedding-3-large, 256 вимірів

• Максимальна кількість фрагментів, що додаються до контексту: 20

Які обмеження діють для завантаження файлів?

Для завантаження файлів діють такі обмеження:

• 512 МБ на файл

• 5 млн токенів на файл

• 10 тис. файлів на векторне сховище

• 1 векторне сховище на асистента

• 1 векторне сховище на гілку

Загальний ліміт сховища для кожного проєкту в організації становить 100 ГБ.

Які обмеження має інструмент пошуку у файлах?

Є кілька відомих обмежень, які ми працюємо над тим, щоб усунути в найближчі місяці:

1. Наразі неможливо змінювати налаштування поділу на фрагменти, векторних подань або пошуку.

2. Ми не підтримуємо аналіз зображень у документах.

3. Ми не підтримуємо пошук у файлах структурованих форматів (наприклад, .csv або .jsonl). Перегляньте підтримувані типи файлів.

Які обмеження частоти запитів діють для Assistants API?

Обмеження частоти запитів для Assistants API не залежать від рівня використання та моделі. Натомість діють стандартні ліміти за типом запиту, за кількома винятками:

• GET: 1000 запитів на хвилину

• POST: 300 запитів на хвилину

• DELETE: 300 запитів на хвилину

Скільки коштує використання інтерпретатора коду в API?

Вартість використання інтерпретатора коду становить 0,03 дол. США за сеанс. Якщо ваш асистент одночасно викликає інтерпретатор коду у двох різних гілках, це створює два сеанси інтерпретатора коду (2 × 0,03 дол. США). За замовчуванням кожен сеанс активний протягом години. Тож якщо користувач продовжує давати інструкції інтерпретатору коду в тій самій гілці протягом години, ви сплатите цю суму лише один раз.

Скільки коштує використання пошуку у файлах в API?

Вартість пошуку у файлах становить 0,10 дол. США за ГБ векторного сховища на день (перший ГБ сховища — безкоштовно). Обсяг векторного сховища визначається після аналізу файлу, його поділу на фрагменти та створення векторних подань.

Усі векторні сховища, створені до 17 квітня 2024 року, будуть безкоштовними до кінця 2024 року. Після цього вони:

• Оплачуватимуться за чинними тарифами (наразі 0,10 дол. США за ГБ на день), якщо їх використали хоча б раз у запуску Run, створеному після 17 квітня 2024 року.

• Будуть видалені, якщо їх не використали в жодному запуску Run з 17 квітня до 31 грудня 2024 року. Це дасть змогу уникнути стягнення плати за векторні сховища, які ви могли створити до оголошення цієї зміни тарифів, але так і не використали.

Чи є обмеження на кількість асистентів, які я можу створити?

Немає обмеження на кількість асистентів, які може створити організація.

Чи доступне потокове передавання в API?

Так, потокове передавання доступне в Assistants API.

Чи доступний режим JSON в Assistants API?

Так, режим JSON доступний в Assistants API через параметр response_format в об’єктах Assistants або Run.

Чи керуватиме Assistants API також запитами на виклик сторонніх функцій?

Ні. Хоча виклик функцій дає моделі змогу вибирати інструменти й формувати запити до них, OpenAI не керує виконанням викликів сторонніх інструментів.

Як обробляються дані, які я надсилаю OpenAI?

Як і на решті нашої платформи, дані та файли, передані до OpenAI API, ніколи не використовуються для навчання наших моделей, і ви можете видалити свої дані будь-коли. Дані, завантажені до Assistants API, зберігаються безстроково, доки користувач не видалить їх вручну.

Чи доступна DALL-E через Assistants API?

Наразі DALL-E недоступна.

Чи є UI для Assistants API?

Ви можете переглянути Playground для Assistants API. Переконайтеся, що на лівій бічній панелі вибрано подання Assistants і що ви використовуєте модель, сумісну з інструментами, які хочете ввімкнути.

Який ліміт символів для інструкцій асистента в Assistants API?

Максимальна довжина поля інструкцій асистента — 256 000 символів.

Я отримую повідомлення про помилку на кшталт «Під час обробки вашого запиту на сервері сталася помилка. Перепрошуємо! Спробуйте надіслати запит ще раз або зверніться до нас через Довідковий центр на help.openai.com, якщо помилка повторюється. » Що робити?

Ця помилка може означати, що ваш запит сформовано неправильно. Якщо повторні спроби надіслати запит не вдаються, спробуйте таке:

1. змініть структуру запиту так, щоб усі команди, подібні до функцій, оброблялися як функції

2. додайте всі команди із запиту до tools як функції

Чому мій інструмент пошуку у файлах працює неефективно?

Під час використання інструмента пошуку у файлах радимо встановлювати значення max_prompt_tokens не менше ніж 20 000. Для довших розмов або багаторазової взаємодії з пошуком у файлах варто збільшити цей ліміт до 50 000, а в ідеалі — взагалі зняти обмеження max_prompt_tokens, щоб отримувати найякісніші результати.

Як залишити відгук?

Будемо раді вашим відгукам на нашому форумі розробників, через Довідковий центр на help.openai.com або у Twitter @OpenAIDevs.