Проектите имат за цел да дадат на клиентите възможност да организират работата си. Организациите могат да управляват достъпа и лимитите, да осигуряват служебни акаунти (чрез потребителския интерфейс) и да проследяват използването в ограничен обхват в рамките на проект (напр. модели, възможности, нишки, асистенти, фина настройка, хранилище и др.). Активността на използване може да се разбива по проекти, а потребителите могат да преглеждат таксуването и да задават лимити за разходи за всеки проект.
Собствениците на организация могат да виждат всички свои активни и архивирани проекти на страницата „Проекти“. Научете повече за потребителските роли и разрешенията в API платформа.
Кой може да създаде проект?
Само собствениците на организация могат да създадат проект. Моля, вижте роли и разрешения за повече информация.
За да превключвате между организации, задръжте курсора върху името на вашата организация в горния ляв ъгъл на страницата и изберете организацията от списъка:
За организациите, които са на консолидиран план за фактуриране, подорганизациите се идентифицират отделно. Проекти не могат да се създават в подорганизации.
Как работят проектите?
Всяка организация включва „Проект по подразбиране“, който не може да бъде изтрит. Можете да конфигурирате лимитите на честотата, разрешенията за виртуални модели и лимитите за разходи (към ноември 2024 г.). Той наследява пълната конфигурация на организацията, така че не можете директно да добавяте към него членове или служебни акаунти.
Как да създам проект?
Първо задръжте курсора върху името на проекта в левия ъгъл на страницата и изберете 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%. Можете да зададете допълнителни известия при различни прагове, като щракнете върху Добавяне на известие.
Имайте предвид, че собственикът/собствениците на организацията и собственикът/собствениците на проекта винаги ще получават тези съобщения и това не може да се персонализира.
Как да задавам лимити за разходи за моята организация или проект?
OpenAI вече поддържа месечни лимити за разходи за API както на ниво организация, така и на ниво проект. Лимитът за разходи може да следи разходите без принудително ограничаване или можете да го налагате като твърд лимит, така че API заявките да се провалят, след като разходите достигнат лимита. За най-новите стъпки за конфигуриране и поведение вижте Лимити за разходи в документацията за разработчици.
Как да изтрия или архивирам проект?
Проектите могат да бъдат архивирани или чрез новата страница списък с проекти, или в настройките на отделен проект. След като проект бъде архивиран, той не може да бъде възстановен. Когато продължите с архивиране, ще бъдете подканени да въведете името на проекта, за да продължите напред.
Можете да видите списък на всички архивирани проекти чрез раздела „Архивирани“ на същата страница списък с проекти.
Изтриването на проекти не е възможно; поддържаме история на всички проекти, за да осигурим непрекъснатост при проследяването на използването и фактурирането.
Има ли ограничение за броя проекти, които мога да имам в организацията си?
Организациите могат да създават до 2 000 проекта по подразбиране.
Могат ли ресурсите да се споделят между проекти?
Ресурсите на проекта (като файлове, асистенти, хранилище или нишки) са ограничени до проекта и не могат да бъдат достъпвани от нечленове с администраторски права извън проекта. Освен това ресурсите не могат да се преместват между проекти.
Единственото изключение е, че fine-tune моделите в „Проект по подразбиране“ могат да бъдат достъпвани от други проекти.
Каква е квотата за файлово хранилище на проект?
OpenAI в момента поддържа квота за файлово хранилище от 100 GB файлове на проект.
Ако тази квота бъде надвишена, ще видите следната грешка:
Надвишили сте квотата си за файлово хранилище. Организациите са ограничени до 100 GB файлове. Моля, намалете размера на файловете или се свържете с поддръжката.Препоръчваме да изтриете неизползваните файлове, съхранени във вашия акаунт. За справка можете да преглеждате и изброявате файлове с API.
Аз съм собственик на проект, защо не мога да видя таблото за използване за моя проект?
Видимостта на таблото за използване на проектите не е свързана с ролята на потребителя в рамките на проект. Вместо това тя се определя от ролята ви в организацията и настройките на https://platform.openai.com/settings/organization/data-controls/visibility
Ако не можете да видите таблото за използване, тази настройка вероятно е зададена на „Видимо за собствениците на организацията“.