Projekty mají zákazníkům umožnit organizovat jejich práci. Organizace mohou spravovat přístup a limity, zřizovat účty služeb (prostřednictvím uživatelského rozhraní) a sledovat využití v omezeném rozsahu v rámci projektu (např. modely, funkce, vlákna, asistenty, dolaďování, úložiště atd.). Aktivitu využití lze rozdělit podle projektů a uživatelé mohou zobrazovat fakturaci a nastavovat limity útraty pro jednotlivé projekty.
Vlastníci organizace mohou zobrazit všechny své aktivní a archivované projekty na stránce Projekty. Další informace o uživatelských rolích a oprávněních v Platformě API.
Kdo může vytvořit projekt?
Projekt mohou vytvořit pouze vlastníci organizace. Další informace najdete v části role a oprávnění.
Chcete-li přepnout mezi organizacemi, najeďte myší na název své organizace vlevo nahoře na stránce a vyberte organizaci ze seznamu:
U organizací, které používají konsolidovaný fakturační plán, jsou dílčí organizace označeny samostatně. V dílčích organizacích nelze vytvářet projekty.
Jak projekty fungují?
Každá organizace obsahuje „výchozí projekt“, který nelze odstranit. Můžete konfigurovat limity rychlosti, oprávnění pro virtuální modely a limity útraty (od listopadu 2024). Dědí úplnou konfiguraci organizace, takže do něj nemůžete přímo přidávat členy ani účty služeb.
Jak vytvořím projekt?
Nejprve najeďte ukazatelem na název projektu v levém rohu stránky a vyberte Vytvořit projekt.
Zadejte název, popis a web projektu a poté vyberte Vytvořit.
Jak přidám uživatele do projektu?
Nově přidaní členové organizace nejsou automaticky přidáni do „Výchozího projektu“. Nové členy lze do projektu pozvat buď při pozvání do organizace (zaškrtnutím políčka „Pozvat do výchozího projektu“), nebo poté, co přijmou pozvánku do organizace.
Pro uživatele pozvané prostřednictvím rozhraní Admin API platí pravidla uvedená u koncového bodu /organization/invites.
Pokud při zvaní uživatelů do projektu prostřednictvím uživatelského rozhraní nebo Admin API narazíte na chybu, před opětovným odesláním pozvánky nejprve ověřte, že cílový projekt existuje a není archivovaný.
Vlastníci organizace jsou automaticky přidáváni jako vlastníci nových projektů vytvořených v rámci organizace.
Jaké jsou různé uživatelské role v organizacích a projektech a jaká oprávnění zahrnují?
Zatímco organizace mají role „vlastník“ a „čtenář“, projekty mají role „vlastník“ a „člen“. Členové projektu odpovídají čtenářům organizace. Podrobnější popis oprávnění spojených s jednotlivými uživatelskými rolemi najdete v tabulce níže.
| Role | Rozsah | Popis |
|---|---|---|
| Vlastník | Organizace | Může vytvářet a zobrazovat všechny projekty, všechny uživatele a všechny klíče API. Má možnost monitorovat všechny projekty v organizaci na stránce Projekty . Může nastavovat limity útraty organizace a limity útraty projektů. Může udělovat oprávnění k zobrazení informací o využití ostatním uživatelům v organizaci. Může archivovat projekty. |
| Čtenář | Organizace | Může ve svých projektech provádět inferenci, používat zdroje a vytvářet klíče. Může být přidán do projektů. Nemůže vytvářet projekty ani spravovat uživatele. |
| Vlastník | Projekt | Může do projektu přidávat další uživatele a přejmenovat projekt a má také všechna oprávnění člena. Může nastavovat limity útraty projektu. Může projekt archivovat. |
| Člen | Projekt | Může na úrovni projektu provádět inferenci, používat zdroje a vytvářet klíče. |
K čemu mám přístup, pokud nejsem vlastníkem organizace?
Uživatelé, kteří nejsou vlastníky organizace, vidí pouze projekty, jejichž jsou členy. Pouze vlastník organizace vidí všechny projekty, členy a klíče API na úrovni projektu a má přístup na stránku Projekty.
Pouze členové projektu a vlastníci organizace mohou zobrazit modely doladěné v daném projektu, vlákna vytvořených Asistentů a všechny přidané soubory.
Členové projektu vidí všechny ostatní členy daného projektu a jejich role (tj. Vlastník nebo Člen).
Jak změním roli uživatele v projektu nebo uživatele z projektu odeberu?
Roli uživatele v projektu může změnit nebo uživatele z projektu odebrat pouze vlastník projektu. Další informace najdete v části Role a oprávnění.
Chcete-li upravit uživatele v projektu, přejděte do nastavení organizace, vyberte projekt a klikněte na Členové. Každému členovi můžete nastavit roli Člen nebo Vlastník. Uživatele můžete z projektu odebrat také výběrem možnosti Odebrat.
Co je servisní účet a jak se liší od běžného uživatelského účtu?
Servisní účet funguje jako pseudo-uživatel určený pro systémový přístup a odlišuje se od individuálních uživatelských účtů. Servisní účty mohou vytvářet pouze vlastníci organizace a projektu.
Servisní účty jsou omezeny pouze na projekty.
Přidání člena do projektu
Po kliknutí na tlačítko + Přidat člena se zobrazí seznam uživatelů ve vaší organizaci s rolí Čtenář. Chcete-li přidat uživatele, který momentálně není ve vaší organizaci, musíte ho nejprve přidat do organizace (pokud mu nechcete poskytnout širší přístup, můžete nechat políčko „Přidat do výchozího projektu“ nezaškrtnuté). Tento seznam nezahrnuje účty služeb. V tomto kroku můžete zvolit roli Vlastník nebo Člen:
Při přidávání člena týmu mu musíte přiřadit roli Člen nebo Vlastník. Členové projektu mohou odesílat požadavky API, které čtou nebo upravují data. Vlastníci projektu mohou navíc měnit nastavení a limity útraty projektu a spravovat jeho členy. Další informace najdete v části Role a oprávnění.
Jak vytvořit účet služby pro projekt
Nejprve v rozevírací nabídce na navigačním panelu přejděte k projektu, pro který chcete vytvořit účet služby:
Poté přejděte do nastavení organizace -> Projekt -> Členové -> a klikněte na + Účet služby:
Servisní účty vytvořené na úrovni projektu jsou jedinečné pro daný projekt a nelze je používat mimo projekt, ve kterém byly vytvořeny.
Pojmenování servisního účtu
Bez ohledu na to, zda servisní účet vytvoříte na úrovni organizace, nebo vytvoříte účet jedinečný pro projekt, můžete při vytváření servisního účtu vytvořit jedinečné ID servisního účtu složené z písmen, čísel a pomlček, abyste servisní účet snadno identifikovali.
Uložení klíče API účtu služby
Po výběru tlačítka Vytvořit se pro účet služby ihned vytvoří klíč API a zobrazí se tajný klíč. Tento tajný klíč si uložte na bezpečné místo. Z bezpečnostních důvodů ho již ve svém účtu OpenAI nebudete moci znovu zobrazit. Pokud tento tajný klíč ztratíte, budete muset vygenerovat nový.
Klíč API účtu služby má ve výchozím nastavení oprávnění číst a zapisovat všechny prostředky API projektu. Tato oprávnění lze změnit v nastavení klíčů API projektu.
Účty služeb jsou uvedeny společně se členy projektu na stránce nastavení členů projektu. Další informace o změně nebo odebrání přístupu účtu služby na stránce nastavení členů projektu najdete zde.
Všechny účty služeb napříč projekty i organizacemi se zobrazí spolu s lidskými uživateli na stránce členů na úrovni organizace.
Účty služeb se spravují stejně jako běžné účty. V nabídce Organizace -> Členové můžete účet služby odebrat nebo aktualizovat jeho roli:
Jak mohu spravovat klíče API v projektech své organizace?
Klíče API pro jednotlivé projekty můžete vytvářet a spravovat na stránce nastavení příslušného projektu. V nastavení organizace vyberte projekt a klikněte na Klíče API.
Chcete-li vytvořit nový tajný klíč, vyberte + Vytvořit nový tajný klíč. Oprávnění tajného klíče můžete také upravit výběrem ikony Upravit vedle něj.
Oprávnění jednotlivých klíčů API můžete nastavit při vytváření nového tajného klíče nebo úpravou stávajícího klíče.
K dispozici jsou tři úrovně oprávnění: Všechna, Omezená a Pouze pro čtení.
Všechna — Tajný klíč má nastavena úplná oprávnění. Toto je výchozí nastavení.
Omezená — Umožňuje uživateli nastavit pro každý koncový bod oprávnění Žádné, Čtení nebo Zápis.
Můžete například vytvořit klíč API, který výslovně nemá oprávnění ke čtení ani zápisu pro koncový bod /v1/assistants:
Pouze pro čtení — Pro všechny koncové body jsou nastavena oprávnění ke čtení.
Jak se spravuje přístup pro uživatele, kteří patří do více projektů nebo organizací?
Uživatelé mohou být členy tolika projektů, kolika je potřeba. V rámci projektu si mohou vygenerovat osobní klíč API, který je omezen a vyhrazen pro přístup k tomuto projektu a jeho prostředkům.
Jak nastavím a spravuji limity frekvence požadavků pro projekty své organizace?
Limity frekvence požadavků na úrovni projektu může nastavovat a spravovat pouze vlastník organizace. Další informace najdete v části role a oprávnění.
V nastavení organizace klikněte na projekt, který chcete aktualizovat, a v části Projekt v navigačním seznamu vyberte Limity. Na této stránce můžete aktualizovat Využití modelů.
Využití modelů vám umožňuje nakonfigurovat, které modely může projekt používat, a podle potřeby lze pro každý model nastavit limity frekvence požadavků.
Jak nastavím a spravuji limity útraty pro projekty své organizace?
Limity útraty projektu mohou nastavovat a spravovat pouze vlastníci organizace a vlastníci projektu. Další informace najdete v části Role a oprávnění. Chcete-li změnit limity na úrovni organizace, přejděte do nastavení organizace, klikněte na Limity a přejděte dolů k části Limity využití.
Chcete-li nastavit limity projektu, přejděte do nastavení organizace, klikněte na projekt, který chcete upravit, a vyberte Limity. Můžete upravit Měsíční limit útraty, Práh upozornění a Využití modelů.
Nastavením měsíčního limitu útraty můžete pro projekt určit orientační práh výdajů. Když využití během daného kalendářního měsíce (UTC) tento limit překročí, požadavky API se budou dál zpracovávat bez přerušení. Tato funkce vám prostřednictvím upozornění na limit útraty pomáhá sledovat využití, ale nevynucuje nepřekročitelný strop výdajů. Při vytvoření limitu útraty projektu se ve výchozím nastavení vytvoří upozornění pro dosažení 100 %. Další upozornění pro jiné prahové hodnoty můžete nastavit kliknutím na Přidat upozornění.
Upozorňujeme, že tyto zprávy vždy obdrží vlastníci organizace i projektu a toto nastavení nelze změnit.
Jak nastavím limity útraty pro svou organizaci nebo projekt?
OpenAI nyní podporuje měsíční limity útraty za API na úrovni organizace i projektu. Limit útraty může výdaje sledovat bez vynucování, nebo ho můžete vynucovat jako pevný limit, takže požadavky API po dosažení limitu začnou selhávat. Nejnovější postup konfigurace a popis chování najdete v dokumentaci pro vývojáře v části Limity útraty.
Jak odstraním nebo archivuji projekt?
Projekty lze archivovat na nové stránce se seznamem projektů nebo v nastavení konkrétního projektu. Archivovaný projekt nelze obnovit. Při archivaci budete vyzváni k zadání názvu projektu, abyste mohli pokračovat.
Seznam všech archivovaných projektů zobrazíte na kartě „Archivované“ na stejné stránce se seznamem projektů.
Projekty nelze odstranit. Uchováváme historii všech projektů, abychom zajistili návaznost sledování využití a fakturace.
Existuje limit počtu projektů, které mohu mít ve své organizaci?
Organizace mohou ve výchozím nastavení vytvořit až 2 000 projektů.
Lze prostředky sdílet mezi projekty?
Prostředky projektu (například soubory, asistenti, úložiště nebo vlákna) jsou omezeny na daný projekt a členové bez administrátorských oprávnění mimo projekt k nim nemají přístup. Prostředky navíc nelze mezi projekty přesouvat.
Jedinou výjimkou je, že jemně doladěné modely ve „Výchozím projektu“ jsou přístupné i z jiných projektů.
Jaká je kvóta úložiště souborů pro jeden projekt?
OpenAI v současnosti podporuje kvótu úložiště 100 GB souborů na jeden projekt.
Pokud tuto kvótu překročíte, zobrazí se následující chyba:
Překročili jste kvótu úložiště souborů. Organizace jsou omezeny na 100 GB souborů. Zmenšete velikost souborů nebo kontaktujte podporu.Doporučujeme odstranit nepoužívané soubory uložené ve vašem účtu. Pro referenci můžete pomocí API zobrazit a vypsat soubory.
Jsem vlastníkem projektu. Proč nevidím jeho řídicí panel využití?
Viditelnost řídicího panelu využití projektu nesouvisí s rolí uživatele v projektu. Určuje ji vaše role v organizaci a zároveň nastavení na stránce https://platform.openai.com/settings/organization/data-controls/visibility.
Pokud řídicí panel využití nevidíte, je toto nastavení pravděpodobně nastaveno na „Viditelné vlastníkům organizace“.