OpenAI
Šo lapu tulkoja mašīntulks. Skatīt oriģinālo rakstu angļu valodā.

Projektu pārvaldība API platformā

Uzziniet, kā izveidot un pārvaldīt OpenAI API projektus, tostarp dalībniekus, lomas, pakalpojumu kontus, API atslēgas, lietojuma ierobežojumus un budžetus.

Atjaunināts: 10 days ago

Projekti ir paredzēti, lai klienti varētu organizēt savu darbu. Organizācijas var pārvaldīt piekļuvi un limitus, nodrošināt pakalpojumu kontus (izmantojot lietotāja saskarni) un sekot lietojumam ierobežotā projekta tvērumā (piemēram, modeļi, iespējas, pavedieni, asistenti, precīzā pielāgošana, krātuve u. c.). Lietojuma aktivitāti var sadalīt pa projektiem, un lietotāji var skatīt norēķinus un iestatīt tēriņu limitus katram projektam.

Organizācijas īpašnieki var skatīt visus savus aktīvos un arhivētos projektus lapā Projekti. Uzziniet vairāk par lietotāju lomām un atļaujām API platformā.

Image

Kas var izveidot projektu?

Projektu var izveidot tikai organizācijas īpašnieki. Plašāku informāciju skatiet sadaļā Lomas un atļaujas.

Lai pārslēgtos starp organizācijām, novietojiet kursoru virs organizācijas nosaukuma lapas augšējā kreisajā stūrī un sarakstā atlasiet organizāciju:

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

Organizācijām ar konsolidētu norēķinu plānu apakšorganizācijas tiek norādītas atsevišķi. Apakšorganizācijās nevar izveidot projektus.

Image

Kā darbojas projekti?

Katrā organizācijā ir “Noklusējuma projekts”, kuru nevar dzēst. Varat konfigurēt pieprasījumu ātruma ierobežojumus, virtuālo modeļu atļaujas un tēriņu ierobežojumus (no 2024. gada novembra). Tas pārmanto visu organizācijas konfigurāciju, tāpēc tam nevar tieši pievienot dalībniekus vai pakalpojumu kontus.

Kā izveidot projektu?

Vispirms novietojiet kursoru virs projekta nosaukuma lapas kreisajā stūrī un atlasiet Izveidot projektu.

API platform project menu with Create project highlighted under Default project

Norādiet projekta nosaukumu, aprakstu un tīmekļa vietni un pēc tam atlasiet Izveidot.

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

Kā projektam pievienot lietotājus?

Jaunie organizācijas dalībnieki netiek automātiski pievienoti projektam “Noklusējuma projekts”. Jaunos dalībniekus var uzaicināt uz projektu, kad viņi tiek uzaicināti pievienoties organizācijai (atzīmējot izvēles rūtiņu "Uzaicināt uz noklusējuma projektu"), vai pēc tam, kad dalībnieks ir pieņēmis organizācijas uzaicinājumu.

Uz lietotājiem, kuri uzaicināti, izmantojot administratora API, attiecas noteikumi, kas aprakstīti /organization/invites galapunkta dokumentācijā.

Ja, uzaicinot lietotājus uz projektu lietotāja saskarnē vai ar administratora API, rodas kļūda, pirms uzaicinājuma atkārtotas nosūtīšanas pārbaudiet, vai attiecīgais projekts pastāv un nav arhivēts.

Organizācijas īpašnieki tiek automātiski pievienoti kā īpašnieki organizācijā izveidotajiem jaunajiem projektiem.

Kādas lietotāju lomas ir pieejamas organizācijās un projektos, un kādas atļaujas tās nodrošina?

Organizācijās ir lomas “īpašnieks” un “lasītājs”, savukārt projektos — “īpašnieks” un “dalībnieks”. Projekta dalībnieki ir pielīdzināmi organizācijas lasītājiem. Detalizētāku katrai lietotāja lomai piešķirto atļauju aprakstu skatiet tālāk esošajā tabulā.

LomaTvērumsApraksts
ĪpašnieksOrganizācijaVar izveidot un skatīt visus projektus, visus lietotājus un visas API atslēgas. Var pārraudzīt visus organizācijas projektus, izmantojot

projektu lapu
. Var iestatīt organizācijas un projektu tēriņu ierobežojumus. Var piešķirt citiem organizācijas dalībniekiem atļauju skatīt lietojuma informāciju. Var arhivēt projektus.
LasītājsOrganizācijaSavos projektos var veikt inferenci, izmantot resursus un izveidot atslēgas. Var tikt pievienots projektiem.
Nevar izveidot projektus un pārvaldīt lietotājus.
ĪpašnieksProjektsVar pievienot projektam citus lietotājus, pārdēvēt projektu un izmantot visas dalībniekam pieejamās iespējas. Var iestatīt projekta tēriņu ierobežojumus. Var arhivēt projektu.
DalībnieksProjektsProjekta līmenī var veikt inferenci, izmantot resursus un izveidot atslēgas.

Kam varu piekļūt, ja neesmu organizācijas īpašnieks?

Lietotāji, kuri nav organizācijas īpašnieki, var redzēt tikai tos projektus, kuros viņi ir dalībnieki. Tikai organizācijas īpašnieks projekta līmenī var redzēt visus projektus, dalībniekus un API atslēgas, kā arī piekļūt projektu lapai.

  • Tikai projekta dalībnieki (un organizācijas īpašnieki) var redzēt projektā izveidotos precīzi pielāgotos modeļus, izveidoto asistentu pavedienus un pievienotos failus.

  • Projekta dalībnieki var redzēt visus pārējos projekta dalībniekus un viņu lomas (piemēram, Īpašnieks vai Dalībnieks).

Kā mainīt lietotāja lomu projektā vai noņemt lietotāju no projekta?

Tikai projekta īpašnieks var mainīt lietotāja lomu projektā vai noņemt lietotāju no projekta. Plašāku informāciju skatiet sadaļā Lomas un atļaujas.

Lai projektā atjauninātu lietotāja datus, atveriet organizācijas iestatījumus, atlasiet projektu un noklikšķiniet uz Dalībnieki. Katram dalībniekam varat piešķirt lomu Dalībnieks vai Īpašnieks. Lai lietotāju noņemtu no projekta, varat arī atlasīt Noņemt.

Kas ir pakalpojuma konts, un ar ko tas atšķiras no parasta lietotāja konta?

Pakalpojuma konts darbojas kā sistēmas piekļuvei paredzēts pseidolietotājs un atšķiras no individuāla lietotāja konta. Pakalpojumu kontus var izveidot tikai organizācijas un projekta īpašnieki.

Servisa kontu tvērums attiecas tikai uz projektiem.

Dalībnieka pievienošana projektam

Noklikšķinot uz pogas + Pievienot dalībnieku, redzēsiet organizācijas lietotājus ar lomu Lasītājs. Ja vēlaties pievienot lietotāju, kurš pašlaik nav jūsu organizācijā, vispirms tas jāpievieno organizācijai (ja nevēlaties šiem lietotājiem piešķirt plašāku piekļuvi, neatzīmējiet izvēles rūtiņu "Pievienot noklusējuma projektam"). Šajā sarakstā nebūs pakalpojumu kontu. Šajā darbībā varat izvēlēties lomu Īpašnieks vai Dalībnieks:

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

Pievienojot komandas dalībnieku, tam jāpiešķir loma Dalībnieks vai Īpašnieks. Projekta dalībnieki var veikt API pieprasījumus, kas lasa vai maina datus, savukārt projekta īpašnieki var arī mainīt projekta iestatījumus un tēriņu ierobežojumus, kā arī pārvaldīt projekta dalībniekus. Plašāku informāciju skatiet sadaļā Lomas un atļaujas.

Kā izveidot projekta pakalpojuma kontu

Vispirms pārejiet uz projektu, kuram vēlaties izveidot pakalpojuma kontu, atlasot to navigācijas joslas nolaižamajā izvēlnē:

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

Pēc tam atveriet organizācijas iestatījumus -> Projekts -> Dalībnieki -> un noklikšķiniet uz + Pakalpojuma konts:

Servisa konti, kas izveidoti projekta līmenī, ir unikāli projektam, un tos nevar izmantot ārpus projekta, kurā tie ir izveidoti.

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

Pakalpojuma konta nosaukuma piešķiršana

Neatkarīgi no tā, vai pakalpojuma kontu veidojat organizācijas līmenī vai tikai konkrētam projektam, varat izveidot unikālu pakalpojuma konta ID, kurā ir burti, cipari un defises, lai kontu būtu viegli identificēt.

Pakalpojuma konta API atslēgas saglabāšana

Pēc pogas Izveidot atlasīšanas pakalpojuma kontam uzreiz tiek izveidota API atslēga un parādīta slepenā atslēga. Saglabājiet šo slepeno atslēgu drošā vietā. Drošības apsvērumu dēļ savā OpenAI kontā to vairs nevarēsiet skatīt. Ja pazaudēsiet šo slepeno atslēgu, būs jāģenerē jauna.

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

Pēc noklusējuma pakalpojuma konta API atslēgai ir atļauts lasīt un rakstīt visus projekta API resursus. Šīs atļaujas var mainīt projekta API atslēgu iestatījumos.

Pakalpojumu konti ir norādīti kopā ar projekta dalībniekiem projekta dalībnieku iestatījumu lapā. Plašāku informāciju par pakalpojuma konta piekļuves mainīšanu vai noņemšanu projekta dalībnieku iestatījumu lapā skatiet šeit.

Visi pakalpojumu konti gan projektos, gan organizācijās tiks parādīti kopā ar jūsu cilvēklietotājiem organizācijas līmeņa dalībnieku lapā.

Pakalpojumu konti tiek pārvaldīti tāpat kā parasti konti. Izvēlnē Organizācija -> Dalībnieki varat Noņemt pakalpojuma kontu vai atjaunināt lomu:

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

Kā pārvaldīt API atslēgas organizācijas projektos?

Katra projekta API atslēgas var izveidot un pārvaldīt attiecīgā projekta iestatījumu lapā. Atveriet organizācijas iestatījumus, atlasiet projektu un noklikšķiniet uz API atslēgas.

Lai izveidotu jaunu slepeno atslēgu, atlasiet + Izveidot jaunu slepeno atslēgu. Lai rediģētu slepenās atslēgas atļaujas, varat arī atlasīt tai blakus esošo rediģēšanas ikonu.

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

Katras API atslēgas atļaujas varat iestatīt, izveidojot jaunu slepeno atslēgu vai rediģējot esošo.

Ir pieejami trīs atļauju līmeņi: Visas, Ierobežotas un Tikai lasīšana.

  • Visas — slepenajai atslēgai tiek piešķirtas pilnas atļaujas. Šis ir noklusējuma iestatījums.

  • Ierobežotas — lietotājs katram galapunktam var iestatīt atļauju Nav, Lasīšana vai Rakstīšana.

  • Piemēram, varat izveidot API atslēgu, kurai nav lasīšanas vai rakstīšanas atļaujas galapunktā /v1/assistants:

Create new secret key dialog in the API platform with Restricted permissions selected
  • Tikai lasīšana — visiem galapunktiem tiek iestatītas lasīšanas atļaujas.

Kā tiek pārvaldīta piekļuve lietotājiem, kuri darbojas vairākos projektos vai organizācijās?

Lietotāji var būt dalībnieki tik daudzos projektos, cik nepieciešams. Projektā lietotāji var ģenerēt personisku API atslēgu, kuras tvērums un piekļuve ir ierobežota līdz šim projektam un tā resursiem.

Kā iestatīt un pārvaldīt organizācijas projektu pieprasījumu ātruma ierobežojumus?

Projekta līmeņa pieprasījumu ātruma ierobežojumus var iestatīt un pārvaldīt tikai organizācijas īpašnieks. Plašāku informāciju skatiet sadaļā Lomas un atļaujas.

Atveriet organizācijas iestatījumus, noklikšķiniet uz projekta, kuru vēlaties atjaunināt, un navigācijas saraksta sadaļā Projekts atlasiet Ierobežojumi. Šajā lapā varat atjaunināt iestatījumu Modeļu lietojums.

Modeļu lietojums ļauj noteikt, kurus modeļus projektā var izmantot, un katram modelim pēc vajadzības var iestatīt pieprasījumu ātruma ierobežojumus.

Kā iestatīt un pārvaldīt organizācijas projektu tēriņu ierobežojumus?

Projektu tēriņu ierobežojumus var iestatīt un pārvaldīt tikai organizācijas un projekta īpašnieki. Plašāku informāciju skatiet sadaļā Lomas un atļaujas. Lai mainītu ierobežojumus organizācijas līmenī, atveriet organizācijas iestatījumus, noklikšķiniet uz Ierobežojumi un ritiniet līdz sadaļai Lietojuma ierobežojumi.

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

Lai iestatītu projekta ierobežojumus, atveriet organizācijas iestatījumus, noklikšķiniet uz projekta, kuru vēlaties atjaunināt, un atlasiet Ierobežojumi. Varat atjaunināt iestatījumus Mēneša tēriņu ierobežojums, Paziņojumu slieksnis un Modeļu lietojums.

Iestatot mēneša tēriņu ierobežojumu, varat noteikt projekta orientējošo tēriņu slieksni. Ja lietojums attiecīgajā kalendārajā mēnesī (UTC) pārsniedz šo ierobežojumu, API pieprasījumi joprojām tiek apstrādāti bez pārtraukuma. Šī funkcija palīdz pārraudzīt lietojumu, nosūtot brīdinājumus par tēriņu ierobežojumu, taču tā nenosaka stingrus tēriņu griestus. Izveidojot projekta tēriņu ierobežojumu, pēc noklusējuma tiek izveidots brīdinājums pie 100% sliekšņa. Lai iestatītu papildu brīdinājumus pie citiem sliekšņiem, noklikšķiniet uz Pievienot brīdinājumu.

Ņemiet vērā, ka organizācijas un projekta īpašnieki vienmēr saņems šos ziņojumus un to nevar pielāgot.

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

Kā iestatīt organizācijas vai projekta tēriņu ierobežojumus?

OpenAI tagad atbalsta API mēneša tēriņu ierobežojumus gan organizācijas, gan projekta līmenī. Tēriņu ierobežojums var tikai pārraudzīt tēriņus, tos neapturot, vai arī varat to piemērot kā stingru ierobežojumu, lai pēc tā sasniegšanas API pieprasījumi neizdotos. Jaunākās konfigurēšanas darbības un darbības principus skatiet izstrādātāju dokumentācijas sadaļā Tēriņu ierobežojumi.

Kā dzēst vai arhivēt projektu?

Projektus var arhivēt jaunajā projektu saraksta lapā vai atsevišķa projekta iestatījumos. Pēc projekta arhivēšanas to nevar atjaunot. Lai turpinātu arhivēšanu, jums būs jāievada projekta nosaukums.

Visu arhivēto projektu sarakstu varat skatīt tās pašas projektu saraksta lapas cilnē “Arhivētie”.

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

Projektus nevar dzēst. Mēs saglabājam visu projektu vēsturi, lai nodrošinātu lietojuma un norēķinu uzskaites nepārtrauktību.

Vai projektu skaits organizācijā ir ierobežots?

Pēc noklusējuma organizācijas var izveidot līdz 2000 projektiem.

Vai resursus var koplietot starp projektiem?

Projekta resursi (piemēram, faili, asistenti, krātuve vai pavedieni) ir piesaistīti projektam, un tiem nevar piekļūt ārpus projekta esoši dalībnieki, kuri nav administratori. Turklāt resursus nevar pārvietot starp projektiem.

Vienīgais izņēmums ir tas, ka modeļiem ar smalko pielāgošanu “Noklusējuma projektā” var piekļūt no citiem projektiem.

Kāda ir viena projekta failu krātuves kvota?

Pašlaik OpenAI katram projektam nodrošina 100 GB failu krātuves kvotu.

Ja šī kvota tiks pārsniegta, redzēsiet šādu kļūdu:

Jūs esat pārsniedzis failu glabātuves kvotu. Organizācijām ir noteikts 100 GB failu ierobežojums. Lūdzu, samaziniet faila izmēru vai sazinieties ar atbalstu.

Iesakām dzēst neizmantotos failus, kas glabājas jūsu kontā. Uzziņai varat skatīt un uzskaitīt failus, izmantojot API.

Esmu projekta īpašnieks. Kāpēc neredzu sava projekta lietojuma informācijas paneli?

Projekta lietojuma informācijas paneļa redzamība nav atkarīga no lietotāja lomas projektā. To nosaka jūsu loma organizācijā un iestatījumi lapā https://platform.openai.com/settings/organization/data-controls/visibility

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

Ja neredzat lietojuma informācijas paneli, šim iestatījumam, visticamāk, ir izvēlēta vērtība "Redzams organizācijas īpašniekiem".

Vai šis raksts bija noderīgs?