Cílem projektů je poskytnout zákazníkům možnost organizovat svou práci. Organizace mohou spravovat přístup a limity, zřizovat servisní účty (přes uživatelské rozhraní) a sledovat využití v rámci omezeného rozsahu v projektu (např. modely, schopnosti, vlákna, asistenti, jemné doladění, úložiště atd.). Aktivitu využití lze rozdělit podle projektů a uživatelé mohou zobrazovat fakturaci a nastavovat rozpočty pro jednotlivé projekty.
Vlastníci organizace mohou na stránce Projects zobrazit všechny své aktivní i archivované projekty. Více informací o uživatelských rolích a oprávněních v platformě API.
Kdo může vytvořit projekt?
Projekt mohou vytvářet pouze vlastníci organizace. Další informace najdete v části role a oprávnění.
Chcete-li přepínat mezi organizacemi, najeďte myší na název organizace v levém horním rohu stránky a vyberte organizaci ze seznamu:
U organizací, které mají konsolidovaný fakturační plán, jsou dílčí organizace identifikovány samostatně. Projekty nelze vytvářet v dílčích organizacích.
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 do „Výchozího projektu“ nepřidávají automaticky. Nové členy lze do projektu pozvat buď při jejich pozvání do organizace (zaškrtnutím políčka "Invite to default project"), nebo poté, co člen přijme pozvánku do organizace.
Uživatelé pozvaní přes Admin API se řídí pravidly popsanými v koncovém bodu /organization/invites.
Pokud se při zvání uživatelů do projektu přes uživatelské rozhraní nebo Admin API zobrazí chyba, nejprve ověřte, že cílový projekt existuje a není archivovaný, a teprve poté pozvánku odešlete znovu.
Vlastníci organizace jsou automaticky přidá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í s sebou nesou?
Zatímco organizace mají role „owner“ a „reader“, projekty mají role „owner“ a „member“. Členové projektu jsou obdobou čtenářů organizace. Podrobnější popis oprávnění spojených s jednotlivými rolemi uživatelů najdete v tabulce níže.
| Role | Rozsah | Popis |
|---|---|---|
| Owner | Organizace | Může vytvářet/zobrazovat všechny projekty, všechny uživatele a všechny klíče API. Má možnost monitorovat všechny projekty v rámci organizace pomocí stránky Projects. Může nastavovat rozpočty organizace a projektů. Může udělovat ostatním v organizaci oprávnění k zobrazení informací o využití. Může archivovat projekty. |
| Reader | Organizace | Může provádět inferenci, používat prostředky 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. |
| Owner | Projekt | Může do projektu přidávat další uživatele a přejmenovat projekt, stejně jako dělat vše, co člen. Může nastavovat rozpočty projektu. Může projekt archivovat. |
| Member | Projekt | Může provádět inferenci, používat prostředky a vytvářet klíče na úrovni projektu. |
Pokud nejsem v organizaci Owner, k čemu mám přístup?
Uživatelé, kteří v organizaci nejsou vlastníky, vidí pouze projekty, jejichž jsou členy. Pouze vlastník organizace může vidět všechny projekty, členy a klíče API na úrovni projektu a má přístup ke stránce Projects.
Pouze členové projektu (a vlastníci organizace) mohou vidět jemně doladěné modely vytvořené v tomto projektu, vlákna z vytvořených Assistants nebo přidané soubory.
Členové projektu mohou vidět všechny ostatní členy tohoto projektu a jejich role (tj. Owner nebo Member).
Jak aktualizuji roli uživatele v projektu nebo uživatele z projektu odeberu?
Roli uživatele v projektu 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 Members. Máte možnost nastavit roli každého člena jako Member nebo Owner. Můžete také vybrat Remove a tím uživatele z projektu 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 (políčko 'Add to Default Project" můžete nechat nezaškrtnuté, pokud těmto uživatelům nechcete dát širší přístup). Tento seznam nebude zahrnovat servisní účty. V tomto kroku můžete zvolit, zda bude jejich role Owner, nebo Member:
Když přidáte člena týmu, musíte mu přiřadit roli buď Member , nebo Owner. Členové projektu mohou provádět API požadavky, které čtou nebo upravují data, zatímco vlastníci projektu mohou navíc upravovat nastavení projektu, rozpočty projektu a spravovat členy projektu. Další informace najdete v části role a oprávnění.
Jak vytvořit servisní účet pro projekt
Nejprve přejděte do projektu, pro který chcete vytvořit servisní účet, výběrem z rozbalovací nabídky v navigačním panelu:
Poté přejděte do nastavení organizace -> Project -> Members -> 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žení klíče API servisního účtu
Po výběru tlačítka Create se pro servisní účet okamžitě vytvoří klíč API a zobrazí se tajný klíč. Uložte tento tajný klíč na bezpečné místo. Z bezpečnostních důvodů jej už přes svůj účet OpenAI nebudete moci znovu zobrazit. Pokud tento tajný klíč ztratíte, budete muset vygenerovat nový.
Oprávnění klíče API servisního účtu jsou ve výchozím nastavení nastavena na čtení a zápis ke všem API prostředkům projektu. Tato oprávnění lze aktualizovat v nastavení API Keys vašeho projektu.
Servisní účty jsou uvedeny vedle členů projektu na stránce nastavení členů projektu. Více informací o aktualizaci nebo odebrání přístupu servisního účtu na stránce nastavení členů projektu najdete zde.
Všechny servisní účty napříč projekty i organizacemi se zobrazí vedle vašich lidských uživatelů na stránce členů na úrovni organizace.
Servisní účty se spravují stejně jako běžné účty. V nabídce Organization -> Members můžete servisní účet Remove 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 API Keys.
Chcete-li vytvořit nový tajný klíč, vyberte + Create new secret key. Můžete také vybrat ikonu Edit vedle tajného klíče a upravit jeho oprávnění.
Oprávnění pro každý svůj klíč API můžete nastavit při vytvoření nového tajného klíče nebo úpravou existujícího klíče.
K dispozici jsou tři úrovně oprávnění: All, Restricted a Read Only.
All — Pro tajný klíč jsou nastavena plná oprávnění. Toto je výchozí nastavení.
Restricted — Umožňuje uživateli nastavit pro každý koncový bod oprávnění None, Read a Write.
Například vytvoříte klíč API, který konkrétně nemá oprávnění číst ani zapisovat do koncového bodu /v1/assistants:
Read Only — 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 rychlosti pro projekty své organizace?
Limity rychlosti 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 Project v navigačním seznamu vyberte Limits. Na této stránce můžete aktualizovat Model Usage.
Model usage umožňuje nakonfigurovat, které modely může projekt používat, a limity rychlosti lze podle potřeby nastavit pro každý model.
Jak nastavím a spravuji rozpočty pro projekty 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 Limits, a přejděte dolů na Usage limits.
Chcete-li nastavit limity projektu, v nastavení organizace klikněte na projekt, který chcete aktualizovat, a vyberte Limits. Můžete aktualizovat Monthly budget, Notification threshold a Model Usage.
Nastavení měsíčního rozpočtu vám umožňuje stanovit měkké prahové hodnoty výdajů pro váš projekt. Když využití v daném kalendářním měsíci (UTC) tento limit překročí, API požadavky se budou nadále zpracovávat bez přerušení. Tato funkce je navržena tak, aby vám pomohla sledovat využití prostřednictvím rozpočtových upozornění, ale nevynucuje pevný strop výdajů. Po vytvoření rozpočtu projektu se ve výchozím nastavení vytvoří upozornění na prahu 100 %. Další rozpočty při různých prahových hodnotách lze nastavit kliknutím na Add Alert.
Vezměte prosím na vědomí, že vlastník(ci) organizace a vlastník(ci) projektu budou tyto zprávy dostávat vždy a toto nelze přizpůsobit.
Jak odstraním nebo archivuju projekt?
Projekty lze archivovat buď přes novou stránku seznamu projektů, nebo v nastavení jednotlivého projektu. Jakmile je projekt archivován, nelze jej obnovit. Při pokračování archivace budete vyzváni k zadání názvu projektu.
Seznam všech archivovaných projektů můžete zobrazit na kartě „Archived“ na stejné stránce seznamu projektů.
Odstranění projektů není možné, uchováváme historii všech projektů, abychom zajistili kontinuitu 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 přehled můžete soubory zobrazit a vypsat pomocí API.
Jsem vlastník projektu, proč nevidím řídicí panel Usage pro svůj projekt?
Viditelnost řídicího panelu Usage projektu nesouvisí s rolí uživatele v projektu. Místo toho je určena vaší rolí v organizaci a nastavením na https://platform.openai.com/settings/organization/data-controls/visibility
Pokud řídicí panel Usage nevidíte, je toto nastavení pravděpodobně nastaveno na "Visible to organization owners".