Проектите имат за цел да предоставят на клиентите възможност да организират работата си. Организациите могат да управляват достъп и лимити, да предоставят service account-и (чрез UI) и да проследяват използването в рамките на ограничен обхват в проекта (напр. модели, възможности, нишки, асистенти, fine-tuning, хранилище и т.н.). Активността по използване може да бъде разбита по проект, а потребителите могат да преглеждат фактуриране и да задават бюджети за всеки проект.
Собствениците на организации могат да виждат всички свои активни и архивирани проекти на страницата Projects. Научете повече за потребителските роли и разрешенията в API Platform.
Кой може да създаде проект?
Само собствениците на организация могат да създават проект. Вижте роли и разрешения за повече информация.
За да превключвате между организации, задръжте курсора върху името на организацията си в горния ляв ъгъл на страницата и изберете организацията от списъка:
За организациите, които са на план за консолидирано фактуриране, подорганизациите се идентифицират отделно. В подорганизации не могат да се създават проекти.
Как работят проектите?
Всяка организация включва „Проект по подразбиране“, който не може да бъде изтрит. Можете да конфигурирате rate limits, разрешения за виртуални модели и бюджети за разходи (към ноември 2024 г.). Той наследява пълната конфигурация на организацията, така че не можете директно да добавяте към него членове или service account-и.
Как да създам проект?
Първо задръжте курсора върху името на проекта в левия ъгъл на страницата и изберете Create project.
Въведете име, описание и уебсайт за проекта си, след което изберете Create.
Как да добавя потребители към проект?
Новодобавените членове на организацията не се добавят автоматично към „Проект по подразбиране“. Новите членове могат да бъдат поканени в проекта или при поканването им в организацията (като активирате отметката "Invite to default project"), или след като членът е приел поканата за организацията.
Потребителите, поканени чрез Admin API, следват правилата, описани в крайната точка /organization/invites.
Ако срещнете грешка при поканване на потребители в проект чрез UI или Admin API, първо потвърдете, че целевият проект съществува и не е архивиран, преди да изпратите поканата отново.
Собствениците на организацията автоматично се добавят като собственици към нови проекти, създадени в организация.
Какви са различните потребителски роли в организациите и проектите и какви разрешения включват?
Докато организациите имат роли „owner“ и „reader“, проектите имат роли „owner“ и „member“. Членовете на проект са аналогични на readers в организацията. Вижте таблицата по-долу за по-подробно описание на разрешенията, които съпътстват всяка потребителска роля.
| Роля | Обхват | Описание |
|---|---|---|
| Owner | Organization | Може да създава/преглежда всички проекти, всички потребители, всички API ключове. Има възможност да наблюдава всички проекти в организацията чрез страницата Projects. Може да задава бюджети на организацията и на проекти. Може да дава разрешения на други в организацията да виждат информация за използването. Може да архивира проекти. |
| Reader | Organization | Може да извършва inference, да използва ресурси и да създава ключове в своите проекти. Може да бъде добавян към проекти. Не може да създава проекти и да управлява потребители. |
| Owner | Project | Може да добавя други потребители към проекта и да преименува проекта, както и има всички възможности на Member. Може да задава бюджети на проекта. Може да архивира проекта. |
| Member | Project | Може да извършва inference, да използва ресурси и да създава ключове на ниво проект. |
Ако не съм Owner в организацията, до какво имам достъп?
Потребителите, които не са Owners в организацията, могат да виждат само проектите, на които са членове. Само собственикът на организацията може да вижда всички проекти, членове и API ключове на ниво проект и има достъп до страницата Projects.
Само членовете на даден проект (и собствениците на организацията) могат да виждат fine-tuned моделите, създадени в този проект, нишките от създадени Assistants или всички добавени файлове.
Членовете на проект могат да виждат кои са всички останали членове на този проект и техните роли (т.е. Owner или Member).
Как да актуализирам ролята на потребител в проект или да премахна потребител от проект?
Само собственикът на проект може да актуализира ролята на потребител в проекта или да премахне потребител от проект. Вижте роли и разрешения за повече информация.
За да актуализирате потребител в проект, отидете в настройките на организацията, изберете проекта и щракнете върху Members. Имате възможност да зададете ролята на всеки член като Member или Owner. Можете също да изберете Remove, за да премахнете потребителя от проекта.
Какво е service account и как се различава от обикновен потребителски акаунт?
Service account действа като псевдопотребител, предназначен за системен достъп, и се различава от индивидуалните потребителски акаунти. Само собствениците на организация и проект могат да създават service account-и.
Service account-ите са ограничени само до проекти.
Добавяне на член към проект
Ако щракнете върху бутона + Add member, ще видите списък с потребители във вашата организация с роля Reader. Ако искате да добавите потребител, който в момента не е във вашата организация, първо трябва да го добавите към организацията (можете да оставите отметката 'Add to Default Project" без отметка, ако не искате да дадете на тези потребители по-широк достъп). Този списък няма да включва service account-и. По време на тази стъпка можете да изберете ролята им да е Owner или Member:
Когато добавяте член на екипа, трябва да му зададете роля Member или Owner. Членовете на проекта могат да правят API заявки, които четат или променят данни, докато собствениците на проекта могат също да променят настройките и бюджетите на проекта и да управляват членовете на проекта. Вижте роли и разрешения за повече информация.
Как да създадете service account за проект
Първо отидете до проекта, за който искате да създадете service account, като го изберете от падащото меню в навигационната лента:
След това отидете в настройките на организацията -> Project -> Members -> щракнете върху + Service account:
Service account-ите, създадени на ниво проект, са уникални за проекта и не могат да се използват извън проекта, в който са създадени.
Именуване на service account
Независимо дали създавате service account на ниво организация или такъв, уникален за проект, когато създавате service account, можете да създадете уникален идентификатор на service account, състоящ се от букви, цифри и тирета, за да го разпознавате лесно.
Запазете API ключа на service account
След като изберете бутона Create, за service account веднага се създава API ключ и secret key ще бъде показан. Запазете този secret key на сигурно и безопасно място. От съображения за сигурност няма да можете да го видите отново през своя OpenAI акаунт. Ако загубите този secret key, ще трябва да генерирате нов.
Разрешенията на API ключа на service account по подразбиране са зададени за четене и запис на всички API ресурси на проекта. Тези разрешения могат да бъдат актуализирани в настройките API Keys на проекта ви.
Service account-ите са изброени заедно с членовете на проекта на страницата с настройки за членове на проекта. Вижте тук, за да научите повече за актуализиране или премахване на достъпа на service account в страницата с настройки за членове на проекта.
Всички service account-и както в проектите, така и в организациите ще се показват заедно с човешките потребители на страницата с членове на ниво организация.
Service account-ите се управляват като обикновени акаунти. От Organization -> менюто Members можете да Remove service account или да актуализирате ролята:
Как да управлявам API ключове в проектите на моята организация?
Можете да създавате и управлявате API ключове за всеки проект от страницата с настройки на съответния проект. В настройките на организацията изберете проекта и щракнете върху API Keys.
За да създадете нов secret key, изберете + Create new secret key. Можете също да изберете иконата за редактиране до secret key, за да промените неговите разрешения.
Можете да задавате разрешения за всеки от API ключовете си, когато създавате нов secret key или като редактирате съществуващ ключ.
Налични са три нива на разрешения: All, Restricted и Read Only.
All — За secret key са зададени пълни разрешения. Това е настройката по подразбиране.
Restricted — Позволява на потребителя да задава разрешения None, Read и Write за всяка крайна точка.
Например създавате API ключ, който конкретно няма разрешение за Read или Write към крайната точка /v1/assistants:
Read Only — Разрешения за четене са зададени за всички крайни точки.
Как се управлява достъпът за потребители, които принадлежат към няколко проекта или организации?
Потребителите могат да бъдат членове на толкова проекти, колкото е необходимо. В рамките на проект потребителите могат да генерират личен API ключ, който е ограничен и предназначен за достъп само до този проект и неговите ресурси.
Как да задам и управлявам rate limits за проектите на моята организация?
Само Owner на организация може да задава и управлява rate limits на ниво проект. Вижте роли и разрешения за повече информация.
В настройките на организацията щракнете върху проекта, който искате да актуализирате, и изберете Limits в секцията Project от списъка за навигация. На тази страница можете да актуализирате Model Usage.
Model usage ви позволява да конфигурирате кои модели могат да се използват от проекта, а rate limits могат да бъдат зададени за всеки модел при нужда.
Как да задам и управлявам бюджети за проектите на моята организация?
Само собствениците на организация и собствениците на проект могат да задават и управляват бюджети на проекти. Вижте роли и разрешения за повече информация. За да промените лимитите на ниво организация, в настройките на организацията щракнете върху Limits, и превъртете надолу до Usage limits.
За да зададете лимитите на проекта си, в настройките на организацията щракнете върху проекта, който искате да актуализирате, и изберете Limits. Можете да актуализирате Monthly budget, Notification threshold и Model Usage.
Задаването на месечен бюджет ви позволява да определите меки прагове на разходите за проекта си. Когато използването надхвърли този лимит в рамките на даден календарен месец (UTC), API заявките ще продължат да се обработват без прекъсване. Тази функция е създадена, за да ви помогне да следите използването чрез бюджетни известия, но не налага твърд таван на разходите. Когато се създаде бюджет на проект, по подразбиране ще бъде създадено известие при праг от 100%. Допълнителни бюджети на различни прагове могат да бъдат зададени чрез щракване върху Add Alert.
Моля, обърнете внимание, че собственикът(ците) на организацията и собственикът(ците) на проекта винаги ще получават тези съобщения и това не може да бъде персонализирано.
Как да изтрия или архивирам проект?
Проектите могат да бъдат архивирани или чрез новата страница project listing, или от настройките на отделен проект. След като проектът бъде архивиран, той не може да бъде възстановен. При продължаване на архивирането ще бъдете подканени да въведете името на проекта, за да продължите.
Можете да видите списък на всички архивирани проекти чрез раздела „Archived“ на същата страница project listing.
Изтриването на проекти не е възможно; поддържаме история на всички проекти, за да осигурим непрекъснатост при проследяването на използването и фактурирането.
Има ли ограничение за броя проекти, които мога да имам в организацията си?
Организациите могат да създават до 2 000 проекта по подразбиране.
Могат ли ресурсите да се споделят между проекти?
Ресурсите на проекта (като файлове, асистенти, хранилище или нишки) са ограничени до проекта и не могат да бъдат достъпвани от нечленове с администраторски права извън проекта. Освен това ресурсите не могат да се преместват между проекти.
Единственото изключение е, че fine-tune моделите в „Проект по подразбиране“ могат да бъдат достъпвани от други проекти.
Каква е квотата за файлово хранилище на проект?
OpenAI в момента поддържа квота за файлово хранилище от 100 GB файлове на проект.
Ако тази квота бъде надвишена, ще видите следната грешка:
Надвишили сте квотата си за файлово хранилище. Организациите са ограничени до 100 GB файлове. Моля, намалете размера на файловете или се свържете с поддръжката.Препоръчваме да изтриете неизползваните файлове, съхранявани в акаунта ви. За справка можете да преглеждате и изброявате файлове с API.
Аз съм собственик на проект, защо не виждам таблото Usage Dashboard за моя проект?
Видимостта на Usage Dashboard на даден проект не е свързана с ролята на потребителя в проекта. Вместо това тя се определя от ролята ви в организацията и от настройките на https://platform.openai.com/settings/organization/data-controls/visibility
Ако не можете да видите Usage Dashboard, тази настройка вероятно е зададена на "Visible to organization owners".