OpenAI
Ta stran je bila strojno prevedena. Oglejte si izvirni članek v angleščini.

Upravljanje projektov na platformi API

Posodobljeno: 8 days ago

Namen projektov je strankam omogočiti organiziranje njihovega dela. Organizacije lahko upravljajo dostop in omejitve, zagotavljajo storitvene račune (prek uporabniškega vmesnika) ter spremljajo uporabo glede na omejen obseg znotraj projekta (npr. modeli, zmožnosti, niti, asistenti, fino prilagajanje, shramba itd.). Dejavnost uporabe je mogoče razčleniti po projektih, uporabniki pa si lahko ogledajo obračunavanje in nastavijo proračune za posamezen projekt.

Lastniki organizacije si lahko ogledajo vse svoje aktivne in arhivirane projekte na strani Projekti. Preberite več o uporabniških vlogah in dovoljenjih v platformi API.

Image

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 svoje organizacije v zgornjem levem delu strani in izberite organizacijo s seznama:

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

Pri organizacijah, ki uporabljajo konsolidiran obračunski načrt, so podorganizacije označene ločeno. Projektov ni mogoče ustvariti znotraj podorganizacij.

Image

Kako delujejo projekti?

Vsaka organizacija vključuje »Privzeti projekt«, ki ga ni mogoče izbrisati. Konfigurirate lahko omejitve hitrosti, dovoljenja za virtualne modele in proračune porabe (od novembra 2024). Podeduje celotno konfiguracijo organizacije, zato vanj ne morete neposredno dodajati članov ali storitvenih računov.

Kako ustvarim projekt?

Najprej premaknite kazalec na ime projekta v levem kotu strani in izberite Create project.

API platform project menu with Create project highlighted under Default project

Vnesite ime, opis in spletno mesto za svoj projekt, nato pa izberite Create.

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

Kako dodam uporabnike v projekt?

Novo dodani člani organizacije niso samodejno dodani v »Privzeti projekt«. Nove člane lahko povabite v projekt ob povabilu v organizacijo (tako da omogočite potrditveno polje »Povabi v privzeti projekt«) ali po tem, ko član sprejme povabilo v organizacijo.

Za uporabnike, povabljene prek skrbniškega API-ja, veljajo pravila, opisana v končni točki /organization/invites.

Če pri vabljenju uporabnikov v projekt prek uporabniškega vmesnika ali skrbniškega API-ja naletite na napako, pred ponovnim pošiljanjem povabila najprej preverite, da ciljni projekt obstaja in ni arhiviran.

Lastniki organizacije so samodejno dodani kot lastniki v nove projekte, ustvarjene znotraj organizacije.

Katere so različne uporabniške vloge 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. Za podrobnejši opis dovoljenj, ki pripadajo posamezni uporabniški vlogi, glejte spodnjo tabelo.

VlogaObsegOpis
LastnikOrganizacijaLahko ustvari/ogleda vse projekte, vse uporabnike in vse ključe API. Ima možnost spremljanja vseh projektov v organizaciji na

strani Projekti
. Lahko nastavlja proračune organizacije in proračune projektov. Lahko dodeli dovoljenja za ogled informacij o uporabi drugim v organizaciji. Lahko arhivira projekte.
BralecOrganizacijaLahko izvaja sklepanje, uporablja vire in ustvarja ključe v svojih projektih. Lahko je dodan v projekte.
Ne more ustvarjati projektov in upravljati uporabnikov.
LastnikProjektLahko doda druge uporabnike v projekt in preimenuje projekt ter ima vse zmožnosti člana. Lahko nastavlja proračune projekta. Lahko arhivira projekt.
ČlanProjektLahko izvaja sklepanje, uporablja vire in ustvarja ključe na ravni projekta.

Če nisem lastnik v organizaciji, do česa imam dostop?

Uporabniki, ki niso lastniki v organizaciji, lahko vidijo samo projekte, katerih člani so. Samo lastnik organizacije lahko vidi vse projekte, člane in ključe API na ravni projekta ter ima dostop do strani Projekti.

  • Samo člani projekta (in lastniki organizacije) lahko vidijo fino prilagojene modele, ustvarjene znotraj tega projekta, niti iz ustvarjenih asistentov ali morebitne dodane datoteke.

  • Člani projekta lahko vidijo, kdo so vsi drugi člani tega projekta in kakšne so njihove vloge (tj. lastnik ali član).

Kako posodobim projektno vlogo uporabnika ali odstranim uporabnika iz projekta?

Samo lastnik projekta lahko posodobi projektno vlogo uporabnika ali odstrani uporabnika iz projekta. Za več informacij glejte vloge in dovoljenja.

Če želite posodobiti uporabnika v projektu, pojdite v nastavitve organizacije, izberite projekt in kliknite Člani. Vlogo vsakega člana lahko nastavite na Član ali Lastnik. Izberete lahko tudi Odstrani, da uporabnika odstranite iz projekta.

Kaj je storitveni račun in kako se razlikuje od običajnega uporabniškega računa?

Storitveni račun deluje kot navidezni uporabnik, zasnovan za sistemski dostop, in se razlikuje od posameznih uporabniških računov. Storitvene račune lahko ustvarijo samo lastniki organizacije in projekta.

Storitveni računi so omejeni samo na projekte.

Dodajanje člana v projekt

Če kliknete gumb + Add member, boste videli seznam uporabnikov v svoji organizaciji z vlogo Reader. Če želite dodati uporabnika, ki trenutno ni v vaši organizaciji, ga morate najprej dodati v organizacijo (potrditveno polje »Dodaj v privzeti projekt« lahko pustite nepotrjeno, če tem uporabnikom ne želite dati širšega dostopa). Ta seznam ne bo vključeval storitvenih računov. V tem koraku lahko izberete, ali bo njihova vloga Owner ali Member:

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

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 proračune projekta ter upravljajo člane projekta. Za več informacij glejte vloge in dovoljenja.

Kako ustvariti storitveni račun za projekt

Najprej se pomaknite do projekta, za katerega želite ustvariti storitveni račun, tako da izberete možnost v spustnem meniju v vrstici za krmarjenje:

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

Nato pojdite v nastavitve organizacije -> Projekt -> Člani -> kliknite + Service account:

Storitveni računi, ustvarjeni na ravni projekta, so edinstveni za projekt in jih ni mogoče uporabljati zunaj projekta, v katerem so bili ustvarjeni.

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

Poimenovanje storitvenega računa

Ne glede na to, ali storitveni račun ustvarite na ravni organizacije ali ustvarite takega, ki je edinstven za projekt, lahko ob ustvarjanju storitvenega računa ustvarite edinstven ID storitvenega računa, sestavljen iz črk, številk in vezajev, da storitveni račun lažje prepoznate.

Shranite ključ API storitvenega računa

Po izbiri gumba Ustvari se za storitveni račun takoj ustvari ključ API in prikaže se skrivni ključ. Ta skrivni ključ shranite na varno mesto. Zaradi varnostnih razlogov si ga prek svojega računa OpenAI ne boste mogli več ogledati. Če ta skrivni ključ izgubite, boste morali ustvariti novega.

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

Dovoljenja ključa API storitvenega računa so privzeto nastavljena na branje in pisanje vseh virov API projekta. Ta dovoljenja lahko posodobite v nastavitvah ključev API svojega projekta.

Storitveni računi so navedeni skupaj s člani projekta na strani z nastavitvami članov vašega projekta. Če želite izvedeti več o posodabljanju ali odstranjevanju dostopa storitvenega računa na strani z nastavitvami članov svojega 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:

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

Kako upravljam ključe API v projektih svoje organizacije?

Ključe API za vsak 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 + Create new secret key. Izberete lahko tudi ikono za urejanje poleg skrivnega ključa, da uredite njegova dovoljenja.

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

Dovoljenja za vsak ključ API lahko nastavite ob ustvarjanju novega skrivnega ključa ali z urejanjem obstoječega ključa.

Na voljo so tri ravni dovoljenj: Vsa, Omejeno in Samo za branje.

  • Vsa — Za skrivni ključ so nastavljena polna dovoljenja. To je privzeta nastavitev.

  • Omejeno — Uporabniku omogoča, da za vsako končno točko nastavi dovoljenja Brez, Branje in Pisanje.

    • Na primer, ustvarite ključ API, ki posebej nima dovoljenja za branje ali pisanje v končno točko /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Samo za branje — Dovoljenja za branje so nastavljena za vse končne točke.

Kako se upravlja dostop za uporabnike, ki pripadajo več projektom ali organizacijam?

Uporabniki so lahko člani toliko projektov, kot je potrebno. Znotraj projekta lahko uporabniki ustvarijo osebni ključ API, ki je omejen na dostop do tega projekta in njegovih virov.

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 navigacijskega seznama izberite Omejitve. Na tej strani lahko posodobite uporabo modelov.

Uporaba modelov vam omogoča, da konfigurirate, katere modele lahko uporablja projekt, za vsak model pa lahko po potrebi nastavite omejitve hitrosti.

Kako nastavim in upravljam proračune za projekte svoje organizacije?

Proračune projektov lahko nastavijo in upravljajo samo lastniki organizacije in lastniki projekta. Za več informacij glejte vloge in dovoljenja. Če želite spremeniti omejitve na ravni organizacije, v nastavitvah organizacije kliknite Omejitve, nato se pomaknite navzdol do Omejitve uporabe.

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

Če želite nastaviti omejitve projekta, v nastavitvah organizacije kliknite projekt, ki ga želite posodobiti, in izberite Omejitve. Posodobite lahko mesečni proračun, prag za obvestila in uporabo modelov.

Nastavitev mesečnega proračuna vam omogoča, da določite mehke pragove porabe za svoj projekt. Ko uporaba v danem koledarskem mesecu (UTC) preseže to omejitev, se bodo zahteve API še naprej obdelovale brez prekinitve. Ta funkcija je zasnovana tako, da vam pomaga spremljati uporabo prek proračunskih opozoril, vendar ne uveljavlja stroge zgornje meje porabe. Ko je proračun projekta ustvarjen, bo privzeto ustvarjeno opozorilo pri pragu 100 %. Dodatne proračune pri različnih pragovih lahko nastavite s klikom na Dodaj opozorilo.

Upoštevajte, da bodo lastniki organizacije in lastniki projekta vedno prejemali ta sporočila in tega ni mogoče prilagoditi.

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

Kako izbrišem ali arhiviram projekt?

Projekte je mogoče arhivirati na novi strani seznama projektov ali v nastavitvah posameznega projekta. Ko je projekt arhiviran, ga ni mogoče obnoviti. Ko nadaljujete z arhiviranjem, boste pozvani, da vnesete ime projekta za nadaljevanje.

Seznam vseh arhiviranih projektov si lahko ogledate na zavihku »Arhivirano« na isti strani seznama projektov.

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

Brisanje projektov ni mogoče; hranimo zgodovino vseh projektov, da zagotovimo neprekinjeno sledenje uporabi in obračunavanju.

Ali obstaja omejitev števila projektov, ki jih lahko imam v svoji organizaciji?

Organizacije lahko privzeto ustvarijo do 2.000 projektov.

Ali je mogoče vire deliti med projekti?

Viri projekta (kot so datoteke, pomočniki, shramba ali niti) so omejeni na projekt in do njih ne morejo dostopati neadminski člani zunaj projekta. 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.

Kakšna je kvota za shranjevanje datotek na projekt?

OpenAI trenutno podpira kvoto za shranjevanje datotek v višini 100 GB datotek na projekt.

Če je ta kvota presežena, boste videli naslednjo napako:

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 vlogo uporabnika znotraj projekta. Namesto tega jo določata vaša vloga znotraj organizacije in nastavitve na https://platform.openai.com/settings/organization/data-controls/visibility

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

Če nadzorne plošče uporabe ne vidite, je ta nastavitev verjetno nastavljena na »Vidno lastnikom organizacije«.

Ali vam je bil ta članek v pomoč?