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

Upravljanje projektima na API platformi

Ažurirano: 2 days ago

Svrha je projekata omogućiti korisnicima da organiziraju svoj rad. Organizacije mogu upravljati pristupom i ograničenjima, dodjeljivati račune usluge (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 prema projektu, a korisnici mogu pregledavati naplatu i postavljati ograničenja potrošnje za svaki projekt.

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

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, dopuštenja za virtualne modele i ograničenja potrošnje (od studenoga 2024.). Nasljeđuje cijelu konfiguraciju organizacije, pa mu ne možete izravno dodavati članove ni račune usluge.

Kako izraditi projekt?

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

API platform project menu with Create project highlighted under Default project

Unesite naziv, opis i web-mjesto projekta, a zatim odaberite Izradi.

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 pri slanju pozivnice za organizaciju (odabirom potvrdnog okvira „Pozovi u zadani projekt”) ili nakon što prihvate pozivnicu za organizaciju.

Na korisnike pozvane putem administratorskog API-ja primjenjuju se pravila navedena za krajnju točku /organization/invites.

Ako se pri pozivanju korisnika u projekt putem korisničkog sučelja ili administratorskog API-ja pojavi pogreška, prije ponovnog slanja pozivnice provjerite postoji li ciljni projekt i je li arhiviran.

Vlasnici organizacije automatski se dodaju kao vlasnici novih projekata izrađenih 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 usporedivi su s čitateljima organizacije. Detaljniji opis dopuštenja koja pripadaju svakoj korisničkoj ulozi potražite u tablici u nastavku.

UlogaOpsegOpis
VlasnikOrganizacijaMože izrađivati/prikazivati sve projekte, sve korisnike i sve API ključeve. Može pratiti sve projekte unutar organizacije na

stranici Projekti
. Može postavljati ograničenja potrošnje za organizaciju i ograničenja potrošnje za projekt. Može drugima u organizaciji dodijeliti dopuštenja za prikaz informacija o upotrebi. Može arhivirati projekte.
ČitateljOrganizacijaMože provoditi inferenciju, upotrebljavati resurse i izrađivati 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 te ima sve mogućnosti člana. Može postavljati ograničenja potrošnje za projekt. Može arhivirati projekt.
ČlanProjektMože provoditi inferenciju, upotrebljavati resurse i izrađivati ključeve na razini projekta.

Čemu mogu pristupiti ako nisam vlasnik organizacije?

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

  • Samo članovi projekta (i vlasnici organizacije) mogu vidjeti fino podešene modele izrađene u tom projektu, niti iz izrađenih Asistenata te dodane datoteke.

  • Članovi projekta mogu vidjeti sve ostale članove tog projekta i njihove uloge (npr. Vlasnik ili Član).

Kako promijeniti ulogu korisnika u projektu ili ukloniti korisnika iz projekta?

Samo vlasnik projekta može promijeniti ulogu korisnika u projektu ili ukloniti korisnika iz projekta. Više informacija potražite u odjeljku Uloge i dopuštenja.

Da biste ažurirali korisnika u projektu, otvorite postavke organizacije, odaberite projekt i kliknite Članovi. Svakom članu možete dodijeliti ulogu Član ili Vlasnik. Možete odabrati i Ukloni kako 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

Kada kliknete gumb + Dodaj člana, prikazat će se popis korisnika u vašoj organizaciji s ulogom Čitatelj. 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 mu ne želite omogućiti širi pristup). Ovaj popis ne uključuje račune servisa. U ovom koraku možete odabrati ulogu Vlasnik ili Član:

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

Kada dodajete člana tima, morate mu dodijeliti ulogu Član ili Vlasnik. Članovi projekta mogu slati API zahtjeve koji čitaju ili mijenjaju podatke, dok vlasnici projekta mogu mijenjati i postavke projekta te ograničenja potrošnje i upravljati članovima projekta. Više informacija potražite u odjeljku Uloge i dopuštenja.

Kako izraditi račun servisa za projekt

Najprije na padajućem izborniku na navigacijskoj traci odaberite projekt za koji želite izraditi račun servisa:

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

Zatim otvorite postavke organizacije -> Projekt -> Članovi -> i kliknite + Račun servisa:

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 računa servisa

Nakon što odaberete gumb Izradi, odmah će se izraditi API ključ za račun servisa i prikazati tajni ključ. Spremite tajni ključ na sigurno mjesto. Iz sigurnosnih razloga nećete ga moći ponovno vidjeti putem svojeg OpenAI računa. Ako izgubite tajni ključ, morat ćete izraditi novi.

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

API ključ računa servisa prema zadanim postavkama ima dopuštenja za čitanje i pisanje za sve API resurse projekta. Ta dopuštenja možete promijeniti u postavkama API ključeva projekta.

Računi servisa navedeni su uz članove projekta na stranici s postavkama članova projekta. Više o promjeni ili uklanjanju pristupa računa servisa na stranici s postavkama članova projekta pročitajte ovdje.

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 izrađivati i njima upravljati na stranici s postavkama tog projekta. U postavkama organizacije odaberite projekt i kliknite API ključevi.

Da biste izradili novi tajni ključ, odaberite + Izradi novi tajni ključ. Možete odabrati i ikonu Uredi pored tajnog ključa kako biste uredili njegova dopuštenja.

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

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

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

  • Sve — Tajnom ključu dodjeljuju se sva dopuštenja. To je zadana postavka.

  • Ograničeno — Omogućuje korisniku da za svaku krajnju točku postavi dopuštenje Bez pristupa, Čitanje ili Pisanje.

  • Primjerice, možete izraditi API ključ koji nema dopuštenje za čitanje ni pisanje na krajnjoj točki /v1/assistants:

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

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 ograničenja potrošnje za projekte svoje organizacije i upravljati njima?

Samo vlasnici organizacije i vlasnici projekta mogu postavljati ograničenja potrošnje projekta i upravljati njima. Više informacija potražite u odjeljku Uloge i dopuštenja. Da biste promijenili ograničenja na razini organizacije, u postavkama organizacije kliknite Ograničenja i pomaknite se do odjeljka 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čno ograničenje potrošnje, Prag za obavijesti i Upotrebu modela.

Postavljanjem mjesečnog ograničenja potrošnje možete odrediti neobvezujuće pragove potrošnje za svoj projekt. Kada upotreba premaši to ograničenje tijekom određenog kalendarskog mjeseca (UTC), obrada API zahtjeva nastavit će se bez prekida. Ova značajka olakšava praćenje upotrebe putem upozorenja o ograničenju potrošnje, ali ne nameće strogu gornju granicu potrošnje. Pri izradi ograničenja potrošnje projekta automatski se stvara upozorenje za prag od 100 %. Dodatna upozorenja za različite pragove možete postaviti klikom na Dodaj upozorenje.

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

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

Kako postaviti ograničenja potrošnje za svoju organizaciju ili projekt?

OpenAI sada podržava mjesečna ograničenja potrošnje za API na razini organizacije i projekta. Ograničenje potrošnje može pratiti potrošnju bez provođenja ograničenja, a možete ga provoditi i kao strogo ograničenje tako da API zahtjevi ne uspiju nakon što potrošnja dosegne ograničenje. Najnovije korake konfiguracije i ponašanje potražite u odjeljku Ograničenja potrošnje u dokumentaciji za razvojne programere.

Kako izbrisati ili arhivirati projekt?

Projekte možete arhivirati na novoj stranici s popisom projekata ili u postavkama pojedinačnog projekta. Arhivirani projekt nije moguće vratiti. Kada pokrenete arhiviranje, morat ćete unijeti naziv projekta da biste nastavili.

Popis svih arhiviranih projekata možete pregledati na kartici „Arhivirano” na istoj stranici s popisom projekata.

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

Projekte nije moguće izbrisati. Č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 za pohranu datoteka od 100 GB po projektu.
Ako prekoračite tu kvotu, prikazat će se sljedeća pogreška:

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 vidim nadzornu ploču upotrebe svojeg projekta?

Vidljivost nadzorne ploče upotrebe projekta nije povezana s ulogom korisnika u projektu. Određuju je vaša uloga u organizaciji i postavke na stranici https://platform.openai.com/settings/organization/data-controls/visibility.

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

Ako ne vidite nadzornu ploču upotrebe, ta je postavka vjerojatno postavljena na „Vidljivo vlasnicima organizacije”.

Je li vam ovaj članak bio koristan?