OpenAI
Táto stránka bola strojovo preložená. Prečítaj si pôvodný článok v angličtine.

Správa projektov na platforme API

Aktualizované: 9 days ago

Cieľom projektov je poskytnúť zákazníkom možnosť 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či obmedzenému 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 si môžu zobrazovať fakturáciu a nastavovať rozpočty pre jednotlivé projekty.

Vlastníci organizácie si môžu zobraziť všetky svoje aktívne a archivované projekty na stránke Projekty. Prečítajte si viac o rolách používateľov a povoleniach v platforme API.

Image

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:

Projects page with the organization switcher open, listing Personal and Staging organizations

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í.

Image

Ako fungujú projekty?

Každá organizácia obsahuje „Predvolený projekt“, ktorý nemožno odstrániť. Môžete nakonfigurovať limity rýchlosti, oprávnenia virtuálneho modelu a rozpočty výdavkov (od novembra 2024). Dedi všetku 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.

API platform project menu with Create project highlighted under Default project

Zadajte názov, popis a webovú stránku projektu a potom vyberte Create.

Create a new project dialog in the API platform with fields for project name, use case, and business website

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é sú rôzne roly používateľov v organizáciách a projektoch a aké povolenia zahŕňajú?

Zatiaľ čo organizácie majú roly „vlastník“ a „čitateľ“, projekty majú roly „vlastník“ a „člen“. Členovia projektu zodpovedajú čitateľom organizácie. Podrobnejší opis povolení, ktoré patria ku každej používateľskej role, nájdete v tabuľke nižšie.

RolaRozsahOpis
VlastníkOrganizáciaMôž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 pomocou stránky Projekty. Môže nastavovať rozpočty organizácie a rozpočty projektov. Môže udeľovať povolenia na zobrazenie informácií o používaní iným používateľom v organizácii. Môže archivovať projekty.
ČitateľOrganizáciaMôže vykonávať inferenciu, používať zdroje a vytvárať kľúče vo svojich projektoch. Možno ho pridať do projektov.
Nemôže vytvárať projekty ani spravovať používateľov.
VlastníkProjektMôž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ť rozpočty projektu. Môže archivovať projekt.
ČlenProjektMôž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ť políčko „Pridať do predvoleného projektu“ nezačiarknuté). Tento zoznam nebude obsahovať servisné účty. V tomto kroku môžete vybrať, či bude ich rola Owner alebo Member:

Project members with Add team members dialog assigning a user the Member role

Keď pridáte člena tímu, musíte mu priradiť rolu Člen alebo Vlastník. Členovia projektu môžu odosielať požiadavky API, ktoré čítajú alebo upravujú údaje, zatiaľ čo vlastníci projektu môžu tiež upravovať nastavenia a rozpočty 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:

API platform project switcher open with options to create a project or manage projects

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é.

Project Members page with Create a service account dialog after selecting the Service account option

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ý.

Members page with Save your key modal after creating a service account

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:

OpenAI API Members settings with a service account role menu open for Reader or Owner

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.

API keys page for a project with the Create new secret key button highlighted

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:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • 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 rozpočty projektov mojej organizácie?

Rozpočty projektov 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 Limity, a prejdite nadol na Limity používania.

Project Limits page with organization budget controls, usage alerts, and model rate limits table

Ak chcete nastaviť limity projektu, v nastaveniach organizácie kliknite na projekt, ktorý chcete aktualizovať, a vyberte Limity. Môžete aktualizovať mesačný rozpočet, prah oznámenia a používanie modelov.

Nastavenie mesačného rozpočtu vám umožní určiť mäkké prahové hodnoty výdavkov pre váš projekt. Keď používanie prekročí tento limit v danom kalendárnom mesiaci (UTC), požiadavky API sa budú naďalej spracúvať bez prerušenia. Táto funkcia vám pomáha monitorovať používanie pomocou rozpočtových upozornení, ale nevynucuje pevný strop výdavkov. Keď sa vytvorí rozpočet projektu, predvolene sa vytvorí upozornenie pri prahu 100 %. Ďalšie rozpočty pri rôznych prahových hodnotách možno nastaviť kliknutím na Pridať upozornenie.

Upozorňujeme, že vlastník alebo vlastníci organizácie a vlastník alebo vlastníci projektu budú tieto správy dostávať vždy a toto nemožno prispôsobiť.

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

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.

API platform Projects page with the Archived tab selected to view archived projects

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

Project setting for Usage dashboard visibility with Visible to organization owners selected

Ak panel používania nevidíte, toto nastavenie je pravdepodobne nastavené na „Viditeľné pre vlastníkov organizácie“.

Bol tento článok užitočný?