Prehľad
Projekty slúžia na organizáciu práce v rámci organizácie v API. Pomocou projektov môžete spravovať prístup, nastavovať limity modelov a požiadaviek, vytvárať servisné účty a sledovať využívanie, fakturáciu a limity výdavkov pre určený súbor zdrojov, ako sú modely, funkcie, vlákna, asistenti, dolaďovanie a úložisko.
Vlastníci organizácie si môžu pozrieť všetky aktívne aj archivované projekty na stránke Projekty.
Skôr než začnete
Na vytvorenie projektu potrebujete rolu vlastníka organizácie. Organizácie môžu predvolene vytvoriť až 2 000 projektov.
Ak vaša organizácia používa konsolidovanú fakturáciu, podriadené organizácie sa v ponuke na výber organizácie zobrazujú samostatne. V podriadenej organizácii nemôžete vytvárať projekty.
Ak chcete prepnúť organizáciu, otvorte ponuku na výber organizácie a vyberte tú, ktorú chcete používať.
Predvolený projekt
Každá organizácia obsahuje predvolený projekt, ktorý nemožno odstrániť. Dedí celú konfiguráciu organizácie. Môžete nastaviť jeho limity požiadaviek, oprávnenia pre virtuálne modely a limity výdavkov.
Členov ani servisné účty nemôžete pridávať priamo do predvoleného projektu. Prístup k predvolenému projektu môžete udeliť pri pozývaní používateľa do organizácie podľa postupu pozvania do organizácie uvedeného v tomto článku.
Vytvorenie projektu
Otvorte ponuku na výber projektu a vyberte Vytvoriť projekt.
Zadajte názov, opis a webovú stránku projektu.
Vyberte Vytvoriť.
Vlastníci organizácie sa automaticky pridávajú ako vlastníci nových projektov.
Prehľad rolí a prístupu
Tabuľka sumarizuje roly vlastníka a čitateľa organizácie a vlastníka a člena projektu, ktoré sa používajú v týchto postupoch. Členovia projektu majú podobné oprávnenia ako čitatelia organizácie.
| Rola | Rozsah | Oprávnenia |
|---|---|---|
| Vlastník | Organizácia | Vytváranie a zobrazovanie všetkých projektov, používateľov a kľúčov API. Sledovanie projektov na stránke Projekty. Nastavovanie limitov výdavkov organizácie a projektov. Udeľovanie prístupu k údajom o využívaní iných používateľov. Archivácia projektov. |
| Čitateľ | Organizácia | Môže byť pridaný do projektov, vykonávať inferenciu, používať zdroje a vytvárať kľúče v týchto projektoch. Nemôže vytvárať projekty ani spravovať používateľov. |
| Vlastník | Projekt | Všetky oprávnenia člena a navyše pridávanie používateľov, správa členov a nastavení projektu, premenovanie projektu, nastavenie jeho limitov výdavkov a jeho archivácia. |
| Člen | Projekt | Vykonávanie inferencie, používanie zdrojov, vytváranie kľúčov na úrovni projektu a odosielanie požiadaviek API na čítanie alebo úpravu údajov. |
Podrobnosti o rolách v organizácii nájdete v článku Roly v organizácii. Ďalšie roly, vlastné roly a úplný prehľad oprávnení nájdete v sprievodcovi rolami a oprávneniami API.
Viditeľnosť projektov
Pri týchto štandardných rolách môžu používatelia, ktorí nie sú vlastníkmi organizácie, vidieť iba projekty, ktorých sú členmi. Vlastníci organizácie môžu vidieť všetky projekty, členov a kľúče API na úrovni projektov a majú prístup na stránku Projekty.
Členovia projektu vidia ostatných členov svojho projektu aj rolu každého z nich. Doladené modely, vlákna asistentov a súbory vytvorené alebo pridané v rámci projektu môžu vidieť iba členovia projektu a vlastníci organizácie.
Môžete byť členom ľubovoľného počtu projektov. Osobný kľúč API vytvorený v rámci projektu je obmedzený na daný projekt a jeho zdroje.
Obmedzenia prístupu k zdrojom
Súbory, asistenti, úložisko a vlákna sú viazané na svoj projekt. Členovia mimo daného projektu, ktorí nie sú správcami, nemajú prístup k jeho zdrojom. Zdroje nemožno presúvať medzi projektmi.
Výnimkou sú doladené modely v predvolenom projekte: k nim možno pristupovať aj z iných projektov.
Správa členov projektu
Pozvanie používateľa do organizácie
Používateľa môžete pridať do projektu až vtedy, keď je členom vašej organizácie.
Keď niekoho pozývate do organizácie, môžete mu udeliť aj prístup k predvolenému projektu začiarknutím príslušnej možnosti vo formulári pozvánky. Ak nechcete udeliť prístup k predvolenému projektu, nechajte túto možnosť nezačiarknutú. Noví členovia organizácie sa do predvoleného projektu nepridávajú automaticky.
Pred pozvaním používateľa nemusíte vytvárať ďalší projekt. Používateľa môžete do projektu pridať aj po prijatí pozvánky do organizácie.
Pozvánky odoslané cez rozhranie Admin API sa riadia pravidlami pre koncový bod /organization/invites.
Pridanie člena organizácie do projektu
Vlastníci organizácie a projektu môžu pridávať členov:
Prejdite do nastavení organizácie.
Vyberte projekt a otvorte sekciu Členovia.
Vyberte + Pridať člena.
Vyberte používateľa a priraďte mu rolu Člen alebo Vlastník.
V zozname používateľov sa zobrazujú používatelia organizácie s rolou Čitateľ. Servisné účty v ňom nie sú zahrnuté.
Ak odoslanie pozvánky zlyhá v používateľskom rozhraní alebo cez Admin API, pred opätovným odoslaním overte, či cieľový projekt existuje a nie je archivovaný.
Zmena roly alebo odstránenie člena
Vlastníci organizácie a projektu môžu zmeniť rolu používateľa v projekte alebo ho z daného projektu odstrániť.
Prejdite do nastavení organizácie.
Vyberte projekt a otvorte sekciu Členovia.
Nastavte používateľovi rolu Člen alebo Vlastník, prípadne ho odstráňte výberom možnosti Odstrániť.
Vytváranie a správa servisných účtov
Servisný účet poskytuje prístup pre systémy namiesto toho, aby zastupoval konkrétneho používateľa. Servisné účty sú viazané na projekty.
Na vytváranie servisných účtov sú potrebné oprávnenia na správu servisných účtov. Tieto oprávnenia majú vlastníci organizácie a projektu.
Vytvorenie servisného účtu
Vyberte projekt v ponuke na výber projektu.
Prejdite do nastavení organizácie a vyberte projekt.
Otvorte sekciu Členovia a vyberte + Servisný účet.
Zadajte jedinečné ID servisného účtu zložené z písmen, číslic a spojovníkov.
Vyberte Vytvoriť.
Servisné účty vytvorené na úrovni projektu sú jedinečné pre daný projekt a nemožno ich používať mimo projektu, v ktorom boli vytvorené.
Rovnaký formát ID platí bez ohľadu na to, či servisný účet vytvárate v nastaveniach na úrovni organizácie alebo projektu.
Servisný účet vytvorený pre projekt je jedinečný pre daný projekt a nemožno ho používať mimo neho.
Uloženie tajného kľúča
Pri vytvorení servisného účtu sa okamžite vytvorí kľúč API a zobrazí sa jeho tajný kľúč. Tajný kľúč si bezpečne uložte. Vo svojom účte OpenAI si ho už nebudete môcť znova zobraziť. Ak ho stratíte, vygenerujte si nový kľúč.
Kľúč servisného účtu má predvolene oprávnenie na čítanie a zápis všetkých zdrojov API vo svojom projekte. Tieto oprávnenia môžete neskôr zmeniť v nastaveniach projektu v sekcii Kľúče API.
Úprava alebo odstránenie servisného účtu
Servisné účty sa zobrazujú spolu s používateľmi v nastaveniach projektu v sekcii Členovia. Ich prístup k projektu spravujte rovnakým postupom zmeny roly a odstránenia ako pri ostatných členoch projektu.
Všetky servisné účty sa zobrazujú spolu s používateľmi aj na stránke Členovia organizácie, vrátane účtov vytvorených v nastaveniach na úrovni organizácie aj projektu.
V ponuke Členovia v nastaveniach organizácie môžete zmeniť rolu servisného účtu alebo vybrať Odstrániť.
Vytváranie a správa kľúčov API
Každý projekt má vlastné kľúče API:
Prejdite do nastavení organizácie.
Vyberte projekt a otvorte sekciu Kľúče API.
Ak chcete vytvoriť kľúč, vyberte + Vytvoriť nový tajný kľúč. Ak chcete zmeniť oprávnenia existujúceho kľúča, vyberte ikonu úprav vedľa neho.
Výber oprávnení kľúča
Pri kľúčoch vlastnených používateľmi môžete oprávnenia nastaviť pri vytváraní kľúča alebo ich upraviť neskôr:
Všetky: Úplné oprávnenia. Toto je predvolené nastavenie.
Obmedzené: Vyberte rozsahy oprávnení pre konkrétne zdroje alebo koncové body. Dostupné možnosti závisia od zdroja a môžu zahŕňať Žiadne, Čítanie, Zápis alebo oprávnenia pre konkrétne požiadavky.
Iba na čítanie: Oprávnenia na čítanie pre všetky koncové body.
Kľúč s obmedzenými oprávneniami môže napríklad vylúčiť prístup na čítanie a zápis ku koncovému bodu /v1/assistants.
Na vytváranie kľúčov servisných účtov sú potrebné oprávnenia na správu servisných účtov. Ak túto možnosť nevidíte, požiadajte vlastníka organizácie alebo projektu o vytvorenie kľúča servisného účtu. Dialógové okno na vytvorenie kľúča pri kľúčoch servisných účtov nezobrazuje tieto možnosti nastavenia oprávnení. Oprávnenia zmeňte dodatočne v nastaveniach projektu v sekcii Kľúče API.
Nastavenie prístupu k modelom a limitov požiadaviek
Správa limitov požiadaviek projektu vyžaduje oprávnenia správcu. Tieto oprávnenia majú vlastníci organizácie. Vlastníci projektov môžu limity požiadaviek projektu spravovať aj cez rozhranie API na správu.
Prejdite do nastavení organizácie.
Vyberte projekt a otvorte sekciu Limity.
V časti Používanie modelov vyberte, ktoré modely môže projekt používať.
Podľa potreby nastavte limit požiadaviek pre každý model.
Nastavenie limitov výdavkov a upozornení
Mesačné limity výdavkov na API sú dostupné na úrovni organizácie aj projektu. Na zmenu limitu potrebujete oprávnenie spravovať nastavenia príslušnej organizácie alebo projektu.
Limit výdavkov môže slúžiť na sledovanie výdavkov bez zastavenia požiadaviek. Ak chcete, aby požiadavky API po dosiahnutí limitu evidovaných výdavkov zlyhávali, zapnite možnosť Vynútiť dodržiavanie pevného limitu. Vynucovanie limitu sa neuplatní okamžite, takže evidované výdavky môžu mierne prekročiť nastavenú sumu.
Upozornenia na výdavky vás informujú o dosiahnutí stanovenej hranice, no nezastavia požiadavky.
Nastavenie limitu výdavkov organizácie
Prejdite do nastavení organizácie.
Otvorte Limity a nájdite časť Výdavky.
Nastavenie limitu výdavkov projektu
Prejdite do nastavení organizácie.
Vyberte projekt a potom otvorte Limity.
Nastavte hodnoty v poliach Limit mesačných výdavkov a Upozorniť, keď výdavky dosiahnu.
Ak chcete po dosiahnutí limitu evidovaných výdavkov zastaviť prevádzku API, zapnite možnosť Vynútiť dodržiavanie pevného limitu.
Na tejto stránke môžete zmeniť aj nastavenie Používanie modelov.
Ak vaše výdavky presahujú mesačný rozpočet projektu, porovnajte údaje o využívaní za ten istý projekt a mesiac. Skontrolujte, či bola v čase využívania API zapnutá možnosť Vynútiť dodržiavanie pevného limitu. Ak bola vypnutá, rozpočet slúžil len na sledovanie výdavkov a požiadavky API sa naďalej spracúvali. Ak chcete, aby budúce požiadavky po dosiahnutí rozpočtu evidovaných výdavkov zlyhávali, vlastník organizácie alebo projektu môže v nastaveniach projektu v časti Limity zapnúť možnosť Vynútiť dodržiavanie pevného limitu.
Ak už bol pevný limit zapnutý, evidované výdavky môžu napriek tomu mierne prekročiť rozpočet, kým sa vynucovanie limitu uplatní. Ak výdavky daného projektu za príslušný mesiac aj po týchto kontrolách výrazne prekračujú vynucovaný limit a dôvod zostáva nejasný, kontaktujte podporu a uveďte ID projektu, vynucovaný limit, evidované výdavky, príslušné dátumy a časové pásmo. Ak máte k dispozícii ID príslušných požiadaviek, priložte ich tiež. Kľúče API neuvádzajte.
Správa upozornení na výdavky
Pri vytvorení limitu výdavkov projektu sa predvolene vytvorí aj upozornenie pri dosiahnutí 100 % limitu. Ak chcete pridať upozornenia pri dosiahnutí ďalších hraníc, vyberte Pridať upozornenie.
Upozornenia na výdavky projektu dostávajú vlastníci organizácie a projektu. V nastaveniach upozornení môžete pridať ďalších e-mailových príjemcov.
Aktuálny postup nastavenia a informácie o vynucovaní limitov nájdete v sprievodcovi limitmi výdavkov.
Zobrazenie využívania a fakturácie
Údaje o využívaní možno rozdeliť podľa projektov. Pre jednotlivé projekty si môžete zobraziť fakturáciu a nastaviť limity výdavkov.
Prístup k panelu využívania projektu závisí od vašej roly v organizácii a od nastavení viditeľnosti panela využívania. Samotná rola vlastníka projektu vám prístup nezaručuje.
Ak nevidíte panel využívania projektu, skontrolujte, či je viditeľnosť nastavená na Viditeľné pre vlastníkov organizácie.
Správa úložiska súborov
Každý projekt má kvótu úložiska súborov 100 GB. Ak ju prekročíte, môže sa zobraziť táto chyba:
Prekročili ste kvótu úložiska súborov. Organizácie majú limit 100 GB súborov. Zmenšite veľkosť súboru alebo kontaktujte podporu.
Odstránením nepoužívaných súborov uvoľnite miesto v úložisku. Pomocou API si môžete vypísať zoznam uložených súborov a zistiť, ktoré už nepotrebujete.
Archivácia projektu
Vlastníci organizácie a projektu môžu archivovať projekty zo stránky Projekty alebo z nastavení konkrétneho projektu. Po zobrazení výzvy zadajte názov projektu na potvrdenie.
Archivácia je trvalá: archivovaný projekt nemožno obnoviť.
Ak chcete zobraziť archivované projekty, otvorte kartu Archivované na stránke Projekty.
Jedinou výnimkou je, že jemné doladenia v „Predvolenom projekte“ sú prístupné z iných projektov.
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.Projekty nemožno odstrániť. OpenAI uchováva ich históriu na sledovanie využívania a fakturácie.