OpenAI
Ova je stranica strojno prevedena. Pogledajte izvorni članak na engleskom jeziku.

Upravljanje projektima na API platformi

Ažurirano: 21 hours ago

Cilj je projekata omogućiti korisnicima organiziranje rada. Organizacije mogu upravljati pristupom i ograničenjima, omogućavati servisne račune (putem korisničkog sučelja) i pratiti upotrebu u odnosu na ograničeni opseg unutar projekta (npr. modeli, mogućnosti, niti, asistenti, fino podešavanje, pohrana itd.). Aktivnost upotrebe može se raščlaniti po projektu, a korisnici mogu pregledavati naplatu i postavljati proračune po projektu.

Vlasnici organizacije mogu vidjeti sve svoje aktivne i arhivirane projekte na stranici Projekti. Saznajte više o korisničkim ulogama i dopuštenjima na API Platformi.

Image

Tko može izraditi projekt?

Samo vlasnici organizacije mogu izraditi projekt. Za više informacija pogledajte uloge i dopuštenja.

Da biste se prebacivali između organizacija, zadržite pokazivač iznad naziva svoje organizacije u gornjem lijevom dijelu stranice i odaberite organizaciju s popisa:

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

Za organizacije koje su na objedinjenom planu naplate podorganizacije se identificiraju zasebno. Projekti se ne mogu izrađivati unutar podorganizacija.

Image

Kako projekti funkcioniraju?

Svaka organizacija uključuje „Zadani projekt” koji se ne može izbrisati. Možete konfigurirati ograničenja brzine, dozvole virtualnog modela i proračune potrošnje (od studenoga 2024.). Nasljeđuje punu konfiguraciju organizacije, pa mu ne možete izravno dodavati članove ni servisne račune.

Kako mogu stvoriti projekt?

Najprije zadržite pokazivač iznad naziva projekta u lijevom kutu stranice i odaberite Create project.

API platform project menu with Create project highlighted under Default project

Navedite naziv, opis i web-mjesto za svoj projekt, a zatim odaberite Create.

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

Kako dodati korisnike u projekt?

Novododani članovi organizacije ne dodaju se automatski u „Zadani projekt”. Nove članove možete pozvati u projekt prilikom njihova pozivanja u organizaciju (omogućivanjem potvrdnog okvira „Pozovi u zadani projekt”) ili nakon što član prihvati pozivnicu za organizaciju.

Korisnici pozvani putem Admin API-ja slijede pravila navedena za krajnju točku /organization/invites.

Ako naiđete na pogrešku pri pozivanju korisnika u projekt putem korisničkog sučelja ili Admin API-ja, najprije potvrdite da ciljni projekt postoji i da nije arhiviran prije ponovnog slanja pozivnice.

Vlasnici organizacije automatski se dodaju kao vlasnici u nove projekte stvorene unutar organizacije.

Koje su različite korisničke uloge u organizacijama i projektima te koja dopuštenja uključuju?

Dok organizacije imaju uloge „vlasnik” i „čitatelj”, projekti imaju uloge „vlasnik” i „član”. Članovi projekta analogni su čitateljima organizacije. Pogledajte tablicu u nastavku za detaljniji opis dopuštenja koja prate svaku korisničku ulogu.

UlogaOpsegOpis
VlasnikOrganizacijaMože izraditi/pregledati sve projekte, sve korisnike i sve API ključeve. Ima mogućnost nadzora svih projekata unutar organizacije putem

stranice Projekti
. Može postavljati proračune organizacije i proračune projekta. Može drugima u organizaciji dodijeliti dopuštenja za prikaz informacija o upotrebi. Može arhivirati projekte.
ČitateljOrganizacijaMože izvoditi inferenciju, koristiti resurse i stvarati ključeve u svojim projektima. Može se dodati u projekte.
Ne može izrađivati projekte ni upravljati korisnicima.
VlasnikProjektMože dodavati druge korisnike u projekt i preimenovati projekt, kao i sve što može član. Može postavljati proračune projekta. Može arhivirati projekt.
ČlanProjektMože izvoditi inferenciju, koristiti resurse i stvarati ključeve na razini projekta.

Ako nisam vlasnik u organizaciji, čemu imam pristup?

Korisnici koji nisu vlasnici u organizaciji mogu vidjeti samo projekte kojih su članovi. Samo vlasnik organizacije može vidjeti sve projekte, članove i API ključeve na razini projekta te imati pristup stranici Projekti.

  • Samo članovi projekta (i vlasnici organizacije) mogu vidjeti fino podešene modele stvorene unutar tog projekta, niti iz bilo kojih stvorenih Asistenata ili bilo koje dodane datoteke.

  • Članovi projekta mogu vidjeti tko su svi ostali članovi tog projekta i koje su njihove uloge (tj. vlasnik ili član).

Kako ažurirati ulogu korisnika u projektu ili ukloniti korisnika iz projekta?

Samo vlasnik projekta može ažurirati ulogu korisnika u projektu ili ukloniti korisnika iz projekta. Za više informacija pogledajte uloge i dopuštenja.

Da biste ažurirali korisnika u projektu, idite u postavke organizacije, odaberite projekt i kliknite Članovi. Imate mogućnost postaviti ulogu svakog člana kao član ili vlasnik. Također možete odabrati Ukloni da biste uklonili korisnika iz projekta.

Što je servisni račun i po čemu se razlikuje od običnog korisničkog računa?

Servisni račun djeluje kao pseudo-korisnik namijenjen pristupu sustavu, odvojen od pojedinačnih korisničkih računa. Samo vlasnici organizacije i projekta mogu stvarati servisne račune.

Servisni računi ograničeni su samo na projekte.

Dodavanje člana u projekt

Ako kliknete gumb + Add member, vidjet ćete popis korisnika u svojoj organizaciji s ulogom Reader. Ako želite dodati korisnika koji trenutačno nije u vašoj organizaciji, najprije ga morate dodati u organizaciju (potvrdni okvir „Dodaj u zadani projekt” možete ostaviti neoznačenim ako tim korisnicima ne želite dati širi pristup). Ovaj popis neće uključivati servisne račune. U ovom koraku možete odabrati hoće li njihova uloga biti Owner ili Member:

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

Kada dodajete člana tima, morate mu dodijeliti ulogu člana ili vlasnika. Članovi projekta mogu slati API zahtjeve koji čitaju ili mijenjaju podatke, dok vlasnici projekta mogu i mijenjati postavke projekta i proračune projekta te upravljati članovima projekta. Za više informacija pogledajte uloge i dopuštenja.

Kako izraditi servisni račun za projekt

Najprije idite na projekt za koji želite izraditi servisni račun odabirom iz padajućeg izbornika na navigacijskoj traci:

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

Zatim idite u postavke organizacije -> Projekt -> Članovi -> kliknite + Service account:

Servisni računi stvoreni na razini projekta jedinstveni su za projekt i ne mogu se koristiti izvan projekta u kojem su stvoreni.

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

Imenovanje servisnog računa

Bez obzira na to stvarate li servisni račun na razini organizacije ili jedinstveni račun za projekt, pri stvaranju servisnog računa možete izraditi jedinstveni ID servisnog računa koji se sastoji od slova, brojeva i crtica kako biste ga lakše prepoznali.

Spremanje API ključa servisnog računa

Nakon odabira gumba Izradi, API ključ odmah se izrađuje za servisni račun i prikazat će se tajni ključ. Spremite ovaj tajni ključ na sigurno i zaštićeno mjesto. Iz sigurnosnih razloga nećete ga moći ponovno vidjeti putem svojeg OpenAI računa. Ako izgubite ovaj tajni ključ, morat ćete generirati novi.

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

Dopuštenja API ključa servisnog računa prema zadanim postavkama omogućuju čitanje i pisanje svih API resursa projekta. Ta se dopuštenja mogu ažurirati u postavkama API ključeva vašeg projekta.

Servisni računi navedeni su uz članove projekta na stranici postavki članova vašeg projekta. Pogledajte ovdje da biste saznali više o ažuriranju ili uklanjanju pristupa servisnog računa na stranici postavki članova vašeg projekta.

Svi servisni računi u projektima i organizacijama prikazat će se uz vaše ljudske korisnike na stranici članova na razini organizacije.

Servisnim računima upravlja se kao običnim računima. Iz izbornika Organizacija -> Članovi možete ukloniti servisni račun ili ažurirati ulogu:

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

Kako upravljati API ključevima u projektima svoje organizacije?

API ključeve za svaki projekt možete izraditi i njima upravljati na stranici postavki tog projekta. U postavkama organizacije odaberite projekt i kliknite API ključevi.

Da biste izradili novi tajni ključ, odaberite + Create new secret key. Možete odabrati i ikonu Uredi pokraj tajnog ključa da biste uredili njegova dopuštenja.

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

Dopuštenja za svaki od svojih API ključeva možete postaviti pri izradi novog tajnog ključa ili uređivanjem postojećeg ključa.

Dostupne su tri razine dopuštenja: Sva, Ograničena i Samo za čitanje.

  • Sva — Za tajni ključ postavljaju se puna dopuštenja. To je zadana postavka.

  • Ograničena — Omogućuje korisniku postavljanje dopuštenja Nema, Čitanje i Pisanje za svaku krajnju točku.

    • Na primjer, izradite API ključ koji izričito nema dopuštenje za čitanje ili pisanje u krajnju točku /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Samo za čitanje — Dopuštenja za čitanje postavljaju se za sve krajnje točke.

Kako se upravlja pristupom za korisnike koji pripadaju više projekata ili organizacija?

Korisnici mogu biti članovi onoliko projekata koliko je potrebno. Unutar projekta korisnici mogu generirati osobni API ključ koji je ograničen na pristup tom projektu i njegovim resursima.

Kako postaviti ograničenja broja zahtjeva i upravljati njima za projekte svoje organizacije?

Samo vlasnik organizacije može postavljati ograničenja broja zahtjeva na razini projekta i upravljati njima. Za više informacija pogledajte uloge i dopuštenja.

U postavkama organizacije kliknite projekt koji želite ažurirati i odaberite Ograničenja u odjeljku Projekt navigacijskog popisa. Na ovoj stranici možete ažurirati upotrebu modela.

Upotreba modela omogućuje vam da konfigurirate koji se modeli mogu koristiti u projektu, a ograničenja broja zahtjeva mogu se postaviti za svaki model prema potrebi.

Kako postaviti i upravljati proračunima za projekte svoje organizacije?

Samo vlasnici organizacije i vlasnici projekta mogu postavljati proračune projekta i upravljati njima. Za više informacija pogledajte uloge i dopuštenja. Da biste promijenili ograničenja na razini organizacije, u postavkama organizacije kliknite Ograničenja, a zatim se pomaknite do Ograničenja upotrebe.

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

Da biste postavili ograničenja projekta, u postavkama organizacije kliknite projekt koji želite ažurirati i odaberite Ograničenja. Možete ažurirati mjesečni proračun, prag obavijesti i upotrebu modela.

Postavljanje mjesečnog proračuna omogućuje vam da odredite meke pragove potrošnje za svoj projekt. Kada upotreba premaši ovo ograničenje unutar određenog kalendarskog mjeseca (UTC), API zahtjevi nastavit će se obrađivati bez prekida. Ova je značajka osmišljena kako bi vam pomogla pratiti upotrebu putem upozorenja o proračunu, ali ne nameće strogo ograničenje potrošnje. Kada se izradi proračun projekta, prema zadanim postavkama izradit će se upozorenje na pragu od 100 %. Dodatni proračuni na različitim pragovima mogu se postaviti klikom na Dodaj upozorenje.

Imajte na umu da će vlasnici organizacije i vlasnici projekta uvijek primati te poruke i to se ne može prilagoditi.

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

Kako izbrisati ili arhivirati projekt?

Projekti se mogu arhivirati putem nove stranice popisa projekata ili u postavkama pojedinačnog projekta. Nakon što se projekt arhivira, ne može se vratiti. Pri nastavku arhiviranja od vas će se zatražiti da unesete naziv projekta kako biste nastavili.

Popis svih arhiviranih projekata možete vidjeti na kartici „Arhivirano” na istoj stranici popisa projekata.

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

Brisanje projekata nije moguće; čuvamo povijest svih projekata kako bismo osigurali kontinuitet praćenja upotrebe i naplate.

Postoji li ograničenje broja projekata koje mogu imati u svojoj organizaciji?

Organizacije prema zadanim postavkama mogu stvoriti do 2.000 projekata.

Mogu li se resursi dijeliti između projekata?

Resursi projekta (kao što su datoteke, asistenti, pohrana ili niti) ograničeni su na projekt i članovi koji nisu administratori izvan projekta ne mogu im pristupiti. Nadalje, resursi se ne mogu premještati između projekata.

Jedina iznimka je to što se fino podešeni modeli u "Zadanom projektu" mogu koristiti iz drugih projekata.

Kolika je kvota za pohranu datoteka po projektu?

OpenAI trenutačno podržava kvotu pohrane od 100 GB datoteka po projektu.

Ako se ta kvota prekorači, vidjet ćete sljedeću pogrešku:

Premašili ste kvotu za pohranu datoteka. Organizacije su ograničene na 100 GB datoteka. Smanjite veličinu datoteka ili kontaktirajte podršku.

Preporučujemo da izbrišete nekorištene datoteke pohranjene na svojem računu. Za referencu, putem API-ja možete pregledavati i popisivati datoteke.

Vlasnik sam projekta, zašto ne mogu vidjeti nadzornu ploču upotrebe za svoj projekt?

Vidljivost nadzorne ploče upotrebe projekta nije povezana s ulogom korisnika unutar projekta. Umjesto toga, određuje je vaša uloga unutar organizacije i postavke na https://platform.openai.com/settings/organization/data-controls/visibility

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

Ako ne možete vidjeti nadzornu ploču upotrebe, ova je postavka vjerojatno postavljena na „Vidljivo vlasnicima organizacije”.

Je li vam ovaj članak bio koristan?