Upravljanje projektima na API platformi

Pregled

Projekti služe za organizaciju rada unutar API organizacije. Koristite ih za upravljanje pristupom, podešavanje ograničenja modela i brzine, kreiranje servisnih računa te praćenje korištenja, naplate i ograničenja potrošnje za definisani skup resursa, kao što su modeli, mogućnosti, niti, asistenti, dodatna obuka i prostor za pohranu.

Vlasnici organizacije mogu pregledati sve aktivne i arhivirane projekte na stranici Projekti.

Prije nego što počnete

Za kreiranje projekta potrebna vam je uloga vlasnika organizacije. Prema zadanim postavkama, organizacije mogu kreirati do 2.000 projekata.

Ako vaša organizacija koristi objedinjenu naplatu, podorganizacije se prikazuju zasebno u izborniku organizacija. Ne možete kreirati projekte unutar podorganizacije.

Da biste promijenili organizaciju, otvorite izbornik organizacija i odaberite onu koju želite koristiti.

Zadani projekt

Svaka organizacija uključuje zadani projekt koji se ne može izbrisati. On nasljeđuje sve postavke organizacije. Možete podesiti njegova ograničenja brzine, dozvole za virtualne modele i ograničenja potrošnje.

Ne možete dodavati članove ni servisne račune direktno u zadani projekt. Prilikom pozivanja nekoga u organizaciju možete mu omogućiti pristup zadanom projektu prateći korake za slanje pozivnice za organizaciju u ovom članku.

Kreirajte projekt

1. Otvorite izbornik projekata i odaberite Kreiraj projekt.

2. Unesite naziv, opis i web-stranicu svog projekta.

3. Odaberite Kreiraj.

Vlasnici organizacije automatski se dodaju kao vlasnici novih projekata.

Upoznajte se s ulogama i pristupom

Tabela sažeto prikazuje uloge vlasnika i čitaoca u organizaciji te vlasnika i člana u projektu koje se spominju u ovim koracima. Članovi projekta imaju dozvole slične dozvolama čitalaca u organizaciji.

Za detalje o ulogama u organizaciji pogledajte: uloge u organizaciji. Za dodatne uloge, prilagođene uloge i potpuni pregled dozvola pogledajte vodič za API uloge i dozvole.

Vidljivost projekata

Uz ove standardne uloge, korisnici koji nisu vlasnici organizacije mogu vidjeti samo projekte kojima pripadaju. Vlasnici organizacije mogu vidjeti sve projekte, članove i API ključeve na nivou projekta te pristupiti stranici Projekti.

Članovi projekta mogu vidjeti ostale članove svog projekta i ulogu svakog člana. Samo članovi projekta i vlasnici organizacije mogu vidjeti dodatno obučene modele, niti asistenata i datoteke kreirane ili dodane unutar tog projekta.

Možete biti član onoliko projekata koliko vam je potrebno. Lični API ključ kreiran unutar projekta ograničen je na taj projekt i njegove resurse.

Granice pristupa resursima

Datoteke, asistenti, prostor za pohranu i niti ograničeni su na svoj projekt. Članovi izvan tog projekta koji nemaju administratorske ovlasti ne mogu pristupiti njegovim resursima, a resursi se ne mogu premještati između projekata.

Dodatno obučeni modeli u zadanom projektu su izuzetak: njima se može pristupiti iz drugih projekata.

Upravljajte članovima projekta

Pozovite nekoga u svoju organizaciju

Kada nekoga pozivate u organizaciju, možete mu omogućiti pristup zadanom projektu odabirom te opcije u obrascu pozivnice. Ostavite tu opciju neoznačenom ako ne želite odobriti pristup zadanom projektu. Novi članovi organizacije ne dodaju se automatski u zadani projekt.

Ne morate kreirati drugi projekt prije nego što nekoga pozovete. Osobu možete dodati u projekt i nakon što prihvati pozivnicu za organizaciju.

Pozivnice poslane putem administratorskog API-ja podliježu pravilima za krajnju tačku /organization/invites.

Dodajte člana organizacije u projekt

Vlasnici organizacije i projekta mogu dodavati članove:

1. Idite na postavke organizacije.

2. Odaberite projekt, a zatim otvorite Članovi.

3. Odaberite + Dodaj člana.

4. Odaberite korisnika i dodijelite mu ulogu Član ili Vlasnik.

Na listi korisnika prikazuju se korisnici organizacije s ulogom Čitalac. Lista ne uključuje servisne račune.

Ako slanje pozivnice putem korisničkog interfejsa ili administratorskog API-ja ne uspije, prije ponovnog slanja provjerite postoji li ciljni projekt i je li arhiviran.

Promijenite ulogu ili uklonite člana

Vlasnici organizacije i projekta mogu promijeniti ulogu korisnika u projektu ili ukloniti korisnika iz tog projekta.

1. Idite na postavke organizacije.

2. Odaberite projekt, a zatim otvorite Članovi.

3. Postavite ulogu korisnika na Član ili Vlasnik ili odaberite Ukloni da biste ga uklonili.

Kreirajte servisne račune i upravljajte njima

Servisni račun omogućava pristup sistemima, umjesto da predstavlja pojedinačnog korisnika. Servisni računi ograničeni su na projekte.

Za kreiranje servisnih računa potrebne su dozvole za upravljanje servisnim računima. Vlasnici organizacije i projekta imaju ove dozvole.

Kreirajte servisni račun

1. Odaberite projekt u izborniku projekata.

2. Idite na postavke organizacije i odaberite projekt.

3. Otvorite Članovi i odaberite + Servisni račun.

4. Unesite jedinstveni ID servisnog računa koristeći slova, brojeve i crtice.

5. Odaberite Kreiraj.

Isti format ID-a primjenjuje se bez obzira na to kreirate li servisni račun u postavkama na nivou organizacije ili projekta.

Servisni račun kreiran za projekt vezan je isključivo za taj projekt i ne može se koristiti izvan njega.

Sačuvajte tajni ključ

Kreiranjem servisnog računa odmah se kreira API ključ i prikazuje njegov tajni ključ. Sačuvajte tajni ključ na sigurnom mjestu. Ne možete ga ponovo pregledati putem svog OpenAI računa. Ako ga izgubite, generišite novi ključ.

Prema zadanim postavkama, ključ servisnog računa ima pristup za čitanje i pisanje svim API resursima u svom projektu. Te dozvole možete naknadno promijeniti u postavkama projekta API ključevi.

Servisni računi prikazuju se zajedno s korisnicima u postavkama projekta Članovi. Njihovim pristupom projektu upravljajte istim koracima za promjenu uloge i uklanjanje kao i za ostale članove projekta.

Svi servisni računi prikazuju se i zajedno s korisnicima na stranici Članovi organizacije, uključujući račune kreirane u postavkama na nivou organizacije i projekta.

U meniju Članovi organizacije možete promijeniti ulogu servisnog računa ili odabrati Ukloni.

Kreirajte API ključeve i upravljajte njima

Svaki projekt ima vlastite API ključeve:

1. Idite na postavke organizacije.

2. Odaberite projekt, a zatim otvorite API ključevi.

3. Odaberite + Kreiraj novi tajni ključ da biste kreirali ključ ili odaberite ikonu za uređivanje pored postojećeg ključa da biste promijenili njegove dozvole.

Odaberite dozvole ključa

Za ključeve u vlasništvu korisnika dozvole možete postaviti pri kreiranju ključa ili ih naknadno urediti:

• Sve: Sve dozvole. Ovo je zadana postavka.

• Ograničeno: Odaberite opseg dozvola za određene resurse ili krajnje tačke. Dostupne opcije zavise od resursa i mogu uključivati Bez dozvola, Čitanje, Pisanje ili dozvole za određene vrste zahtjeva.

• Samo čitanje: Dozvole za čitanje za sve krajnje tačke.

Naprimjer, ograničeni ključ može isključiti pristup za čitanje i pisanje na krajnjoj tački /v1/assistants.

Za kreiranje ključeva servisnih računa potrebne su dozvole za upravljanje servisnim računima. Ako ne vidite tu opciju, zamolite vlasnika organizacije ili projekta da kreira ključ servisnog računa. Dijaloški okvir za kreiranje ključa ne prikazuje ove kontrole dozvola za ključeve servisnih računa; njihove dozvole promijenite naknadno u postavkama projekta API ključevi.

Podesite pristup modelima i ograničenja brzine

Za upravljanje ograničenjima brzine projekta potrebne su administratorske dozvole. Vlasnici organizacije imaju ove dozvole, a vlasnici projekata također mogu upravljati ograničenjima brzine projekta putem API-ja za upravljanje.

1. Idite na postavke organizacije.

2. Odaberite projekt, a zatim otvorite Ograničenja.

3. U odjeljku Korištenje modela odaberite koje modele projekt može koristiti.

4. Po potrebi postavite ograničenje brzine za svaki model.

Postavite ograničenja potrošnje i upozorenja

Mjesečna ograničenja potrošnje za API dostupna su i na nivou organizacije i na nivou projekta. Da biste promijenili ograničenje, morate imati dozvolu za upravljanje postavkama odgovarajuće organizacije ili projekta.

Ograničenje potrošnje može služiti za praćenje potrošnje bez zaustavljanja zahtjeva. Uključite opciju Primijeni strogo ograničenje potrošnje ako želite da API zahtjevi budu odbijeni kada evidentirana potrošnja dostigne ograničenje. Ograničenje se ne primjenjuje trenutno, pa evidentirana potrošnja može neznatno premašiti postavljeni iznos.

Upozorenja o potrošnji obavještavaju vas kada se dostigne određeni prag; ne zaustavljaju zahtjeve.

Postavite ograničenje potrošnje za organizaciju

1. Idite na postavke organizacije.

2. Otvorite Ograničenja i pronađite Potrošnja.

Postavite ograničenje potrošnje za projekt

1. Idite na postavke organizacije.

2. Odaberite projekt, a zatim otvorite Ograničenja.

3. Postavite vrijednosti za Ograničenje mjesečne potrošnje i Obavijesti kada potrošnja dostigne.

4. Uključite opciju Primijeni strogo ograničenje potrošnje ako želite zaustaviti API promet kada evidentirana potrošnja dostigne ograničenje.

Na ovoj stranici možete promijeniti i postavke za Korištenje modela.

Ako vaša potrošnja premašuje mjesečni budžet projekta, uporedite podatke o korištenju za isti projekt i mjesec. Provjerite je li opcija Primijeni strogo ograničenje potrošnje bila uključena u vrijeme korištenja. Ako je bila isključena, budžet je služio samo za praćenje potrošnje, a API zahtjevi su se i dalje obrađivali. Ako želite da budući zahtjevi budu odbijeni kada evidentirana potrošnja dostigne budžet, vlasnik organizacije ili projekta može uključiti opciju Primijeni strogo ograničenje potrošnje u postavkama projekta pod Ograničenja.

Ako je strogo ograničenje već bilo uključeno, evidentirana potrošnja ipak može neznatno premašiti budžet dok ograničenje ne počne djelovati. Ako potrošnja za taj projekt i mjesec i nakon ovih provjera ostane znatno iznad ograničenja koje se primjenjuje, a razlog nije jasan, obratite se podršci i navedite ID projekta, primijenjeno ograničenje, evidentiranu potrošnju te relevantne datume i vremensku zonu. Navedite i ID-ove relevantnih zahtjeva ako su dostupni. Nemojte navoditi API ključeve.

Upravljajte upozorenjima o potrošnji

Kada postavite ograničenje potrošnje za projekt, automatski se kreira i upozorenje za dostizanje 100% tog ograničenja. Odaberite Dodaj upozorenje da biste dodali upozorenja za druge pragove.

Vlasnici organizacije i projekta primaju upozorenja o potrošnji projekta. U postavkama upozorenja možete dodati druge primaoce e-pošte.

Za aktuelne korake podešavanja i način provođenja ograničenja pogledajte vodič za ograničenja potrošnje.

Pregledajte korištenje i naplatu

Podatke o korištenju možete pregledati po projektima, a za pojedinačne projekte možete pregledati i podatke o naplati te postaviti ograničenja potrošnje.

Pristup kontrolnoj ploči korištenja projekta zavisi od vaše uloge u organizaciji i postavki vidljivosti kontrolne ploče korištenja. Sama uloga vlasnika projekta ne daje vam pristup.

Ako ne možete vidjeti kontrolnu ploču korištenja projekta, provjerite je li vidljivost postavljena na Vidljivo vlasnicima organizacije.

Upravljajte pohranom datoteka

Svaki projekt ima kvotu od 100 GB za pohranu datoteka. Ako je premašite, može se prikazati ova greška:

Premašili ste kvotu za pohranu datoteka. Organizacije su ograničene na 100 GB datoteka. Smanjite veličinu datoteke ili se obratite podršci.

Izbrišite datoteke koje ne koristite da biste oslobodili prostor za pohranu. Možete izlistati pohranjene datoteke putem API-ja da biste pronašli datoteke koje vam više nisu potrebne.

Arhivirajte projekt

Vlasnici organizacije i projekta mogu arhivirati projekte sa stranice Projekti ili iz postavki pojedinačnog projekta. Kada se zatraži potvrda, unesite naziv projekta.

Arhiviranje je trajno: arhivirani projekt ne može se vratiti.

Da biste pregledali arhivirane projekte, otvorite karticu Arhivirani na stranici Projekti.

Projekti se ne mogu izbrisati. OpenAI čuva njihovu historiju radi praćenja korištenja i naplate.