Cílem projektů je poskytnout zákazníkům možnost organizovat svou práci. Organizace mohou spravovat přístup a limity, zřizovat účty služeb (přes uživatelské rozhraní) a sledovat využití vůči omezenému rozsahu v rámci projektu (např. modely, funkce, vlákna, asistenti, jemné ladění, úložiště atd.). Aktivitu využití lze rozdělit podle projektu a uživatelé si mohou zobrazit fakturaci a nastavit rozpočty pro jednotlivé projekty.
Vlastníci organizace mohou všechny své aktivní a archivované projekty zobrazit na stránce Projekty. Další informace o uživatelských rolích a oprávněních v API Platform.
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 zahrnuje „Výchozí projekt“, který nelze odstranit. Můžete nakonfigurovat limity rychlosti, oprávnění virtuálních modelů a rozpočty výdajů (od listopadu 2024). Dědí úplnou konfiguraci organizace, takže do něj nemůžete přímo přidávat členy ani servisní účty.
Jak vytvořím projekt?
Nejprve najeďte myší na název projektu v levém rohu stránky a vyberte Create project.
Zadejte název, popis a web projektu a pak vyberte Create.
Jak přidám uživatele do projektu?
Nově přidaní členové organizace se automaticky nepřidávají 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 člen přijme pozvánku do organizace.
Uživatelé pozvaní přes Admin API se řídí pravidly uvedenými pro koncový bod /organization/invites.
Pokud při zvaní uživatelů do projektu přes uživatelské 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 do 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ůže sledovat všechny projekty v rámci organizace pomocí stránky Projekty . Může nastavovat rozpočty organizace a rozpočty projektů. Může udělit oprávnění k zobrazení informací o využití ostatním v organizaci. Může archivovat projekty. |
| Čtenář | Organizace | Může provádět inferenci, používat zdroje a vytvářet klíče ve svých projektech. 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šechny možnosti člena. Může nastavovat rozpočty projektů. Může projekt archivovat. |
| Člen | Projekt | Může provádět inferenci, používat zdroje a vytvářet klíče na úrovni projektu. |
Pokud nejsem vlastníkem v organizaci, k čemu mám přístup?
Uživatelé, kteří nejsou vlastníky v organizaci, 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) vidí jemně laděné modely vytvořené v rámci daného projektu, vlákna od vytvořených asistentů nebo jakékoli přidané soubory.
Členové projektu vidí, kdo jsou všichni ostatní členové daného projektu a jaké mají role (tj. Vlastník nebo Člen).
Jak aktualizuji projektovou roli uživatele nebo odeberu uživatele z projektu?
Projektovou roli uživatele může aktualizovat nebo uživatele z projektu odebrat pouze vlastník projektu. Další informace najdete v části role a oprávnění.
Chcete-li aktualizovat uživatele v projektu, přejděte do nastavení organizace, vyberte projekt a klikněte na Členové. U každého člena 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
Pokud kliknete na tlačítko + Add member, zobrazí se seznam uživatelů ve vaší organizaci s rolí Reader. Pokud chcete přidat uživatele, který momentálně není ve vaší organizaci, musíte ho nejprve přidat do organizace (pokud těmto uživatelům nechcete udělit širší přístup, můžete ponechat políčko „Přidat do výchozího projektu“ nezaškrtnuté). Tento seznam nebude zahrnovat účty služeb. V tomto kroku můžete zvolit, zda jeho role bude Owner, nebo Member:
Když přidáte člena týmu, musíte mu přiřadit roli Člen nebo Vlastník. Členové projektu mohou vytvářet požadavky API, které čtou nebo upravují data, zatímco vlastníci projektu mohou navíc upravovat nastavení projektu a rozpočty projektu a spravovat členy projektu. Další informace najdete v části role a oprávnění.
Jak vytvořit účet služby pro projekt
Nejprve přejděte na projekt, pro který chcete vytvořit účet služby, výběrem z rozevírací nabídky v navigační liště:
Poté přejděte do nastavení organizace -> Projekt -> Členové -> klikněte na + Service account:
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žte klíč API účtu služby
Po výběru tlačítka Vytvořit se pro účet služby okamžitě vytvoří klíč API a zobrazí se tajný klíč. Uložte tento tajný klíč na bezpečné a zabezpečené místo. Z bezpečnostních důvodů ho už nebudete moci znovu zobrazit prostřednictvím svého účtu OpenAI. Pokud tento tajný klíč ztratíte, budete muset vygenerovat nový.
Oprávnění klíče API účtu služby jsou ve výchozím nastavení nastavena na čtení a zápis všech prostředků API projektu. Tato oprávnění lze aktualizovat v nastavení klíčů API vašeho projektu.
Účty služeb jsou uvedeny spolu se členy projektu na stránce nastavení členů projektu. Další informace o aktualizaci 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 spravuji klíče API v projektech své organizace?
Klíče API pro každý projekt můžete vytvářet a spravovat na stránce nastavení daného projektu. V nastavení organizace vyberte projekt a klikněte na Klíče API.
Chcete-li vytvořit nový tajný klíč, vyberte + Create new secret key. Oprávnění tajného klíče můžete upravit také výběrem ikony Upravit vedle tajného klíče.
Oprávnění pro každý ze svých klíčů API můžete nastavit při vytváření nového tajného klíče nebo úpravou existujícího klíče.
K dispozici jsou tři úrovně oprávnění: Vše, Omezené a Pouze pro čtení.
Vše — Pro tajný klíč jsou nastavena úplná oprávnění. Toto je výchozí nastavení.
Omezené — Umožňuje uživateli nastavit oprávnění Žádné, Čtení a Zápis pro každý koncový bod.
Můžete například vytvořit klíč API, který výslovně nemá oprávnění ke čtení ani zápisu do koncového bodu /v1/assistants:
Pouze pro čtení — Oprávnění ke čtení jsou nastavena pro všechny koncové body.
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 rozpočty projektů své organizace?
Rozpočty projektů 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, v nastavení organizace klikněte na Limity, a přejděte dolů na Limity využití.
Chcete-li nastavit limity projektu, v nastavení organizace klikněte na projekt, který chcete aktualizovat, a vyberte Limity. Můžete aktualizovat Měsíční rozpočet, Prahovou hodnotu oznámení a Využití modelů.
Nastavení měsíčního rozpočtu vám umožní stanovit měkké prahové hodnoty výdajů pro projekt. Když využití v daném kalendářním měsíci (UTC) tento limit překročí, požadavky API se budou nadále zpracovávat bez přerušení. Tato funkce vám má pomoci sledovat využití prostřednictvím rozpočtových upozornění, ale nevynucuje pevný strop výdajů. Když je vytvořen rozpočet projektu, ve výchozím nastavení se vytvoří upozornění na prahové hodnotě 100 %. Další rozpočty s různými prahovými hodnotami lze nastavit kliknutím na Přidat upozornění.
Upozorňujeme, že vlastník či vlastníci organizace a vlastník či vlastníci projektu budou tyto zprávy dostávat vždy a toto nelze přizpůsobit.
Jak odstraním nebo archivuji projekt?
Projekty lze archivovat buď na nové stránce seznamu projektů, nebo v nastavení jednotlivého projektu. Jakmile je projekt archivován, nelze jej obnovit. Při pokračování v archivaci budete vyzváni k zadání názvu projektu, abyste mohli pokračovat.
Seznam všech archivovaných projektů si můžete zobrazit na kartě „Archivováno“ na stejné stránce seznamu projektů.
Odstraňování projektů není možné; 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ů na projekt?
OpenAI v současnosti podporuje kvótu úložiště 100 GB souborů na projekt.
Pokud je tato kvóta překročena, 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ík projektu, proč nevidím řídicí panel využití svého projektu?
Viditelnost řídicího panelu využití projektu nesouvisí s rolí uživatele v projektu. Místo toho ji určuje vaše role v organizaci a nastavení na adrese https://platform.openai.com/settings/organization/data-controls/visibility
Pokud řídicí panel využití nevidíte, toto nastavení je pravděpodobně nastaveno na „Viditelné pro vlastníky organizace“.