Проектите имат за цел да предоставят на клиентите възможност да организират работата си. Организациите могат да управляват достъпа и лимитите, да предоставят акаунти за услуги (чрез UI) и да проследяват използването спрямо ограничен обхват в рамките на проект (напр. модели, възможности, нишки, асистенти, фина настройка, съхранение и др.). Дейността по използване може да бъде разбита по проекти, а потребителите могат да преглеждат фактуриране и да задават бюджети за всеки проект.
Собствениците на организация могат да преглеждат всички свои активни и архивирани проекти на страницата Проекти. Научете повече за потребителските роли и разрешения в API Platform.
Кой може да създаде проект?
Само собствениците на организация могат да създадат проект. Моля, вижте роли и разрешения за повече информация.
За да превключвате между организации, задръжте курсора върху името на вашата организация в горния ляв ъгъл на страницата и изберете организацията от списъка:
За организациите, които са на консолидиран план за фактуриране, подорганизациите се идентифицират отделно. Проекти не могат да се създават в подорганизации.
Как работят проектите?
Всяка организация включва „Проект по подразбиране“, който не може да бъде изтрит. Можете да конфигурирате rate limits, разрешения за виртуални модели и бюджети за разходи (към ноември 2024 г.). Той наследява пълната конфигурация на организацията, така че не можете директно да добавяте към него членове или service account-и.
Как да създам проект?
Първо задръжте курсора върху името на проекта в левия ъгъл на страницата и изберете Create project.
Въведете име, описание и уебсайт за проекта си, след което изберете Create.
Как да добавя потребители към проект?
Новодобавените членове на организацията не се добавят автоматично към „Проекта по подразбиране“. Новите членове могат да бъдат поканени в проекта или когато бъдат поканени в организацията (чрез активиране на отметката „Покани в проекта по подразбиране“), или след като членът приеме поканата за организацията.
Потребителите, поканени чрез Admin API, следват правилата, описани от крайната точка /organization/invites.
Ако срещнете грешка при поканване на потребители в проект чрез UI или Admin API, първо потвърдете, че целевият проект съществува и не е архивиран, преди да изпратите поканата отново.
Собствениците на организация автоматично се добавят като собственици към новите проекти, създадени в рамките на организация.
Какви са различните потребителски роли в организациите и проектите и какви разрешения включват?
Докато организациите имат роли „собственик“ и „читател“, проектите имат роли „собственик“ и „член“. Членовете на проект са аналогични на читателите в организация. Моля, вижте таблицата по-долу за по-подробно описание на разрешенията, свързани с всяка потребителска роля.
| Роля | Обхват | Описание |
|---|---|---|
| Собственик | Организация | Може да създава/преглежда всички проекти, всички потребители, всички API ключове. Има възможност да наблюдава всички проекти в организацията чрез страницата Проекти . Може да задава бюджети на организацията и бюджети на проекти. Може да предоставя разрешения за преглед на информация за използването на други в организацията. Може да архивира проекти. |
| Читател | Организация | Може да извършва инференция, да използва ресурси и да създава ключове в своите проекти. Може да бъде добавян към проекти. Не може да създава проекти и да управлява потребители. |
| Собственик | Проект | Може да добавя други потребители към проекта и да преименува проекта, както и да има всички възможности на член. Може да задава бюджети на проекта. Може да архивира проекта. |
| Член | Проект | Може да извършва инференция, да използва ресурси и да създава ключове на ниво проект. |
Ако не съм собственик в организацията, до какво имам достъп?
Потребителите, които не са собственици в организацията, могат да виждат само проекти, на които са членове. Само собственикът на организацията може да вижда всички проекти, членове и API ключове на ниво проект и да има достъп до страницата Проекти.
Само членовете на проект (и собствениците на организацията) могат да виждат фино настроените модели, създадени в този проект, нишките от създадени Асистенти или всички добавени файлове.
Членовете на проект могат да виждат кои са всички други членове на този проект и техните роли (т.е. Собственик или Член).
Как да актуализирам ролята на потребител в проект или да премахна потребител от проект?
Само собственикът на проект може да актуализира ролята на потребител в проекта или да премахне потребител от проект. Моля, вижте роли и разрешения за повече информация.
За да актуализирате потребител в проект, отидете в настройките на организацията, изберете проекта и щракнете върху Членове. Имате възможност да зададете ролята на всеки член като Член или Собственик. Можете също да изберете Премахване, за да премахнете потребителя от проекта.
Какво е service account и как се различава от обикновен потребителски акаунт?
Service account действа като псевдопотребител, предназначен за системен достъп, и се различава от индивидуалните потребителски акаунти. Само собствениците на организация и проект могат да създават service account-и.
Service account-ите са ограничени само до проекти.
Добавяне на член към проект
Ако щракнете върху бутона + Add member, ще видите списък с потребители във вашата организация с ролята Reader. Ако искате да добавите потребител, който в момента не е във вашата организация, първо трябва да го добавите към организацията (можете да оставите отметката „Добавяне към проекта по подразбиране“ изключена, ако не искате да давате на тези потребители по-широк достъп). Този списък няма да включва акаунти за услуги. По време на тази стъпка можете да изберете дали ролята им да бъде Owner или Member:
Когато добавяте член на екипа, трябва да му зададете ролята Член или Собственик. Членовете на проект могат да правят API заявки, които четат или променят данни, докато собствениците на проект могат също да променят настройките и бюджетите на проекта и да управляват членовете му. Моля, вижте роли и разрешения за повече информация.
Как да създадете акаунт за услуга за проект
Първо отидете до проекта, за който искате да създадете акаунт за услуга, като изберете от падащото меню в навигационната лента:
След това отидете в настройките на организацията -> Проект -> Членове -> щракнете върху + Service account:
Service account-ите, създадени на ниво проект, са уникални за проекта и не могат да се използват извън проекта, в който са създадени.
Именуване на service account
Независимо дали създавате service account на ниво организация или такъв, уникален за проект, когато създавате service account, можете да създадете уникален идентификатор на service account, състоящ се от букви, цифри и тирета, за да го разпознавате лесно.
Запазете API ключа на акаунта за услуга
След като изберете бутона Създаване, незабавно се създава API ключ за акаунта за услуга и секретният ключ ще бъде показан. Запазете този секретен ключ на безопасно и сигурно място. От съображения за сигурност няма да можете да го видите отново чрез своя акаунт в OpenAI. Ако загубите този секретен ключ, ще трябва да генерирате нов.
Разрешенията за API ключа на акаунта за услуга по подразбиране позволяват четене и запис на всички API ресурси на проекта. Тези разрешения могат да бъдат актуализирани в настройките за API ключове на вашия проект.
Акаунтите за услуги са изброени заедно с членовете на проекта на страницата с настройки за членове на вашия проект. Моля, вижте тук, за да научите повече за актуализирането или премахването на достъпа на акаунт за услуга в страницата с настройки за членове на вашия проект.
Всички акаунти за услуги във всички проекти и организации ще се показват заедно с вашите човешки потребители на страницата с членове на ниво организация.
Акаунтите за услуги се управляват като обикновени акаунти. От Организация -> меню Членове можете да премахнете акаунт за услуга или да актуализирате ролята:
Как да управлявам API ключове в проектите на моята организация?
Можете да създавате и управлявате API ключове за всеки проект на страницата с настройки на този проект. В настройките на организацията изберете проекта и щракнете върху API ключове.
За да създадете нов секретен ключ, изберете + Create new secret key. Можете също да изберете иконата за редактиране до секретен ключ, за да редактирате разрешенията му.
Можете да задавате разрешения за всеки от вашите API ключове, когато създавате нов секретен ключ или като редактирате съществуващ ключ.
Налични са три нива на разрешения: Всички, Ограничени и Само за четене.
Всички — За секретния ключ са зададени пълни разрешения. Това е настройката по подразбиране.
Ограничени — Позволява на потребителя да задава разрешения None, Read и Write за всяка крайна точка.
Например създавате API ключ, който изрично няма разрешение за четене или запис към крайната точка /v1/assistants:
Само за четене — Разрешения за четене са зададени за всички крайни точки.
Как се управлява достъпът за потребители, които принадлежат към няколко проекта или организации?
Потребителите могат да бъдат членове на толкова проекти, колкото е необходимо. В рамките на проект потребителите могат да генерират личен API ключ, който е ограничен и предназначен за достъп само до този проект и неговите ресурси.
Как да задавам и управлявам лимити на заявките за проектите на моята организация?
Само собственикът на организация може да задава и управлява лимити на заявките на ниво проект. Моля, вижте роли и разрешения за повече информация.
В настройките на организацията щракнете върху проекта, който искате да актуализирате, и изберете Лимити в секцията Проект на навигационния списък. Можете да актуализирате своето Използване на модели на тази страница.
Използването на модели ви позволява да конфигурирате кои модели могат да се използват от проекта, а лимити на заявките могат да се задават за всеки модел според нуждите.
Как да задавам и управлявам бюджети за проектите на моята организация?
Само собствениците на организация и собствениците на проект могат да задават и управляват бюджети на проекти. Моля, вижте роли и разрешения за повече информация. За да промените лимитите на ниво организация, в настройките на организацията щракнете върху Лимити, и превъртете надолу до Лимити за използване.
За да зададете лимити за проекта си, в настройките на организацията щракнете върху проекта, който искате да актуализирате, и изберете Лимити. Можете да актуализирате своя Месечен бюджет, Праг за известяване и Използване на модели.
Задаването на месечен бюджет ви позволява да установите меки прагове за разходите за вашия проект. Когато използването надхвърли този лимит в рамките на даден календарен месец (UTC), API заявките ще продължат да се обработват без прекъсване. Тази функция е предназначена да ви помогне да наблюдавате използването чрез бюджетни предупреждения, но не налага твърд таван на разходите. Когато се създаде бюджет на проект, по подразбиране ще бъде създадено предупреждение при праг от 100%. Допълнителни бюджети при различни прагове могат да бъдат зададени чрез щракване върху Добавяне на предупреждение.
Моля, имайте предвид, че собственикът/собствениците на организацията и собственикът/собствениците на проекта винаги ще получават тези съобщения и това не може да се персонализира.
Как да изтрия или архивирам проект?
Проектите могат да бъдат архивирани или чрез новата страница списък с проекти, или в настройките на отделен проект. След като проект бъде архивиран, той не може да бъде възстановен. Когато продължите с архивиране, ще бъдете подканени да въведете името на проекта, за да продължите напред.
Можете да видите списък на всички архивирани проекти чрез раздела „Архивирани“ на същата страница списък с проекти.
Изтриването на проекти не е възможно; поддържаме история на всички проекти, за да осигурим непрекъснатост при проследяването на използването и фактурирането.
Има ли ограничение за броя проекти, които мога да имам в организацията си?
Организациите могат да създават до 2 000 проекта по подразбиране.
Могат ли ресурсите да се споделят между проекти?
Ресурсите на проекта (като файлове, асистенти, хранилище или нишки) са ограничени до проекта и не могат да бъдат достъпвани от нечленове с администраторски права извън проекта. Освен това ресурсите не могат да се преместват между проекти.
Единственото изключение е, че fine-tune моделите в „Проект по подразбиране“ могат да бъдат достъпвани от други проекти.
Каква е квотата за файлово хранилище на проект?
OpenAI в момента поддържа квота за файлово хранилище от 100 GB файлове на проект.
Ако тази квота бъде надвишена, ще видите следната грешка:
Надвишили сте квотата си за файлово хранилище. Организациите са ограничени до 100 GB файлове. Моля, намалете размера на файловете или се свържете с поддръжката.Препоръчваме да изтриете неизползваните файлове, съхранени във вашия акаунт. За справка можете да преглеждате и изброявате файлове с API.
Аз съм собственик на проект, защо не мога да видя таблото за използване за моя проект?
Видимостта на таблото за използване на проектите не е свързана с ролята на потребителя в рамките на проект. Вместо това тя се определя от ролята ви в организацията и настройките на https://platform.openai.com/settings/organization/data-controls/visibility
Ако не можете да видите таблото за използване, тази настройка вероятно е зададена на „Видимо за собствениците на организацията“.