Cieľom projektov je umožniť zákazníkom organizovať si prácu. Organizácie môžu spravovať prístup a limity, zriaďovať servisné účty (cez používateľské rozhranie) a sledovať používanie vo vymedzenom rozsahu v rámci projektu (napr. modely, možnosti, vlákna, asistenti, dolaďovanie, úložisko atď.). Aktivitu používania možno rozdeliť podľa projektu a používatelia môžu zobrazovať fakturáciu a nastavovať limity výdavkov pre jednotlivé projekty.
Vlastníci organizácie môžu zobraziť všetky svoje aktívne a archivované projekty na stránke Projekty. Prečítajte si viac o používateľských rolách a povoleniach na Platforme API.
Kto môže vytvoriť projekt?
Projekt môžu vytvoriť iba vlastníci organizácie. Ďalšie informácie nájdete v časti roly a povolenia.
Ak chcete prepínať medzi organizáciami, umiestnite kurzor na názov svojej organizácie vľavo hore na stránke a vyberte organizáciu zo zoznamu:
V prípade organizácií s konsolidovaným fakturačným plánom sa podorganizácie identifikujú samostatne. Projekty nemožno vytvárať v rámci podorganizácií.
Ako fungujú projekty?
Každá organizácia obsahuje „predvolený projekt“, ktorý nie je možné odstrániť. Môžete nakonfigurovať limity rýchlosti, povolenia virtuálnych modelov a limity výdavkov (od novembra 2024). Dedí úplnú konfiguráciu organizácie, takže doň nemôžete priamo pridávať členov ani servisné účty.
Ako vytvorím projekt?
Najprv podržte kurzor nad názvom projektu v ľavom rohu stránky a vyberte Create project.
Zadajte názov, popis a webovú stránku projektu a potom vyberte Create.
Ako pridám používateľov do projektu?
Novopridaní členovia organizácie sa automaticky nepridajú do „Predvoleného projektu“. Nových členov možno pozvať do projektu buď pri pozývaní do organizácie (začiarknutím políčka „Pozvať do predvoleného projektu“), alebo po tom, ako člen prijme pozvánku do organizácie.
Používatelia pozvaní cez Admin API sa riadia pravidlami uvedenými pre koncový bod /organization/invites.
Ak sa pri pozývaní používateľov do projektu cez používateľské rozhranie alebo Admin API vyskytne chyba, pred opätovným odoslaním pozvánky najprv overte, že cieľový projekt existuje a nie je archivovaný.
Vlastníci organizácie sa automaticky pridávajú ako vlastníci do nových projektov vytvorených v organizácii.
Aké rôzne používateľské roly existujú v organizáciách a projektoch a aké povolenia zahŕňajú?
Zatiaľ čo organizácie majú roly „owner“ a „reader“, projekty majú roly „owner“ a „member“. Členovia projektu zodpovedajú čitateľom organizácie. Podrobnejší opis povolení, ktoré sú priradené jednotlivým používateľským rolám, nájdete v tabuľke nižšie.
| Rola | Rozsah | Opis |
|---|---|---|
| Vlastník | Organizácia | Môže vytvárať a zobrazovať všetky projekty, všetkých používateľov a všetky kľúče API. Má možnosť monitorovať všetky projekty v organizácii na stránke Projekty . Môže nastavovať limity výdavkov organizácie aj limity výdavkov projektov. Môže udeliť povolenia na zobrazenie informácií o používaní pre ostatných v organizácii. Môže archivovať projekty. |
| Čitateľ | Organizácia | Môže vykonávať inferenciu, používať zdroje a vytvárať kľúče vo svojich projektoch. Môže byť pridaný do projektov. Nemôže vytvárať projekty ani spravovať používateľov. |
| Vlastník | Projekt | Môže pridávať do projektu ďalších používateľov a premenovať projekt, ako aj využívať všetky možnosti člena. Môže nastavovať limity výdavkov projektu. Môže archivovať projekt. |
| Člen | Projekt | Môže vykonávať inferenciu, používať zdroje a vytvárať kľúče na úrovni projektu. |
Ak nie som vlastníkom v organizácii, k čomu mám prístup?
Používatelia, ktorí nie sú vlastníkmi v organizácii, môžu vidieť iba projekty, ktorých sú členmi. Iba vlastník organizácie môže vidieť všetky projekty, členov a kľúče API na úrovni projektu a mať prístup na stránku Projekty.
Iba členovia projektu (a vlastníci organizácie) môžu vidieť doladené modely vytvorené v danom projekte, vlákna od ľubovoľných vytvorených asistentov alebo akékoľvek pridané súbory.
Členovia projektu môžu vidieť, kto sú všetci ostatní členovia daného projektu, a ich roly (t. j. vlastník alebo člen).
Ako aktualizujem rolu používateľa v projekte alebo odstránim používateľa z projektu?
Rolu používateľa v projekte môže aktualizovať alebo používateľa z projektu odstrániť iba vlastník projektu. Ďalšie informácie nájdete v časti roly a povolenia.
Ak chcete aktualizovať používateľa v projekte, prejdite do nastavení organizácie, vyberte projekt a kliknite na Členovia. Rolu každého člena môžete nastaviť ako Člen alebo Vlastník. Používateľa môžete z projektu odstrániť aj výberom možnosti Odstrániť.
Čo je servisný účet a čím sa líši od bežného používateľského účtu?
Servisný účet funguje ako pseudo-používateľ určený na systémový prístup, odlišný od individuálnych používateľských účtov. Servisné účty môžu vytvárať iba vlastníci organizácie a projektu.
Servisné účty sú viazané len na projekty.
Pridanie člena do projektu
Ak kliknete na tlačidlo + Add member, zobrazí sa zoznam používateľov vo vašej organizácii s rolou Reader. Ak chcete pridať používateľa, ktorý momentálne nie je vo vašej organizácii, najprv ho musíte pridať do organizácie (ak týmto používateľom nechcete udeliť širší prístup, môžete ponechať začiarkavacie políčko „Pridať do predvoleného projektu“ nezačiarknuté). Tento zoznam nebude obsahovať servisné účty. V tomto kroku môžete vybrať, či bude jeho rola Owner alebo Member:
Keď pridávate člena tímu, musíte mu priradiť rolu Member alebo Owner. Členovia projektu môžu odosielať požiadavky API, ktoré čítajú alebo upravujú údaje, zatiaľ čo vlastníci projektu môžu upravovať aj nastavenia projektu a limity výdavkov projektu a spravovať členov projektu. Ďalšie informácie nájdete v časti roly a povolenia.
Ako vytvoriť servisný účet pre projekt
Najprv prejdite na projekt, pre ktorý chcete vytvoriť servisný účet, výberom z rozbaľovacej ponuky v navigačnom paneli:
Potom prejdite do nastavení organizácie -> Projekt -> Členovia -> kliknite na + Service account:
Servisné účty vytvorené na úrovni projektu sú jedinečné pre daný projekt a nemožno ich používať mimo projektu, v ktorom boli vytvorené.
Pomenovanie servisného účtu
Bez ohľadu na to, či vytvárate servisný účet na úrovni organizácie alebo jedinečný pre projekt, pri vytváraní servisného účtu môžete vytvoriť jedinečné ID servisného účtu pozostávajúce z písmen, číslic a spojovníkov, aby ste servisný účet ľahko identifikovali.
Uložte kľúč API servisného účtu
Po výbere tlačidla Vytvoriť sa pre servisný účet okamžite vytvorí kľúč API a zobrazí sa tajný kľúč. Uložte tento tajný kľúč na bezpečné a chránené miesto. Z bezpečnostných dôvodov si ho už nebudete môcť znova zobraziť prostredníctvom svojho účtu OpenAI. Ak tento tajný kľúč stratíte, budete musieť vygenerovať nový.
Povolenia kľúča API servisného účtu sú predvolene nastavené na čítanie a zápis všetkých zdrojov API projektu. Tieto povolenia možno aktualizovať v nastaveniach kľúčov API vášho projektu.
Servisné účty sú uvedené spolu s členmi projektu na stránke nastavení členov vášho projektu. Ak sa chcete dozvedieť viac o aktualizácii alebo odstránení prístupu servisného účtu na stránke nastavení členov vášho projektu, pozrite si túto časť.
Všetky servisné účty naprieč projektmi aj organizáciami sa zobrazia spolu s vašimi ľudskými používateľmi na stránke členov na úrovni organizácie.
Servisné účty sa spravujú ako bežné účty. V ponuke Organizácia -> Členovia môžete servisný účet odstrániť alebo aktualizovať jeho rolu:
Ako spravujem kľúče API v projektoch mojej organizácie?
Kľúče API pre každý projekt môžete vytvárať a spravovať na stránke nastavení daného projektu. V nastaveniach organizácie vyberte projekt a kliknite na Kľúče API.
Ak chcete vytvoriť nový tajný kľúč, vyberte + Create new secret key. Povolenia tajného kľúča môžete upraviť aj výberom ikony Upraviť vedľa tajného kľúča.
Povolenia pre každý zo svojich kľúčov API môžete nastaviť pri vytváraní nového tajného kľúča alebo úpravou existujúceho kľúča.
K dispozícii sú tri úrovne povolení: Všetko, Obmedzené a Iba na čítanie.
Všetko — Pre tajný kľúč sú nastavené úplné povolenia. Toto je predvolené nastavenie.
Obmedzené — Umožňuje používateľovi nastaviť pre každý koncový bod povolenia Žiadne, Čítanie a Zápis.
Napríklad vytvoríte kľúč API, ktorý konkrétne nemá povolenie na čítanie ani zápis do koncového bodu /v1/assistants:
Iba na čítanie — Povolenia na čítanie sú nastavené pre všetky koncové body.
Ako sa spravuje prístup používateľov patriacich do viacerých projektov alebo organizácií?
Používatelia môžu byť členmi toľkých projektov, koľko je potrebné. V rámci projektu si používatelia môžu vygenerovať osobný API kľúč, ktorý je viazaný a obmedzený na prístup k danému projektu a jeho zdrojom.
Ako nastavím a spravujem limity požiadaviek pre projekty mojej organizácie?
Limity požiadaviek na úrovni projektu môže nastavovať a spravovať iba vlastník organizácie. Ďalšie informácie nájdete v časti roly a povolenia.
V nastaveniach organizácie kliknite na projekt, ktorý chcete aktualizovať, a v sekcii Projekt v navigačnom zozname vyberte Limity. Na tejto stránke môžete aktualizovať používanie modelov.
Používanie modelov vám umožňuje nakonfigurovať, ktoré modely môže projekt používať, a podľa potreby možno pre každý model nastaviť limity požiadaviek.
Ako nastavím a spravujem limity výdavkov pre projekty svojej organizácie?
Limity výdavkov projektu môžu nastavovať a spravovať iba vlastníci organizácie a vlastníci projektu. Ďalšie informácie nájdete v časti roly a povolenia. Ak chcete zmeniť limity na úrovni organizácie, v nastaveniach organizácie kliknite na Limits, a prejdite nadol na Usage limits.
Ak chcete nastaviť limity projektu, v nastaveniach organizácie kliknite na projekt, ktorý chcete aktualizovať, a vyberte Limits. Môžete aktualizovať Monthly spend limit, Notification threshold a Model Usage.
Nastavením mesačného limitu výdavkov môžete pre svoj projekt určiť mäkké prahové hodnoty výdavkov. Keď používanie v danom kalendárnom mesiaci (UTC) prekročí tento limit, požiadavky API sa budú naďalej spracúvať bez prerušenia. Táto funkcia vám pomáha sledovať používanie pomocou upozornení na limity výdavkov, ale nevynucuje pevný strop výdavkov. Keď sa vytvorí limit výdavkov projektu, predvolene sa vytvorí upozornenie na prahovej hodnote 100 %. Ďalšie upozornenia pri rôznych prahových hodnotách môžete nastaviť kliknutím na Add Alert.
Upozorňujeme, že vlastníci organizácie a vlastníci projektu budú tieto správy dostávať vždy a toto nastavenie nie je možné prispôsobiť.
Ako nastavím limity výdavkov pre svoju organizáciu alebo projekt?
OpenAI teraz podporuje mesačné limity výdavkov API na úrovni organizácie aj projektu. Limit výdavkov môže výdavky iba monitorovať bez vynucovania, alebo ho môžete vynucovať ako pevný limit, takže po dosiahnutí limitu výdavkov požiadavky API zlyhajú. Najnovšie kroky konfigurácie a informácie o správaní nájdete v časti Limity výdavkov v dokumentácii pre vývojárov.
Ako odstránim alebo archivujem projekt?
Projekty možno archivovať buď na novej stránke zoznamu projektov, alebo v nastaveniach jednotlivého projektu. Po archivovaní projektu ho nemožno obnoviť. Pri pokračovaní v archivácii budete vyzvaní, aby ste zadali názov projektu.
Zoznam všetkých archivovaných projektov si môžete pozrieť na karte „Archivované“ na tej istej stránke zoznamu projektov.
Odstraňovanie projektov nie je možné; uchovávame históriu všetkých projektov, aby sme zabezpečili kontinuitu sledovania používania a fakturácie.
Existuje limit na počet projektov, ktoré môžem mať v organizácii?
Organizácie môžu štandardne vytvoriť až 2 000 projektov.
Môžu sa zdroje zdieľať medzi projektmi?
Zdroje projektu (napríklad súbory, asistenti, úložisko alebo vlákna) sú viazané na projekt a členovia bez administrátorských oprávnení mimo projektu k nim nemajú prístup. Okrem toho nie je možné presúvať zdroje medzi projektmi.
Jedinou výnimkou je, že jemné doladenia v „Predvolenom projekte“ sú prístupné z iných projektov.
Aká je kvóta úložiska súborov na projekt?
OpenAI momentálne podporuje kvótu úložiska 100 GB súborov na projekt.
Ak je táto kvóta prekročená, zobrazí sa vám nasledujúca chyba:
Prekročili ste kvótu úložiska súborov. Organizácie sú obmedzené na 100 GB súborov. Zmenšite veľkosť súborov alebo kontaktujte podporu.Odporúčame odstrániť nepoužívané súbory uložené vo vašom účte. Na porovnanie môžete súbory zobraziť a vypísať pomocou API.
Som vlastník projektu. Prečo nevidím panel používania pre svoj projekt?
Viditeľnosť panela používania projektu nesúvisí s rolou používateľa v rámci projektu. Namiesto toho ju určuje vaša rola v organizácii a nastavenia na adrese https://platform.openai.com/settings/organization/data-controls/visibility
Ak panel používania nevidíte, toto nastavenie je pravdepodobne nastavené na „Viditeľné pre vlastníkov organizácie“.