OpenAI
Ova stranica je mašinski prevedena. Pogledaj originalni članak na engleskom jeziku.

Upravljanje projektima na API platformi

Ažurirano: 8 days ago

Projekti imaju za cilj omogućiti korisnicima da organizuju svoj rad. Organizacije mogu upravljati pristupom i ograničenjima, obezbijediti servisne naloge (putem korisničkog interfejsa) 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 pregledati naplatu i postaviti budžete po projektu.

Vlasnici organizacije mogu pregledati sve svoje aktivne i arhivirane projekte na stranici Projekti. Saznajte više o korisničkim ulogama i dozvolama na API platformi.

Image

Ko može kreirati projekat?

Samo vlasnici organizacije mogu kreirati projekat. Za više informacija pogledajte uloge i dozvole.

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

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

Za organizacije koje su na konsolidovanom planu naplate, podorganizacije se identifikuju zasebno. Projekti se ne mogu kreirati unutar podorganizacija.

Image

Kako projekti funkcioniraju?

Svaka organizacija uključuje „Podrazumijevani projekat“ koji se ne može izbrisati. Možete konfigurirati ograničenja brzine, dozvole virtualnog modela i budžete potrošnje (od novembra 2024). Nasljeđuje punu konfiguraciju organizacije, tako da mu ne možete direktno dodavati članove ni servisne naloge.

Kako da kreiram projekat?

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

API platform project menu with Create project highlighted under Default project

Unesite naziv, opis i web-stranicu za svoj projekat, a zatim odaberite Create.

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

Kako da dodam korisnike u projekat?

Novo dodani članovi organizacije ne dodaju se automatski u „Zadani projekat“. Novi članovi mogu biti pozvani u projekat ili kada se pozovu u organizaciju (omogućavanjem potvrdnog okvira „Pozovi u zadani projekat“) ili nakon što član prihvati pozivnicu za organizaciju.

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

Ako naiđete na grešku pri pozivanju korisnika u projekat putem korisničkog interfejsa ili Admin API-ja, prvo potvrdite da ciljni projekat postoji i da nije arhiviran prije ponovnog slanja pozivnice.

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

Koje su različite korisničke uloge unutar organizacija i projekata i koje dozvole one uključuju?

Dok organizacije imaju uloge „vlasnik“ i „čitalac“, projekti imaju uloge „vlasnik“ i „član“. Članovi projekta analogni su čitaocima organizacije. Pogledajte tabelu u nastavku za detaljniji opis dozvola koje prate svaku korisničku ulogu.

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

stranice Projekti
. Može postavljati budžete organizacije i budžete projekata. Može dodijeliti dozvole za pregled informacija o upotrebi drugima u organizaciji. Može arhivirati projekte.
ČitalacOrganizacijaMože izvršavati zaključivanje, koristiti resurse i kreirati ključeve u svojim projektima. Može biti dodan u projekte.
Ne može kreirati projekte ni upravljati korisnicima.
VlasnikProjekatMože dodavati druge korisnike u projekat i preimenovati projekat, kao i imati sve mogućnosti člana. Može postavljati budžete projekta. Može arhivirati projekat.
ČlanProjekatMože izvršavati zaključivanje, koristiti resurse i kreirati ključeve na nivou projekta.

Ako nisam vlasnik u organizaciji, čemu imam pristup?

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

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

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

Kako da ažuriram korisnikovu ulogu u projektu ili uklonim korisnika iz projekta?

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

Da ažurirate korisnika u projektu, idite u postavke organizacije, odaberite projekat i kliknite na Članovi. Imate opciju da postavite ulogu svakog člana kao Član ili Vlasnik. Možete odabrati i Ukloni da uklonite korisnika iz projekta.

Šta je servisni nalog i po čemu se razlikuje od običnog korisničkog naloga?

Servisni nalog djeluje kao pseudo-korisnik namijenjen za sistemski pristup, različit od pojedinačnih korisničkih naloga. Samo vlasnici organizacije i projekta mogu kreirati servisne naloge.

Servisni nalozi su ograničeni samo na projekte.

Dodavanje člana u projekat

Ako kliknete na dugme + Add member, vidjet ćete listu korisnika u svojoj organizaciji s ulogom Reader. Ako želite dodati korisnika koji trenutno nije u vašoj organizaciji, prvo ga morate dodati u organizaciju (možete ostaviti potvrdni okvir „Dodaj u zadani projekat“ neoznačen ako tim korisnicima ne želite dati širi pristup). Ova lista neće uključivati servisne naloge. Tokom ovog koraka možete odabrati da li je njihova uloga Owner ili Member:

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

Kada dodate člana tima, morate mu dodijeliti ulogu Član ili Vlasnik. Članovi projekta mogu slati API zahtjeve koji čitaju ili mijenjaju podatke, dok vlasnici projekta također mogu mijenjati postavke i budžete projekta te upravljati članovima projekta. Za više informacija pogledajte uloge i dozvole.

Kako kreirati servisni nalog za projekat

Prvo idite na projekat za koji želite kreirati servisni nalog odabirom iz padajućeg menija u navigacijskoj traci:

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

Zatim idite na postavke organizacije -> Projekat -> Članovi -> kliknite na + Service account:

Servisni nalozi kreirani na nivou projekta jedinstveni su za projekat i ne mogu se koristiti izvan projekta u kojem su kreirani.

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

Imenovanje servisnog naloga

Bez obzira na to da li kreirate servisni nalog na nivou organizacije ili onaj jedinstven za projekat, kada kreirate servisni nalog možete napraviti jedinstveni ID servisnog naloga koji se sastoji od slova, brojeva i crtica kako biste ga lakše identificirali.

Sačuvajte API ključ servisnog naloga

Nakon odabira dugmeta Kreiraj, API ključ se odmah kreira za servisni nalog i tajni ključ će biti prikazan. Sačuvajte ovaj tajni ključ na sigurnom i zaštićenom mjestu. Iz sigurnosnih razloga, nećete ga moći ponovo vidjeti putem svog OpenAI računa. Ako izgubite ovaj tajni ključ, morat ćete generisati novi.

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

Dozvole API ključa servisnog naloga zadano su postavljene na čitanje i pisanje svih API resursa projekta. Ove dozvole mogu se ažurirati u postavkama API ključeva vašeg projekta.

Servisni nalozi navedeni su zajedno s članovima projekta na stranici postavki članova vašeg projekta. Pogledajte ovdje da saznate više o ažuriranju ili uklanjanju pristupa servisnog naloga na stranici postavki članova vašeg projekta.

Svi servisni nalozi u projektima i organizacijama bit će prikazani zajedno s vašim ljudskim korisnicima na stranici članova na nivou organizacije.

Servisnim nalozima se upravlja kao redovnim nalozima. Iz Organizacija -> menija Članovi možete ukloniti servisni nalog ili ažurirati ulogu:

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

Kako da upravljam API ključevima unutar projekata svoje organizacije?

Možete kreirati i upravljati API ključevima za svaki projekat na stranici postavki tog projekta. U postavkama organizacije odaberite projekat i kliknite na API ključevi.

Da kreirate novi tajni ključ, odaberite + Create new secret key. Možete odabrati i ikonu Uredi pored tajnog ključa da uredite njegove dozvole.

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

Možete postaviti dozvole za svaki od svojih API ključeva kada kreirate novi tajni ključ ili uređivanjem postojećeg ključa.

Dostupna su tri nivoa dozvola: Sve, Ograničeno i Samo za čitanje.

  • Sve — Pune dozvole su postavljene za tajni ključ. Ovo je zadana postavka.

  • Ograničeno — Omogućava korisniku da postavi dozvole Nema, Čitanje i Pisanje za svaku krajnju tačku.

    • Na primjer, kreirate API ključ koji konkretno nema dozvolu za čitanje ili pisanje na krajnju tačku /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Samo za čitanje — Dozvole za čitanje postavljene su za sve krajnje tač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 lični API ključ koji je ograničen na pristup tom projektu i njegovim resursima.

Kako da postavim i upravljam ograničenjima brzine za projekte svoje organizacije?

Samo vlasnik organizacije može postavljati i upravljati ograničenjima brzine na nivou projekta. Za više informacija pogledajte uloge i dozvole.

U postavkama organizacije kliknite na projekat koji želite ažurirati i odaberite Ograničenja u odjeljku Projekat na listi za navigaciju. Na ovoj stranici možete ažurirati Upotrebu modela.

Upotreba modela omogućava vam da konfigurišete koji modeli se mogu koristiti u projektu, a ograničenja brzine mogu se postaviti za svaki model po potrebi.

Kako da postavim i upravljam budžetima za projekte svoje organizacije?

Samo vlasnici organizacije i vlasnici projekta mogu postavljati i upravljati budžetima projekta. Za više informacija pogledajte uloge i dozvole. Da promijenite ograničenja na nivou organizacije, u postavkama organizacije kliknite na Ograničenja, a zatim se pomaknite dolje do Ograničenja upotrebe.

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

Da postavite ograničenja projekta, u postavkama organizacije kliknite na projekat koji želite ažurirati i odaberite Ograničenja. Možete ažurirati Mjesečni budžet, Prag obavještenja i Upotrebu modela.

Postavljanje mjesečnog budžeta omogućava vam da odredite fleksibilne pragove potrošnje za svoj projekat. Kada upotreba premaši ovo ograničenje unutar datog kalendarskog mjeseca (UTC), API zahtjevi će se i dalje obrađivati bez prekida. Ova funkcija je osmišljena da vam pomogne pratiti upotrebu putem budžetskih upozorenja, ali ne nameće strogo ograničenje potrošnje. Kada se kreira budžet projekta, upozorenje će se po zadanim postavkama kreirati na pragu od 100%. Dodatni budžeti na različitim pragovima mogu se postaviti klikom na Dodaj upozorenje.

Imajte na umu da će vlasnik(ci) organizacije i vlasnik(ci) projekta uvijek primati ove 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 da izbrišem ili arhiviram projekat?

Projekti se mogu arhivirati putem nove stranice liste projekata ili u postavkama pojedinačnog projekta. Kada se projekat arhivira, ne može se vratiti. Prilikom nastavka arhiviranja, od vas će se tražiti da unesete naziv projekta kako biste nastavili.

Listu svih arhiviranih projekata možete vidjeti putem kartice „Arhivirano“ na istoj stranici liste projekata.

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

Brisanje projekata nije moguće; održavamo historiju svih projekata kako bismo osigurali kontinuitet praćenja upotrebe i naplate.

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

Organizacije podrazumijevano mogu kreirati 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 projekat i ne mogu im pristupiti članovi koji nisu administratori izvan projekta. Nadalje, resursi se ne mogu premještati između projekata.

Jedini izuzetak je to što se fine-tuneovi u "Podrazumijevanom projektu" mogu pristupiti iz drugih projekata.

Kolika je kvota za pohranu datoteka po projektu?

OpenAI trenutno podržava kvotu za pohranu datoteka od 100 GB datoteka po projektu.

Ako se ova kvota premaši, vidjet ćete sljedeću greš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 neiskorištene datoteke pohranjene na svom računu. Za referencu, možete pregledati i izlistati datoteke pomoću API-ja.

Vlasnik sam projekta, zašto ne mogu vidjeti kontrolnu tablu upotrebe za svoj projekat?

Vidljivost kontrolne table upotrebe projekta nije povezana s ulogom korisnika unutar projekta. Umjesto toga, određena je vašom ulogom unutar organizacije i postavkama 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 kontrolnu tablu upotrebe, ova postavka je vjerovatno postavljena na „Vidljivo vlasnicima organizacije“.

Da li je ovaj članak bio koristan?