Проєкти призначені для того, щоб допомогти клієнтам упорядковувати свою роботу. Організації можуть керувати доступом і лімітами, надавати облікові записи служб (через інтерфейс користувача) та відстежувати використання в межах обмеженої області проєкту (наприклад, моделі, можливості, потоки, асистенти, тонке налаштування, сховище тощо). Дані про використання можна розбивати за проєктами, а користувачі можуть переглядати виставлення рахунків і встановлювати ліміти витрат для кожного проєкту.
Власники організації можуть переглядати всі свої активні й архівовані проєкти на сторінці Projects. Дізнайтеся більше про ролі користувачів і дозволи на Платформі API.
Хто може створити проєкт?
Створювати проєкти можуть лише власники організації. Докладніше див. у розділі «Ролі та дозволи».
Щоб перейти до іншої організації, наведіть вказівник на назву організації у верхньому лівому куті сторінки й виберіть потрібну організацію зі списку:
В організаціях із консолідованим тарифним планом дочірні організації позначаються окремо. У дочірніх організаціях не можна створювати проєкти.
Як працюють проєкти?
Кожна організація має «Проєкт за замовчуванням», який не можна видалити. Можна налаштувати обмеження частоти запитів, дозволи віртуальних моделей і ліміти витрат (станом на листопад 2024 року). Він успадковує всю конфігурацію організації, тому до нього не можна безпосередньо додавати учасників або облікові записи служб.
Як створити проєкт?
Спочатку наведіть вказівник на назву проєкту в лівому куті сторінки й виберіть Створити проєкт.
Укажіть назву, опис і вебсайт проєкту, а потім натисніть Створити.
Як додати користувачів до проєкту?
Нових учасників організації не додають автоматично до «Проєкту за замовчуванням». Нових учасників можна запросити до проєкту під час запрошення до організації, установивши прапорець «Запросити до проєкту за замовчуванням», або після того, як учасник прийме запрошення до організації.
До користувачів, запрошених через Admin API, застосовуються правила, визначені кінцевою точкою /organization/invites.
Якщо під час запрошення користувачів до проєкту через інтерфейс або Admin API виникає помилка, перш ніж повторно надсилати запрошення, переконайтеся, що цільовий проєкт існує й не заархівований.
Власників організації автоматично додають як власників до нових проєктів, створених у цій організації.
Які ролі користувачів існують в організаціях і проєктах та які дозволи вони надають?
В організаціях є ролі «власник» і «читач», а в проєктах — «власник» і «учасник». Учасники проєкту мають права, подібні до прав читачів організації. Докладніший опис дозволів для кожної ролі користувача наведено в таблиці нижче.
| Роль | Область дії | Опис |
|---|---|---|
| Власник | Організація | Може створювати й переглядати всі проєкти, усіх користувачів і всі ключі API. Може відстежувати всі проєкти організації на сторінці «Проєкти» . Може встановлювати ліміти витрат організації та проєктів. Може надавати іншим учасникам організації дозвіл переглядати відомості про використання. Може архівувати проєкти. |
| Читач | Організація | Може виконувати інференс, використовувати ресурси та створювати ключі у своїх проєктах. Може бути доданий до проєктів. Не може створювати проєкти й керувати користувачами. |
| Власник | Проєкт | Може додавати до проєкту інших користувачів, перейменовувати проєкт і має всі можливості учасника. Може встановлювати ліміти витрат проєкту. Може архівувати проєкт. |
| Учасник | Проєкт | Може виконувати інференс, використовувати ресурси та створювати ключі на рівні проєкту. |
До чого я маю доступ, якщо не є власником організації?
Користувачі, які не є власниками організації, можуть бачити лише проєкти, учасниками яких вони є. Лише власник організації може переглядати всі проєкти, їхніх учасників і ключі API та має доступ до сторінки «Проєкти».
Лише учасники проєкту та власники організації можуть бачити моделі, донавчені в цьому проєкті, потоки створених асистентів і додані файли.
Учасники проєкту можуть бачити всіх інших учасників цього проєкту та їхні ролі, як-от «Власник» або «Учасник».
Як змінити роль користувача в проєкті або вилучити його з проєкту?
Змінювати роль користувача в проєкті або вилучати його з проєкту може лише власник проєкту. Докладніше див. у розділі «Ролі та дозволи».
Щоб змінити дані користувача в проєкті, перейдіть до налаштувань організації, виберіть проєкт і натисніть Учасники. Кожному учаснику можна призначити роль Учасник або Власник. Щоб вилучити користувача з проєкту, також можна вибрати Вилучити.
Що таке обліковий запис служби та чим він відрізняється від звичайного облікового запису користувача?
Обліковий запис служби — це псевдокористувач, призначений для системного доступу й відокремлений від облікових записів окремих користувачів. Створювати облікові записи служб можуть лише власники організації та проєкту.
Службові облікові записи обмежені лише проєктами.
Додавання учасника до проєкту
Натиснувши кнопку + Додати учасника, ви побачите список користувачів вашої організації з роллю Читач. Якщо користувача ще немає у вашій організації, спочатку додайте його до неї. Якщо не хочете надавати цим користувачам ширший доступ, не встановлюйте прапорець «Додати до проєкту за замовчуванням». Облікові записи служб у цьому списку не відображаються. На цьому кроці можна призначити роль Власник або Учасник:
Додаючи учасника команди, призначте йому роль Учасник або Власник. Учасники проєкту можуть надсилати запити API для читання або зміни даних, а власники проєкту також можуть змінювати його налаштування й ліміти витрат та керувати учасниками. Докладніше див. у розділі «Ролі та дозволи».
Як створити обліковий запис служби для проєкту
Спочатку перейдіть до проєкту, для якого потрібно створити обліковий запис служби, вибравши його з розкривного списку на панелі навігації:
Потім перейдіть до налаштувань організації -> Проєкт -> Учасники -> натисніть + Обліковий запис служби:
Службові облікові записи, створені на рівні проєкту, є унікальними для проєкту й не можуть використовуватися поза межами проєкту, у якому їх створено.
Назва облікового запису служби
Незалежно від того, створюєте ви обліковий запис служби на рівні організації чи окремого проєкту, для нього можна створити унікальний ідентифікатор із літер, цифр і дефісів, щоб легко розпізнавати цей обліковий запис.
Збереження ключа API облікового запису служби
Після натискання кнопки Створити для облікового запису служби відразу створюється ключ API та відображається секретний ключ. Збережіть цей секретний ключ у безпечному місці. З міркувань безпеки ви більше не зможете переглянути його у своєму обліковому записі OpenAI. Якщо ви втратите цей секретний ключ, доведеться створити новий.
За замовчуванням ключ API облікового запису служби має дозволи на читання й запис усіх ресурсів API проєкту. Ці дозволи можна змінити в налаштуваннях ключів API проєкту.
Облікові записи служб відображаються разом з учасниками проєкту на сторінці налаштувань учасників. Докладніше про зміну або скасування доступу облікового запису служби на сторінці налаштувань учасників проєкту див. тут.
Усі сервісні облікові записи в проєктах і організаціях відображатимуться разом із користувачами-людьми на сторінці учасників на рівні організації.
Сервісні облікові записи керуються так само, як звичайні облікові записи. У меню Організація -> Учасники можна видалити сервісний обліковий запис або оновити роль:
Як керувати ключами API у проєктах організації?
Ключі API для кожного проєкту можна створювати й налаштовувати на сторінці його налаштувань. У налаштуваннях організації виберіть проєкт і натисніть Ключі API.
Щоб створити новий секретний ключ, виберіть + Створити новий секретний ключ. Щоб змінити дозволи секретного ключа, також можна натиснути піктограму редагування поруч із ним.
Дозволи для кожного ключа API можна налаштувати під час створення нового секретного ключа або редагування наявного.
Доступні три рівні дозволів: «Усі», «Обмежені» й «Лише читання».
Усі — секретному ключу надаються повні дозволи. Це налаштування за замовчуванням.
Обмежені — дає змогу встановити для кожної кінцевої точки дозволи «Немає», «Читання» та «Запис».
Наприклад, можна створити ключ API без дозволу на читання або запис для кінцевої точки /v1/assistants:
Лише читання — для всіх кінцевих точок установлюється дозвіл на читання.
Як керується доступ користувачів, які належать до кількох проєктів або організацій?
Користувачі можуть бути учасниками будь-якої потрібної кількості проєктів. У межах проєкту користувачі можуть створити особистий ключ API, доступ якого обмежено цим проєктом і його ресурсами.
Як установлювати обмеження частоти запитів для проєктів організації та керувати ними?
Установлювати обмеження частоти запитів на рівні проєкту та керувати ними може лише власник організації. Докладніше див. у розділі «Ролі та дозволи».
У налаштуваннях організації виберіть проєкт, який потрібно оновити, а потім у розділі «Проєкт» навігаційного меню виберіть Ліміти. На цій сторінці можна змінити Використання моделей.
У розділі «Використання моделей» можна визначити, які моделі доступні проєкту, а для кожної моделі за потреби встановити обмеження частоти запитів.
Як установлювати ліміти витрат для проєктів організації та керувати ними?
Установлювати ліміти витрат проєкту та керувати ними можуть лише власники організації й проєкту. Докладніше див. у розділі «Ролі та дозволи». Щоб змінити ліміти на рівні організації, у налаштуваннях організації натисніть Ліміти й прокрутіть до розділу Ліміти використання.
Щоб установити ліміти проєкту, у налаштуваннях організації виберіть потрібний проєкт, а потім — Ліміти. Можна змінити Місячний ліміт витрат, Поріг сповіщення та Використання моделей.
Налаштування місячного ліміту витрат дає змогу встановити для проєкту м’які порогові значення витрат. Якщо протягом певного календарного місяця (UTC) використання перевищить цей ліміт, запити API й надалі оброблятимуться без перерв. Ця функція допомагає відстежувати використання за допомогою сповіщень про ліміт витрат, але не встановлює жорсткого обмеження витрат. Під час створення ліміту витрат проєкту за замовчуванням створюється сповіщення для порога 100%. Щоб налаштувати додаткові сповіщення для інших порогів, натисніть Додати сповіщення.
Зверніть увагу: власники організації та проєкту завжди отримуватимуть ці повідомлення, і змінити це налаштування неможливо.
Як установити ліміти витрат для організації або проєкту?
Тепер OpenAI підтримує місячні ліміти витрат на API як на рівні організації, так і на рівні проєкту. Ліміт витрат може лише відстежувати витрати без обмеження або діяти як жорстке обмеження, після досягнення якого запити API завершуватимуться помилкою. Актуальні кроки налаштування й опис роботи див. у розділі «Ліміти витрат» документації для розробників.
Як видалити або заархівувати проєкт?
Проєкт можна заархівувати на новій сторінці списку проєктів або в налаштуваннях окремого проєкту. Заархівований проєкт неможливо відновити. Щоб продовжити архівування, вам буде запропоновано ввести назву проєкту.
Список усіх заархівованих проєктів можна переглянути на вкладці «Архівні» тієї самої сторінки списку проєктів.
Видаляти проєкти неможливо. Ми зберігаємо історію всіх проєктів, щоб забезпечити безперервність обліку використання й виставлення рахунків.
Чи обмежена кількість проєктів в організації?
За замовчуванням організації можуть створювати до 2 000 проєктів.
Чи можна спільно використовувати ресурси в різних проєктах?
Ресурси проєкту, як-от файли, асистенти, сховище або потоки, належать лише цьому проєкту. Учасники без прав адміністратора, які не входять до проєкту, не мають до них доступу. Крім того, ресурси не можна переміщувати між проєктами.
Єдиний виняток полягає в тому, що точні налаштування в «Проєкті за замовчуванням» доступні з інших проєктів.
Яка квота сховища файлів для одного проєкту?
Наразі OpenAI підтримує квоту сховища файлів обсягом 100 ГБ на проєкт.
Якщо цю квоту перевищено, з’явиться така помилка:
Ви перевищили квоту на сховище файлів. Для організацій діє обмеження в 100 ГБ файлів. Зменште розмір файлу або зверніться до служби підтримки.Рекомендуємо видаляти невикористані файли, збережені у вашому обліковому записі. Для довідки: ви можете переглядати й отримувати список файлів за допомогою API.
Я власник проєкту. Чому я не бачу панель використання свого проєкту?
Видимість панелі використання проєкту не залежить від ролі користувача в цьому проєкті. Натомість вона визначається вашою роллю в організації та налаштуваннями на сторінці https://platform.openai.com/settings/organization/data-controls/visibility
Якщо панель використання не відображається, імовірно, вибрано налаштування «Видима власникам організації».