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 umiestnite kurzor na názov projektu v ľavom rohu stránky a vyberte možnosť Vytvoriť projekt.
Zadajte názov, opis a webovú lokalitu projektu a potom vyberte možnosť Vytvoriť.
Ako pridám používateľov do projektu?
Noví členovia organizácie sa do „Predvoleného projektu“ nepridajú automaticky. Nových členov môžete do projektu pozvať pri ich pozývaní do organizácie (začiarknutím políčka „Pozvať do predvoleného projektu“) alebo po prijatí pozvánky do organizácie.
Používatelia pozvaní cez Admin API sa riadia pravidlami koncového bodu /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, či cieľový projekt existuje a nie je archivovaný.
Vlastníci organizácie sa automaticky pridajú ako vlastníci 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 organizácie, k čomu mám prístup?
Používatelia, ktorí nie sú vlastníkmi organizácie, 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 má 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 vytvorené pomocou Asistentov a všetky pridané súbory.
Členovia projektu môžu vidieť všetkých ostatných členov daného projektu a ich roly (t. j. Vlastník alebo Člen).
Ako zmením rolu používateľa v projekte alebo ho z projektu odstránim?
Rolu používateľa v projekte môže zmeniť alebo používateľa z projektu odstrániť iba vlastník projektu. Ďalšie informácie nájdete v časti roly a oprávnenia.
Ak chcete upraviť používateľa v projekte, prejdite do nastavení organizácie, vyberte projekt a kliknite na položku Členovia. Každému členovi môžete nastaviť rolu Č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
Po kliknutí na tlačidlo + Pridať člena sa zobrazí zoznam používateľov vo vašej organizácii s rolou Čitateľ. Ak chcete pridať používateľa, ktorý momentálne nie je vo vašej organizácii, musíte ho najprv pridať do organizácie (ak mu nechcete poskytnúť širší prístup, políčko „Pridať do predvoleného projektu“ môžete nechať nezačiarknuté). Tento zoznam nezahŕňa účty služieb. V tomto kroku môžete vybrať rolu Vlastník alebo Člen:
Pri pridávaní člena tímu mu musíte priradiť rolu Člen alebo Vlastník. Členovia projektu môžu odosielať požiadavky API, ktoré čítajú alebo upravujú údaje. Vlastníci projektu môžu navyše upravovať nastavenia a limity výdavkov projektu a spravovať jeho členov. Ďalšie informácie nájdete v časti roly a oprávnenia.
Ako vytvoriť účet služby pre projekt
Najprv prejdite do projektu, pre ktorý chcete vytvoriť účet služby, jeho výberom z rozbaľovacej ponuky na navigačnom paneli:
Potom prejdite do nastavení organizácie -> Projekt -> Členovia -> a kliknite na + Účet služby:
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ženie kľúča API účtu služby
Po výbere tlačidla Vytvoriť sa pre účet služby okamžite vytvorí kľúč API a zobrazí sa tajný kľúč. Tento tajný kľúč si uložte na bezpečné miesto. Z bezpečnostných dôvodov si ho už vo svojom účte OpenAI nebudete môcť znova zobraziť. Ak tento tajný kľúč stratíte, budete musieť vygenerovať nový.
Kľúč API účtu služby má predvolene oprávnenia na čítanie a zápis pre všetky zdroje API projektu. Tieto oprávnenia môžete aktualizovať v nastaveniach kľúčov API svojho projektu.
Účty služieb sú na stránke nastavení členov projektu uvedené spolu s členmi projektu. Ďalšie informácie o aktualizácii alebo odstránení prístupu účtu služby na stránke nastavení členov projektu nájdete tu.
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 svojej organizácie?
Kľúče API pre jednotlivé projekty môžete vytvárať a spravovať na stránke nastavení daného projektu. V nastaveniach organizácie vyberte projekt a kliknite na položku Kľúče API.
Ak chcete vytvoriť nový tajný kľúč, vyberte možnosť + Vytvoriť nový tajný kľúč. Oprávnenia tajného kľúča môžete upraviť aj výberom ikony Upraviť vedľa daného kľúča.
Oprávnenia každého kľúča 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 oprávnení: Všetky, Obmedzené a Iba na čítanie.
Všetky — Tajný kľúč má nastavené úplné oprávnenia. Toto je predvolené nastavenie.
Obmedzené — Umožňuje používateľovi nastaviť pre každý koncový bod oprávnenia Žiadne, Čítanie alebo Zápis.
Môžete napríklad vytvoriť kľúč API, ktorý nebude mať oprávnenie na čítanie ani zápis pre koncový bod /v1/assistants:
Iba na čítanie — Pre všetky koncové body sú nastavené oprávnenia na čítanie.
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 nastaviť a spravovať iba vlastníci organizácie a vlastníci projektu. Ďalšie informácie nájdete v časti roly a oprávnenia. Ak chcete zmeniť limity na úrovni organizácie, v nastaveniach organizácie kliknite na položku Limity a prejdite nadol na položku Limity využitia.
Ak chcete nastaviť limity projektu, v nastaveniach organizácie kliknite na projekt, ktorý chcete aktualizovať, a vyberte položku Limity. Môžete aktualizovať mesačný limit výdavkov, prahovú hodnotu upozornení a využitie modelov.
Nastavením mesačného limitu výdavkov môžete pre projekt určiť orientačné prahové hodnoty výdavkov. Ak využitie počas daného kalendárneho mesiaca (UTC) tento limit prekročí, požiadavky API sa budú naďalej spracúvať bez prerušenia. Táto funkcia pomáha sledovať využitie prostredníctvom upozornení na limit výdavkov, ale neuplatňuje pevný strop výdavkov. Pri vytvorení limitu výdavkov projektu sa predvolene vytvorí upozornenie pri dosiahnutí 100 %. Ďalšie upozornenia pri rôznych prahových hodnotách môžete nastaviť kliknutím na Pridať upozornenie.
Upozorňujeme, že tieto správy budú vždy dostávať vlastníci organizácie aj projektu a toto nastavenie nemožno 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 môžete archivovať na novej stránke so zoznamom projektov alebo v nastaveniach konkrétneho projektu. Archivovaný projekt nemožno obnoviť. Pri archivácii budete musieť na pokračovanie zadať názov projektu.
Zoznam všetkých archivovaných projektov si môžete pozrieť na karte „Archivované“ na rovnakej stránke so zoznamom projektov.
Projekty nemožno odstrániť. Uchovávame históriu všetkých projektov, aby sme zabezpečili kontinuitu sledovania využitia 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 v súčasnosti podporuje kvótu úložiska súborov 100 GB na projekt.
Ak túto kvótu prekročíte, zobrazí sa 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íkom projektu. Prečo nevidím panel využitia svojho projektu?
Viditeľnosť panela využitia projektu nesúvisí s rolou používateľa v projekte. Určuje ju vaša rola v organizácii a zároveň nastavenia na stránke https://platform.openai.com/settings/organization/data-controls/visibility.
Ak panel využitia nevidíte, toto nastavenie je pravdepodobne nastavené na možnosť „Viditeľné pre vlastníkov organizácie“.