OpenAI
Šis puslapis buvo išverstas mašininiu būdu. Peržiūrėti originalų straipsnį anglų kalba.

Projektų valdymas API platformoje

Atnaujinta: 18 days ago

Projektų tikslas – suteikti klientams galimybę organizuoti savo darbą. Organizacijos gali valdyti prieigą ir limitus, parengti paslaugų paskyras (per UI) ir stebėti naudojimą pagal apribotą projekto aprėptį (pvz., modelius, galimybes, gijas, asistentus, tikslųjį derinimą, saugyklą ir kt.). Naudojimo veiklą galima suskirstyti pagal projektus, o naudotojai gali peržiūrėti atsiskaitymus ir nustatyti biudžetus kiekvienam projektui.

Organizacijos savininkai gali peržiūrėti visus savo aktyvius ir archyvuotus projektus Projektų puslapyje. Sužinokite daugiau apie naudotojų vaidmenis ir leidimus API platformoje.

Image

Kas gali sukurti projektą?

Projektą gali sukurti tik organizacijos savininkai. Daugiau informacijos rasite skiltyje vaidmenys ir leidimai.

Norėdami perjungti organizacijas, užveskite žymeklį ant organizacijos pavadinimo puslapio viršutiniame kairiajame kampe ir pasirinkite organizaciją iš sąrašo:

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

Organizacijose, kurioms taikomas konsoliduoto atsiskaitymo planas, antrinės organizacijos identifikuojamos atskirai. Projektų negalima kurti antrinėse organizacijose.

Image

Kaip veikia projektai?

Kiekviena organizacija apima „Numatytąjį projektą“, kurio negalima ištrinti. Galite konfigūruoti greičio limitus, virtualaus modelio leidimus ir išlaidų biudžetus (nuo 2024 m. lapkričio). Jis paveldi visą organizacijos konfigūraciją, todėl negalite tiesiogiai pridėti prie jo narių ar paslaugų paskyrų.

Kaip sukurti projektą?

Pirmiausia užveskite pelę ant projekto pavadinimo kairiajame puslapio kampe ir pasirinkite Create project.

API platform project menu with Create project highlighted under Default project

Nurodykite projekto pavadinimą, aprašą ir svetainę, tada pasirinkite Create.

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

Kaip pridėti naudotojų prie projekto?

Naujai pridėti organizacijos nariai nėra automatiškai pridedami prie „Numatytojo projekto“. Naujus narius į projektą galima pakviesti arba kviečiant juos į organizaciją (įjungus žymimąjį langelį „Kviesti į numatytąjį projektą“), arba nariui priėmus organizacijos kvietimą.

Per Admin API pakviestiems naudotojams taikomos taisyklės, aprašytos /organization/invites prieigos taške.

Jei kviesdami naudotojus į projektą per UI arba Admin API susiduriate su klaida, prieš pakartotinai siųsdami kvietimą pirmiausia patvirtinkite, kad tikslinis projektas egzistuoja ir nėra archyvuotas.

Organizacijos savininkai automatiškai pridedami kaip savininkai prie naujų organizacijoje sukurtų projektų.

Kokie yra skirtingi naudotojų vaidmenys organizacijose ir projektuose ir kokius leidimus jie suteikia?

Nors organizacijose yra „savininko“ ir „skaitytojo“ vaidmenys, projektuose yra „savininko“ ir „nario“ vaidmenys. Projekto nariai yra analogiški organizacijos skaitytojams. Toliau pateiktoje lentelėje rasite išsamesnį aprašą, kokie leidimai priskiriami kiekvienam naudotojo vaidmeniui.

VaidmuoAprėptisAprašas
SavininkasOrganizacijaGali kurti / peržiūrėti visus projektus, visus naudotojus, visus API raktus. Gali stebėti visus organizacijos projektus naudodamas

Projektų puslapį
. Gali nustatyti organizacijos biudžetus ir projektų biudžetus. Gali suteikti leidimus kitiems organizacijos nariams peržiūrėti naudojimo informaciją. Gali archyvuoti projektus.
SkaitytojasOrganizacijaGali atlikti išvedimą, naudoti išteklius ir kurti raktus savo projektuose. Gali būti pridėtas prie projektų.
Negali kurti projektų ir valdyti naudotojų.
SavininkasProjektasGali pridėti kitus naudotojus prie projekto ir pervardyti projektą, taip pat turi visas nario galimybes. Gali nustatyti projekto biudžetus. Gali archyvuoti projektą.
NarysProjektasGali atlikti išvedimą, naudoti išteklius ir kurti raktus projekto lygiu.

Jei nesu organizacijos savininkas, prie ko turiu prieigą?

Naudotojai, kurie nėra organizacijos savininkai, gali matyti tik tuos projektus, kurių nariai jie yra. Tik organizacijos savininkas gali matyti visus projektus, narius ir API raktus projekto lygiu bei turi prieigą prie Projektų puslapio.

  • Tik projekto nariai (ir organizacijos savininkai) gali matyti tame projekte sukurtus tiksliai derintus modelius, gijas iš sukurtų Asistentų arba pridėtus failus.

  • Projekto nariai gali matyti, kas yra visi kiti to projekto nariai ir kokie jų vaidmenys (t. y. Savininkas arba Narys).

Kaip atnaujinti naudotojo vaidmenį projekte arba pašalinti naudotoją iš projekto?

Tik projekto savininkas gali atnaujinti naudotojo vaidmenį projekte arba pašalinti naudotoją iš projekto. Daugiau informacijos rasite skiltyje vaidmenys ir leidimai.

Norėdami atnaujinti naudotoją projekte, eikite į savo organizacijos nustatymus, pasirinkite projektą ir spustelėkite Nariai. Kiekvieno nario vaidmenį galite nustatyti kaip Nario arba Savininko. Taip pat galite pasirinkti Pašalinti, kad pašalintumėte naudotoją iš projekto.

Kas yra paslaugos paskyra ir kuo ji skiriasi nuo įprastos naudotojo paskyros?

Paslaugos paskyra veikia kaip pseudo-naudotojas, skirtas sistemos prieigai, ir skiriasi nuo individualių naudotojų paskyrų. Paslaugų paskyras gali kurti tik organizacijos ir projektų savininkai.

Paslaugų paskyros taikomos tik projektams.

Pridėti narį prie projekto

Spustelėję mygtuką + Add member, pamatysite savo organizacijos naudotojų, turinčių vaidmenį Reader, sąrašą. Jei norite pridėti naudotoją, kurio šiuo metu nėra jūsų organizacijoje, pirmiausia turėsite jį pridėti prie organizacijos (jei nenorite suteikti šiems naudotojams platesnės prieigos, galite palikti žymimąjį langelį „Pridėti prie numatytojo projekto“ nepažymėtą). Šiame sąraše nebus paslaugų paskyrų. Šiame žingsnyje galite pasirinkti, ar jų vaidmuo bus Owner, ar Member:

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

Kai pridedate komandos narį, turite jam priskirti Nario arba Savininko vaidmenį. Projekto nariai gali teikti API užklausas, kurios nuskaito arba keičia duomenis, o projekto savininkai taip pat gali keisti projekto nustatymus ir projekto biudžetus bei valdyti projekto narius. Daugiau informacijos rasite skiltyje vaidmenys ir leidimai.

Kaip sukurti projekto paslaugų paskyrą

Pirmiausia pereikite į projektą, kuriam norite sukurti paslaugų paskyrą, pasirinkdami jį navigacijos juostoje esančiame išskleidžiamajame meniu:

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

Tada eikite į savo organizacijos nustatymus -> Projektas -> Nariai -> spustelėkite + Service account:

Projekto lygiu sukurtos paslaugų paskyros yra unikalios tam projektui ir negali būti naudojamos už projekto, kuriame jos sukurtos, ribų.

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

Paslaugos paskyros pavadinimas

Nesvarbu, ar kuriate paslaugos paskyrą organizacijos lygiu, ar kuriate unikalią projektui, kurdami paslaugos paskyrą galite sukurti unikalų paslaugos paskyros ID iš raidžių, skaičių ir brūkšnelių, kad būtų lengva ją identifikuoti.

Išsaugokite paslaugų paskyros API raktą

Pasirinkus mygtuką Sukurti, paslaugų paskyrai iš karto sukuriamas API raktas ir parodomas slaptasis raktas. Išsaugokite šį slaptąjį raktą saugioje vietoje. Saugumo sumetimais nebegalėsite jo peržiūrėti per savo OpenAI paskyrą. Jei prarasite šį slaptąjį raktą, turėsite sugeneruoti naują.

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

Paslaugų paskyros API rakto leidimai pagal numatytuosius nustatymus leidžia skaityti ir rašyti visus projekto API išteklius. Šiuos leidimus galima atnaujinti jūsų projekto API raktų nustatymuose.

Paslaugų paskyros pateikiamos kartu su projekto nariais jūsų projekto narių nustatymų puslapyje. Norėdami sužinoti daugiau apie paslaugų paskyros prieigos atnaujinimą arba pašalinimą projekto narių nustatymų puslapyje, žr. čia.

Visos paslaugų paskyros tiek projektuose, tiek organizacijose bus rodomos kartu su jūsų žmonių naudotojais organizacijos lygio narių puslapyje.

Paslaugų paskyros valdomos kaip įprastos paskyros. Meniu Organizacija -> Nariai galite Pašalinti paslaugų paskyrą arba atnaujinti vaidmenį:

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

Kaip valdyti API raktus savo organizacijos projektuose?

Kiekvieno projekto API raktus galite kurti ir valdyti to projekto nustatymų puslapyje. Savo organizacijos nustatymuose pasirinkite projektą ir spustelėkite API raktai.

Norėdami sukurti naują slaptąjį raktą, pasirinkite + Create new secret key. Taip pat galite pasirinkti redagavimo piktogramą šalia slaptojo rakto, kad redaguotumėte jo leidimus.

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

Kiekvieno savo API rakto leidimus galite nustatyti kurdami naują slaptąjį raktą arba redaguodami esamą raktą.

Galimi trys leidimų lygiai: Visi, Apriboti ir Tik skaityti.

  • Visi — slaptajam raktui nustatomi visi leidimai. Tai yra numatytasis nustatymas.

  • Apriboti — leidžia naudotojui kiekvienam prieigos taškui nustatyti leidimus „Nėra“, „Skaityti“ ir „Rašyti“.

    • Pavyzdžiui, sukuriate API raktą, kuris specialiai neturi leidimo skaityti arba rašyti į /v1/assistants prieigos tašką:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Tik skaityti — skaitymo leidimai nustatomi visiems prieigos taškams.

Kaip valdoma prieiga naudotojams, priklausantiems keliems projektams ar organizacijoms?

Naudotojai gali būti tiek projektų nariai, kiek reikia. Projekte naudotojai gali generuoti asmeninį API raktą, kurio apimtis ir prieiga yra apribota tuo projektu ir jo ištekliais.

Kaip nustatyti ir valdyti užklausų dažnio ribojimus savo organizacijos projektams?

Tik organizacijos savininkas gali nustatyti ir valdyti projekto lygio užklausų dažnio ribojimus. Daugiau informacijos rasite skiltyje vaidmenys ir leidimai.

Savo organizacijos nustatymuose spustelėkite projektą, kurį norite atnaujinti, ir navigacijos sąrašo skiltyje „Projektas“ pasirinkite Limitai. Šiame puslapyje galite atnaujinti Modelių naudojimą.

Modelių naudojimas leidžia konfigūruoti, kuriuos modelius gali naudoti projektas, o užklausų dažnio ribojimus prireikus galima nustatyti kiekvienam modeliui.

Kaip nustatyti ir valdyti savo organizacijos projektų biudžetus?

Projektų biudžetus gali nustatyti ir valdyti tik organizacijos savininkai ir projekto savininkai. Daugiau informacijos rasite skiltyje vaidmenys ir leidimai. Norėdami pakeisti limitus organizacijos lygiu, savo organizacijos nustatymuose spustelėkite Limitai, tada slinkite žemyn iki Naudojimo limitai.

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

Norėdami nustatyti projekto limitus, savo organizacijos nustatymuose spustelėkite projektą, kurį norite atnaujinti, ir pasirinkite Limitai. Galite atnaujinti Mėnesio biudžetą, Pranešimo slenkstį ir Modelių naudojimą.

Nustatę mėnesio biudžetą, galite apibrėžti švelniuosius savo projekto išlaidų slenksčius. Kai naudojimas viršija šį limitą per tam tikrą kalendorinį mėnesį (UTC), API užklausos ir toliau bus apdorojamos be pertraukų. Ši funkcija skirta padėti stebėti naudojimą per biudžeto įspėjimus, tačiau ji nenustato griežtos išlaidų ribos. Sukūrus projekto biudžetą, pagal numatytuosius nustatymus bus sukurtas įspėjimas ties 100 % slenksčiu. Papildomus biudžetus su skirtingais slenksčiais galima nustatyti spustelėjus Pridėti įspėjimą.

Atkreipkite dėmesį, kad organizacijos savininkas (-ai) ir projekto savininkas (-ai) visada gaus šiuos pranešimus ir to negalima tinkinti.

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

Kaip ištrinti arba archyvuoti projektą?

Projektus galima archyvuoti naujame projektų sąrašo puslapyje arba atskiro projekto nustatymuose. Kai projektas archyvuojamas, jo atkurti nebegalima. Tęsiant archyvavimą, jūsų bus paprašyta įvesti projekto pavadinimą, kad galėtumėte tęsti.

Visų archyvuotų projektų sąrašą galite peržiūrėti to paties projektų sąrašo puslapio skirtuke „Archyvuota“.

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

Projektų ištrinti negalima; saugome visų projektų istoriją, kad būtų užtikrintas naudojimo ir atsiskaitymo stebėjimo tęstinumas.

Ar yra ribojamas projektų skaičius mano organizacijoje?

Pagal numatytuosius nustatymus organizacijos gali sukurti iki 2 000 projektų.

Ar ištekliais galima dalytis tarp projektų?

Projekto ištekliai (pvz., failai, asistentai, saugykla ar gijos) yra apriboti projekto apimtimi ir negali būti pasiekiami ne administratoriaus narių už projekto ribų. Be to, išteklių negalima perkelti tarp projektų.

Vienintelė išimtis yra ta, kad „Numatytajame projekte“ esantys modelio tobulinimai gali būti pasiekiami iš kitų projektų.

Kokia yra failų saugyklos kvota vienam projektui?

Šiuo metu OpenAI palaiko 100 GB failų saugyklos kvotą vienam projektui.

Jei ši kvota viršijama, matysite šią klaidą:

Viršijote failų saugyklos kvotą. Organizacijoms leidžiama saugoti iki 100 GB failų. Sumažinkite failo dydį arba susisiekite su palaikymo komanda.

Rekomenduojame ištrinti nenaudojamus paskyroje saugomus failus. Informacijai: naudodami API galite peržiūrėti ir išvardyti failus.

Esu projekto savininkas, kodėl nematau savo projekto naudojimo informacijos suvestinės?

Projekto naudojimo informacijos suvestinės matomumas nėra susijęs su naudotojo vaidmeniu projekte. Vietoj to jis nustatomas pagal jūsų vaidmenį organizacijoje ir nustatymus adresu https://platform.openai.com/settings/organization/data-controls/visibility

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

Jei nematote naudojimo informacijos suvestinės, tikėtina, kad šis nustatymas yra „Matoma organizacijos savininkams“.

Ar šis straipsnis buvo naudingas?