Projektų valdymas API platformoje

Apžvalga

Projektai padeda organizuoti darbą API organizacijoje. Naudokite juos prieigai valdyti, modelių limitams ir užklausų dažnio ribojimams nustatyti, tarnybinėms paskyroms kurti bei apibrėžto išteklių rinkinio naudojimui, atsiskaitymui ir išlaidų limitams stebėti. Tokie ištekliai gali būti modeliai, funkcijos, gijos, asistentai, papildomas mokymas ir saugykla.

Organizacijos savininkai gali peržiūrėti visus aktyvius ir archyvuotus projektus puslapyje „Projektai“.

Prieš pradedant

Norėdami sukurti projektą, turite turėti organizacijos savininko vaidmenį. Pagal numatytuosius nustatymus organizacijos gali sukurti iki 2 000 projektų.

Jei jūsų organizacija naudoja bendrą atsiskaitymą, antrinės organizacijos organizacijų pasirinkimo meniu rodomos atskirai. Antrinėje organizacijoje projektų kurti negalima.

Norėdami perjungti organizaciją, atverkite organizacijų pasirinkimo meniu ir pasirinkite norimą organizaciją.

Numatytasis projektas

Kiekviena organizacija turi numatytąjį projektą, kurio negalima ištrinti. Jis paveldi visą organizacijos konfigūraciją. Galite konfigūruoti jo užklausų dažnio ribojimus, virtualiųjų modelių teises ir išlaidų limitus.

Negalite pridėti narių ar tarnybinių paskyrų tiesiogiai prie numatytojo projekto. Prieigą prie numatytojo projekto galite suteikti kviesdami asmenį į organizaciją pagal šiame straipsnyje aprašytus kvietimo į organizaciją veiksmus.

Sukurti projektą

1. Atverkite projektų pasirinkimo meniu ir pasirinkite Sukurti projektą.

2. Įveskite projekto pavadinimą, aprašą ir svetainės adresą.

3. Pasirinkite Sukurti.

Organizacijos savininkai automatiškai pridedami kaip naujų projektų savininkai.

Susipažinti su vaidmenimis ir prieiga

Lentelėje apibendrinti šiose instrukcijose minimi organizacijos savininko ir skaitytojo bei projekto savininko ir nario vaidmenys. Projekto narių teisės panašios į organizacijos skaitytojų teises.

Daugiau apie vaidmenis organizacijoje žr. straipsnyje „Organizacijos vaidmenys“. Informacijos apie papildomus ir pasirinktinius vaidmenis bei visas teises rasite API vaidmenų ir teisių vadove.

Projektų matomumas

Turėdami šiuos standartinius vaidmenis, naudotojai, kurie nėra organizacijos savininkai, mato tik tuos projektus, kuriems priklauso. Organizacijos savininkai gali matyti visus projektus, narius ir projekto lygmens API raktus bei pasiekti puslapį „Projektai“.

Projekto nariai gali matyti kitus savo projekto narius ir kiekvieno nario vaidmenį. Tik projekto nariai ir organizacijos savininkai gali matyti tame projekte sukurtus ar pridėtus papildomai mokytus modelius, asistentų gijas ir failus.

Galite priklausyti tiek projektų, kiek jums reikia. Projekte sukurtas asmeninis API raktas skirtas tik tam projektui ir jo ištekliams.

Išteklių atskyrimas

Failai, asistentai, saugykla ir gijos yra susieti tik su savo projektu. Tam projektui nepriklausantys nariai, kurie nėra administratoriai, negali pasiekti jo išteklių, o išteklių negalima perkelti iš vieno projekto į kitą.

Išimtis taikoma numatytojo projekto papildomai mokytiems modeliams: juos galima pasiekti iš kitų projektų.

Tvarkyti projekto narius

Pakviesti asmenį į organizaciją

Kviesdami asmenį į organizaciją, galite suteikti jam prieigą prie numatytojo projekto – kvietimo formoje pažymėkite atitinkamą parinktį. Jei nenorite suteikti prieigos prie numatytojo projekto, palikite šią parinktį nepažymėtą. Nauji organizacijos nariai nėra automatiškai pridedami prie numatytojo projekto.

Prieš kviesdami asmenį, neprivalote sukurti kito projekto. Asmenį prie projekto taip pat galite pridėti po to, kai jis priima kvietimą į organizaciją.

Per administravimo API siunčiamiems kvietimams taikomos /organization/invites prieigos taško taisyklės.

Pridėti organizacijos narį prie projekto

Organizacijos ir projekto savininkai gali pridėti narių:

1. Eikite į organizacijos nustatymus.

2. Pasirinkite projektą, tada atverkite skiltį Nariai.

3. Pasirinkite + Pridėti narį.

4. Pasirinkite naudotoją ir priskirkite jam vaidmenį Narys arba Savininkas.

Naudotojų sąraše rodomi organizacijos naudotojai, turintys skaitytojo vaidmenį. Tarnybinės paskyros į šį sąrašą neįtraukiamos.

Jei kvietimo nepavyksta išsiųsti per naudotojo sąsają ar administravimo API, prieš siųsdami jį dar kartą patikrinkite, ar atitinkamas projektas egzistuoja ir nėra archyvuotas.

Pakeisti vaidmenį arba pašalinti narį

Organizacijos ir projekto savininkai gali pakeisti naudotojo vaidmenį projekte arba pašalinti naudotoją iš to projekto.

1. Eikite į organizacijos nustatymus.

2. Pasirinkite projektą, tada atverkite skiltį Nariai.

3. Priskirkite naudotojui vaidmenį Narys arba Savininkas, o jei norite jį pašalinti, pasirinkite Pašalinti.

Kurti ir tvarkyti tarnybines paskyras

Tarnybinė paskyra suteikia prieigą sistemai, o ne atstovauja atskiram naudotojui. Tarnybinės paskyros susietos su konkrečiais projektais.

Norint kurti tarnybines paskyras, reikia tarnybinių paskyrų valdymo teisių. Šias teises turi organizacijos ir projekto savininkai.

Sukurti tarnybinę paskyrą

1. Projektų pasirinkimo meniu pasirinkite projektą.

2. Eikite į organizacijos nustatymus ir pasirinkite projektą.

3. Atverkite skiltį Nariai ir pasirinkite + Tarnybinė paskyra.

4. Įveskite unikalų tarnybinės paskyros ID, sudarytą iš raidžių, skaitmenų ir brūkšnelių.

5. Pasirinkite Sukurti.

Tas pats ID formatas taikomas nepriklausomai nuo to, ar tarnybinę paskyrą kuriate organizacijos, ar projekto lygmens nustatymuose.

Projektui sukurta tarnybinė paskyra skirta tik tam projektui ir negali būti naudojama už jo ribų.

Išsaugoti slaptąjį raktą

Sukūrus tarnybinę paskyrą, iš karto sukuriamas API raktas ir parodomas jo slaptasis raktas. Saugiai išsaugokite slaptąjį raktą. Savo „OpenAI“ paskyroje jo peržiūrėti dar kartą negalėsite. Jei jį prarasite, sugeneruokite naują raktą.

Pagal numatytuosius nustatymus tarnybinės paskyros raktas turi visų savo projekto API išteklių skaitymo ir rašymo teises. Šias teises vėliau galite pakeisti projekto nustatymų skiltyje API raktai.

Tarnybinės paskyros rodomos kartu su naudotojais projekto nustatymų skiltyje Nariai. Jų prieigą prie projekto tvarkykite atlikdami tuos pačius vaidmens keitimo ir pašalinimo veiksmus kaip ir kitų projekto narių atveju.

Visos tarnybinės paskyros taip pat rodomos kartu su naudotojais organizacijos puslapyje „Nariai“, įskaitant paskyras, sukurtas organizacijos ir projekto lygmens nustatymuose.

Organizacijos meniu „Nariai“ galite pakeisti tarnybinės paskyros vaidmenį arba pasirinkti Pašalinti.

Kurti ir tvarkyti API raktus

Kiekvienas projektas turi savo API raktus:

1. Eikite į organizacijos nustatymus.

2. Pasirinkite projektą, tada atverkite skiltį API raktai.

3. Pasirinkite + Sukurti naują slaptąjį raktą, kad sukurtumėte raktą, arba pasirinkite redagavimo piktogramą šalia esamo rakto, kad pakeistumėte jo teises.

Pasirinkti rakto teises

Naudotojams priklausančių raktų teises galite nustatyti kurdami raktą arba pakeisti vėliau:

• Visos: visos teisės. Tai numatytasis nustatymas.

• Ribotos: pasirinkite konkrečių išteklių ar prieigos taškų teisių apimtį. Galimos parinktys priklauso nuo ištekliaus ir gali apimti Nėra, Skaityti, Rašyti arba konkrečioms užklausoms skirtas teises.

• Tik skaityti: visų prieigos taškų skaitymo teisės.

Pavyzdžiui, ribotų teisių raktui galima nesuteikti /v1/assistants prieigos taško skaitymo ir rašymo teisių.

Norint kurti tarnybinių paskyrų raktus, reikia tarnybinių paskyrų valdymo teisių. Jei šios parinkties nematote, paprašykite organizacijos arba projekto savininko sukurti tarnybinės paskyros raktą. Rakto kūrimo dialogo lange šie teisių valdikliai tarnybinių paskyrų raktams nerodomi; jų teises pakeiskite vėliau projekto nustatymų skiltyje API raktai.

Konfigūruoti prieigą prie modelių ir užklausų dažnio ribojimus

Norint valdyti projekto užklausų dažnio ribojimus, reikia administravimo teisių. Šias teises turi organizacijos savininkai, o projekto savininkai taip pat gali valdyti projekto užklausų dažnio ribojimus per valdymo API.

1. Eikite į organizacijos nustatymus.

2. Pasirinkite projektą, tada atverkite skiltį Limitai.

3. Skiltyje Modelių naudojimas pasirinkite, kuriuos modelius projektas gali naudoti.

4. Pagal poreikį nustatykite kiekvieno modelio užklausų dažnio ribojimą.

Nustatyti išlaidų limitus ir įspėjimus

Mėnesio API išlaidų limitus galima nustatyti ir organizacijos, ir projekto lygmeniu. Norėdami pakeisti limitą, turite turėti teisę tvarkyti atitinkamos organizacijos ar projekto nustatymus.

Išlaidų limitą galima naudoti išlaidoms stebėti nestabdant užklausų. Įjunkite parinktį Taikyti griežtą išlaidų ribą, jei norite, kad API užklausos nebebūtų vykdomos, kai užfiksuotos išlaidos pasiekia limitą. Ribojimas įsigalioja ne iš karto, todėl užfiksuotos išlaidos gali šiek tiek viršyti nustatytą sumą.

Įspėjimai apie išlaidas praneša, kai pasiekiama nustatyta riba, tačiau užklausų nestabdo.

Nustatyti organizacijos išlaidų limitą

1. Eikite į organizacijos nustatymus.

2. Atverkite skiltį Limitai ir raskite Išlaidos.

Nustatyti projekto išlaidų limitą

1. Eikite į organizacijos nustatymus.

2. Pasirinkite projektą, tada atverkite skiltį Limitai.

3. Nustatykite laukų Mėnesio išlaidų limitas ir Įspėti, kai išlaidos pasiekia reikšmes.

4. Įjunkite parinktį Taikyti griežtą išlaidų ribą, jei norite sustabdyti API srautą, kai užfiksuotos išlaidos pasiekia limitą.

Šiame puslapyje taip pat galite pakeisti Modelių naudojimo nustatymus.

Tvarkyti įspėjimus apie išlaidas

Nustačius projekto išlaidų limitą, pagal numatytuosius nustatymus taip pat sukuriamas įspėjimas, siunčiamas pasiekus 100 % limito. Pasirinkite Pridėti įspėjimą, kad pridėtumėte įspėjimų apie kitas išlaidų ribas.

Įspėjimus apie projekto išlaidas gauna organizacijos ir projekto savininkai. Įspėjimų nustatymuose galite pridėti kitų el. pašto gavėjų.

Naujausius konfigūravimo veiksmus ir informaciją apie limitų taikymą rasite išlaidų limitų vadove.

Peržiūrėti naudojimo ir atsiskaitymo informaciją

Naudojimo duomenis galima suskirstyti pagal projektus, taip pat galima peržiūrėti atskirų projektų atsiskaitymo informaciją ir nustatyti jų išlaidų limitus.

Prieiga prie projekto naudojimo suvestinės priklauso nuo jūsų vaidmens organizacijoje ir naudojimo suvestinės matomumo nustatymų. Vien projekto savininko vaidmuo prieigos nesuteikia.

Jei nematote projekto naudojimo suvestinės, patikrinkite, ar matomumo parinktis nustatyta į Matoma organizacijos savininkams.

Tvarkyti failų saugyklą

Kiekvienam projektui skiriama 100 GB failų saugyklos kvota. Jei ją viršysite, gali būti rodomas toks klaidos pranešimas:

Viršijote failų saugyklos kvotą. Organizacijoms taikomas 100 GB failų limitas. Sumažinkite failo dydį arba kreipkitės į pagalbos tarnybą.

Ištrinkite nenaudojamus failus, kad atlaisvintumėte vietos saugykloje. Galite gauti saugomų failų sąrašą per API, kad rastumėte nebereikalingus failus.

Archyvuoti projektą

Organizacijos ir projekto savininkai gali archyvuoti projektus puslapyje „Projektai“ arba konkretaus projekto nustatymuose. Kai būsite paprašyti patvirtinti, įveskite projekto pavadinimą.

Archyvavimas yra negrįžtamas: archyvuoto projekto atkurti negalima.

Norėdami peržiūrėti archyvuotus projektus, puslapyje „Projektai“ atverkite skirtuką Archyvuoti.

Projektų ištrinti negalima. „OpenAI“ išsaugo jų istoriją naudojimui ir atsiskaitymui stebėti.