Namen projektov je strankam omogočiti organizacijo dela. Organizacije lahko upravljajo dostop in omejitve, zagotavljajo storitvene račune (prek uporabniškega vmesnika) ter spremljajo uporabo znotraj omejenega obsega projekta (npr. modeli, zmožnosti, niti, pomočniki, fino nastavljanje, shramba itd.). Dejavnost uporabe je mogoče razčleniti po projektih, uporabniki pa si lahko ogledajo obračunavanje in nastavijo omejitve porabe za posamezen projekt.
Lastniki organizacije si lahko vse svoje aktivne in arhivirane projekte ogledajo na strani Projekti. Več o uporabniških vlogah in dovoljenjih v Platformi API.
Kdo lahko ustvari projekt?
Projekt lahko ustvarijo samo lastniki organizacije. Za več informacij glejte vloge in dovoljenja.
Če želite preklopiti med organizacijami, premaknite kazalec nad ime organizacije v zgornjem levem kotu strani in izberite organizacijo s seznama:
Pri organizacijah z združenim obračunavanjem so podorganizacije označene ločeno. V podorganizacijah ni mogoče ustvarjati projektov.
Kako delujejo projekti?
Vsaka organizacija vključuje »Privzeti projekt«, ki ga ni mogoče izbrisati. Nastavite lahko omejitve hitrosti, dovoljenja za navidezne modele in omejitve porabe (od novembra 2024). Podeduje celotno konfiguracijo organizacije, zato vanj ne morete neposredno dodajati članov ali računov storitev.
Kako ustvarim projekt?
Najprej premaknite kazalec nad ime projekta v levem kotu strani in izberite Ustvari projekt.
Vnesite ime, opis in spletno mesto projekta ter izberite Ustvari.
Kako dodam uporabnike v projekt?
Novo dodani člani organizacije niso samodejno dodani v »Privzeti projekt«. Nove člane lahko v projekt povabite ob povabilu v organizacijo (tako da označite potrditveno polje »Povabi v privzeti projekt«) ali potem, ko sprejmejo povabilo v organizacijo.
Za uporabnike, povabljene prek skrbniškega API-ja, veljajo pravila, navedena za končno točko /organization/invites.
Če pri povabilu uporabnikov v projekt prek uporabniškega vmesnika ali skrbniškega API-ja pride do napake, pred ponovnim pošiljanjem povabila najprej preverite, ali ciljni projekt obstaja in ni arhiviran.
Lastniki organizacije so kot lastniki samodejno dodani v nove projekte, ustvarjene v organizaciji.
Katere uporabniške vloge obstajajo v organizacijah in projektih ter katera dovoljenja vključujejo?
Medtem ko imajo organizacije vlogi »lastnik« in »bralec«, imajo projekti vlogi »lastnik« in »član«. Člani projekta so primerljivi z bralci organizacije. Podrobnejši opis dovoljenj posamezne uporabniške vloge je v spodnji tabeli.
| Vloga | Obseg | Opis |
|---|---|---|
| Lastnik | Organizacija | Lahko ustvarja in si ogleduje vse projekte, vse uporabnike in vse ključe API. Prek strani Projekti lahko spremlja vse projekte v organizaciji. Lahko nastavlja omejitve porabe organizacije in projektov. Drugim v organizaciji lahko dodeli dovoljenje za ogled podatkov o uporabi. Lahko arhivira projekte. |
| Bralec | Organizacija | V svojih projektih lahko izvaja sklepanje, uporablja vire in ustvarja ključe. Lahko je dodan v projekte. Ne more ustvarjati projektov ali upravljati uporabnikov. |
| Lastnik | Projekt | V projekt lahko dodaja druge uporabnike in ga preimenuje, poleg tega pa ima vse zmožnosti člana. Lahko nastavlja omejitve porabe projekta. Lahko arhivira projekt. |
| Član | Projekt | Na ravni projekta lahko izvaja sklepanje, uporablja vire in ustvarja ključe. |
Do česa imam dostop, če nisem lastnik organizacije?
Uporabniki, ki niso lastniki organizacije, lahko vidijo samo projekte, katerih člani so. Samo lastnik organizacije lahko vidi vse projekte, člane in ključe API na ravni projekta ter dostopa do strani Projekti.
Samo člani projekta (in lastniki organizacije) lahko vidijo prilagojene modele, ustvarjene v tem projektu, niti iz ustvarjenih Pomočnikov in vse dodane datoteke.
Člani projekta lahko vidijo vse druge člane tega projekta in njihove vloge (tj. Lastnik ali Član).
Kako posodobim uporabnikovo vlogo v projektu ali odstranim uporabnika iz projekta?
Uporabnikovo vlogo v projektu lahko posodobi ali uporabnika iz projekta odstrani samo lastnik projekta. Za več informacij glejte vloge in dovoljenja.
Če želite posodobiti uporabnika v projektu, odprite nastavitve organizacije, izberite projekt in kliknite Člani. Vsakemu članu lahko nastavite vlogo Član ali Lastnik. Izberete lahko tudi Odstrani, da uporabnika odstranite iz projekta.
Kaj je račun storitve in kako se razlikuje od običajnega uporabniškega računa?
Račun storitve deluje kot navidezni uporabnik, namenjen dostopu sistema, in se razlikuje od računov posameznih uporabnikov. Račune storitev lahko ustvarjajo samo lastniki organizacije in projekta.
Storitveni računi so omejeni samo na projekte.
Dodajanje člana v projekt
Če kliknete gumb + Dodaj člana, se prikaže seznam uporabnikov v vaši organizaciji z vlogo Bralec. Če želite dodati uporabnika, ki še ni v vaši organizaciji, ga morate najprej dodati v organizacijo (če mu ne želite omogočiti širšega dostopa, lahko potrditveno polje »Dodaj v privzeti projekt« pustite neoznačeno). Na tem seznamu ni računov storitev. V tem koraku mu lahko dodelite vlogo Lastnik ali Član:
Ko dodate člana ekipe, mu morate dodeliti vlogo Član ali Lastnik. Člani projekta lahko pošiljajo zahteve API, ki berejo ali spreminjajo podatke, lastniki projekta pa lahko poleg tega spreminjajo nastavitve in omejitve porabe projekta ter upravljajo njegove člane. Za več informacij glejte vloge in dovoljenja.
Kako ustvariti račun storitve za projekt
Najprej na spustnem seznamu v navigacijski vrstici izberite projekt, za katerega želite ustvariti račun storitve:
Nato odprite nastavitve organizacije -> Projekt -> Člani -> in kliknite + Račun storitve:
Storitveni računi, ustvarjeni na ravni projekta, so edinstveni za projekt in jih ni mogoče uporabljati zunaj projekta, v katerem so bili ustvarjeni.
Poimenovanje računa storitve
Ne glede na to, ali račun storitve ustvarite na ravni organizacije ali samo za posamezen projekt, lahko zanj ustvarite enoličen ID iz črk, številk in vezajev, da ga boste lažje prepoznali.
Shranjevanje ključa API računa storitve
Ko izberete gumb Ustvari, se za račun storitve takoj ustvari ključ API in prikaže skrivni ključ. Ta skrivni ključ shranite na varno mesto. Iz varnostnih razlogov si ga pozneje prek računa OpenAI ne boste mogli več ogledati. Če skrivni ključ izgubite, boste morali ustvariti novega.
Ključ API računa storitve ima privzeto dovoljenja za branje in pisanje vseh virov API projekta. Ta dovoljenja lahko posodobite v nastavitvah ključev API projekta.
Računi storitev so na strani z nastavitvami članov projekta navedeni skupaj s člani projekta. Če želite izvedeti več o posodabljanju ali odstranjevanju dostopa računa storitve na strani z nastavitvami članov projekta, glejte tukaj.
Vsi storitveni računi v projektih in organizacijah bodo prikazani skupaj z vašimi človeškimi uporabniki na strani članov na ravni organizacije.
Storitveni računi se upravljajo kot običajni računi. V meniju Organizacija -> Člani lahko storitveni račun odstranite ali posodobite njegovo vlogo:
Kako upravljam ključe API v projektih svoje organizacije?
Ključe API za posamezen projekt lahko ustvarjate in upravljate na strani z nastavitvami tega projekta. V nastavitvah organizacije izberite projekt in kliknite Ključi API.
Če želite ustvariti nov skrivni ključ, izberite + Ustvari nov skrivni ključ. Če želite urediti dovoljenja skrivnega ključa, lahko izberete tudi ikono za urejanje ob njem.
Dovoljenja za posamezen ključ API lahko nastavite ob ustvarjanju novega skrivnega ključa ali z urejanjem obstoječega.
Na voljo so tri ravni dovoljenj: Vsa, Omejeno in Samo za branje.
Vsa — Skrivnemu ključu so dodeljena vsa dovoljenja. To je privzeta nastavitev.
Omejeno — Uporabniku omogoča, da za vsako končno točko nastavi dovoljenja Brez, Branje in Pisanje.
Ustvarite lahko na primer ključ API, ki izrecno nima dovoljenja za branje iz končne točke /v1/assistants ali pisanje vanjo:
Samo za branje — Za vse končne točke so nastavljena dovoljenja za branje.
Kako se upravlja dostop uporabnikov, ki pripadajo več projektom ali organizacijam?
Uporabniki so lahko člani poljubnega števila projektov. V projektu lahko uporabniki ustvarijo osebni ključ API, katerega obseg in dostop sta omejena na ta projekt in njegove vire.
Kako nastavim in upravljam omejitve hitrosti za projekte svoje organizacije?
Omejitve hitrosti na ravni projekta lahko nastavlja in upravlja samo lastnik organizacije. Za več informacij glejte vloge in dovoljenja.
V nastavitvah organizacije kliknite projekt, ki ga želite posodobiti, in v razdelku Projekt na navigacijskem seznamu izberite Omejitve. Na tej strani lahko posodobite Uporabo modelov.
Uporaba modelov omogoča določitev modelov, ki jih lahko uporablja projekt, po potrebi pa lahko za vsak model nastavite tudi omejitve hitrosti.
Kako nastavim in upravljam omejitve porabe za projekte svoje organizacije?
Omejitve porabe projekta lahko nastavljajo in upravljajo samo lastniki organizacije in projekta. Za več informacij glejte vloge in dovoljenja. Če želite spremeniti omejitve na ravni organizacije, v nastavitvah organizacije kliknite Omejitve, nato pa se pomaknite do razdelka Omejitve uporabe.
Če želite nastaviti omejitve projekta, v nastavitvah organizacije kliknite projekt, ki ga želite posodobiti, in izberite Omejitve. Posodobite lahko Mesečno omejitev porabe, Prag za obvestila in Uporabo modelov.
Z nastavitvijo mesečne omejitve porabe lahko določite okvirne pragove porabe za projekt. Če uporaba v posameznem koledarskem mesecu (UTC) preseže to omejitev, se bodo zahteve API še naprej obdelovale brez prekinitve. Ta funkcija je namenjena spremljanju uporabe z opozorili o omejitvi porabe, vendar ne uveljavlja stroge zgornje meje porabe. Ko ustvarite omejitev porabe projekta, se privzeto ustvari opozorilo pri 100-odstotnem pragu. Dodatna opozorila pri različnih pragovih lahko nastavite tako, da kliknete Dodaj opozorilo.
Upoštevajte, da bodo ta sporočila vedno prejemali lastniki organizacije in projekta, česar ni mogoče prilagoditi.
Kako nastavim omejitve porabe za svojo organizacijo ali projekt?
OpenAI zdaj podpira mesečne omejitve porabe API na ravni organizacije in projekta. Omejitev porabe lahko porabo samo spremlja brez uveljavljanja ali pa jo uveljavite kot strogo omejitev, tako da zahteve API po doseženi omejitvi ne uspejo. Za najnovejša navodila za konfiguracijo in opis delovanja glejte Omejitve porabe v dokumentaciji za razvijalce.
Kako izbrišem ali arhiviram projekt?
Projekte lahko arhivirate na novi strani s seznamom projektov ali v nastavitvah posameznega projekta. Ko je projekt arhiviran, ga ni mogoče obnoviti. Ko začnete arhiviranje, boste morali za nadaljevanje vnesti ime projekta.
Seznam vseh arhiviranih projektov si lahko ogledate na zavihku »Arhivirano« na isti strani s seznamom projektov.
Projektov ni mogoče izbrisati. Zgodovino vseh projektov hranimo, da zagotovimo neprekinjeno spremljanje uporabe in obračunavanja.
Ali je število projektov v organizaciji omejeno?
Organizacije lahko privzeto ustvarijo do 2.000 projektov.
Ali je mogoče vire deliti med projekti?
Viri projekta (kot so datoteke, pomočniki, prostor za shranjevanje ali niti) so omejeni na projekt, člani brez skrbniških pravic zunaj projekta pa do njih ne morejo dostopati. Poleg tega virov ni mogoče premikati med projekti.
Edina izjema je, da je mogoče fino prilagojene modele v "Privzetem projektu" uporabljati iz drugih projektov.
Kolikšna je omejitev prostora za shranjevanje datotek na projekt?
OpenAI trenutno podpira omejitev 100 GB prostora za shranjevanje datotek na projekt.
Če presežete to omejitev, se prikaže naslednja napaka:
Presegli ste kvoto za shranjevanje datotek. Organizacije so omejene na 100 GB datotek. Zmanjšajte velikost datotek ali se obrnite na podporo.Priporočamo, da izbrišete neuporabljene datoteke, shranjene v vašem računu. Za referenco si lahko datoteke ogledate in jih navedete z API-jem.
Sem lastnik projekta. Zakaj ne vidim nadzorne plošče uporabe za svoj projekt?
Vidnost nadzorne plošče uporabe projekta ni povezana z uporabnikovo vlogo v projektu. Določata jo vaša vloga v organizaciji in nastavitve na strani https://platform.openai.com/settings/organization/data-controls/visibility
Če nadzorne plošče uporabe ne vidite, je ta nastavitev verjetno nastavljena na »Vidno lastnikom organizacije«.