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