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

Projektu pārvaldība API platformā

Atjaunināts: 2 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?

Tikai organizācijas īpašnieki var izveidot projektu. Papildinformāciju skatiet sadaļā lomas un atļaujas.

Lai pārslēgtos starp organizācijām, novietojiet kursoru virs savas 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

Tām organizācijām, kurām ir konsolidēts norēķinu plāns, apakšorganizācijas tiek identificētas atsevišķi. Projektus nevar izveidot apakšorganizācijās.

Image

Kā darbojas projekti?

Katrā organizācijā ir iekļauts „Noklusējuma projekts”, kuru nevar izdzēst. Varat konfigurēt ātruma limitus, virtuālo modeļu atļaujas un tēriņu limitus (sākot ar 2024. gada novembri). Tas pārmanto pilnu 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ļvietni, 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?

Nesen pievienoti organizācijas dalībnieki netiek automātiski pievienoti projektam “Noklusējuma projekts”. Jaunus dalībniekus var uzaicināt projektā, uzaicinot viņus 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, kas uzaicināti, izmantojot Admin API, attiecas /organization/invites galapunkta noteikumi.

Ja, uzaicinot lietotājus projektā lietotāja saskarnē vai ar Admin API, rodas kļūda, pirms uzaicinājuma atkārtotas nosūtīšanas pārbaudiet, vai mērķa projekts pastāv un nav arhivēts.

Organizācijas īpašnieki tiek automātiski pievienoti kā īpašnieki jauniem šajā organizācijā izveidotiem projektiem.

Kādas lietotāju lomas ir organizācijās un projektos, un kādas atļaujas tās ietver?

Kamēr organizācijām ir lomas „īpašnieks” un „lasītājs”, projektiem ir lomas „īpašnieks” un „dalībnieks”. Projekta dalībnieki ir pielīdzināmi organizācijas lasītājiem. Detalizētāku aprakstu par atļaujām, kas saistītas ar katru lietotāja lomu, skatiet tālāk esošajā tabulā.

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

lapu Projekti
. Var iestatīt organizācijas tēriņu limitus un projektu tēriņu limitus. Var piešķirt atļaujas skatīt citu organizācijas lietotāju lietojuma informāciju. Var arhivēt projektus.
LasītājsOrganizācijaVar veikt inferenci, izmantot resursus un izveidot atslēgas savos projektos. Var tikt pievienots projektiem.
Nevar izveidot projektus un pārvaldīt lietotājus.
ĪpašnieksProjektsVar pievienot projektam citus lietotājus un pārdēvēt projektu, kā arī izmantot visas dalībnieka iespējas. Var iestatīt projekta tēriņu limitus. Var arhivēt projektu.
DalībnieksProjektsVar veikt inferenci, izmantot resursus un izveidot atslēgas projekta līmenī.

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 var redzēt visus projektus, dalībniekus un API atslēgas projektu līmenī, kā arī piekļūt projektu lapai.

  • Tikai projekta dalībnieki un organizācijas īpašnieki var redzēt šajā projektā izveidotos precizētos modeļus, visu izveidoto Assistants 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 atjauninātu projekta 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 noņemtu lietotāju no projekta, varat arī atlasīt Noņemt.

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

Servisa konts darbojas kā pseido-lietotājs, kas paredzēts sistēmas piekļuvei, un atšķiras no individuāliem lietotāju kontiem. Servisa kontus var izveidot tikai organizācijas un projektu īpašnieki.

Servisa kontu tvērums attiecas tikai uz projektiem.

Dalībnieka pievienošana projektam

Noklikšķinot uz pogas + Pievienot dalībnieku, tiks parādīts jūsu organizācijas lietotāju saraksts, kuriem ir loma Lasītājs. Ja vēlaties pievienot lietotāju, kurš pašlaik nav jūsu organizācijā, vispirms pievienojiet viņu organizācijai (ja nevēlaties šiem lietotājiem piešķirt plašāku piekļuvi, varat neatzīmēt izvēles rūtiņu "Pievienot noklusējuma projektam"). Šajā sarakstā nebūs iekļauti pakalpojumu konti. Š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, viņam jāpiešķir loma Dalībnieks vai Īpašnieks. Projekta dalībnieki var veikt API pieprasījumus, kas nolasa 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 navigācijas joslas nolaižamajā izvēlnē atlasiet projektu, kuram vēlaties izveidot pakalpojuma kontu:

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

Servisa konta nosaukuma piešķiršana

Neatkarīgi no tā, vai veidojat servisa kontu organizācijas līmenī vai izveidojat projektu unikālu kontu, veidojot servisa kontu, varat izveidot unikālu servisa konta ID, kas sastāv no burtiem, cipariem un defisēm, lai servisa kontu būtu viegli identificēt.

Saglabājiet pakalpojuma konta API atslēgu

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 apskatī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 piešķirtas visu projekta API resursu lasīšanas un rakstīšanas atļaujas. Šī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 varat 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 mainī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šu atslēgu.

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

  • Visas — slepenajai atslēgai ir 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 ir iestatītas lasīšanas atļaujas.

Kā tiek pārvaldīta piekļuve lietotājiem, kas pieder vairākiem projektiem vai organizācijām?

Lietotāji var būt dalībnieki tik daudzos projektos, cik nepieciešams. Projektā lietotāji var ģenerēt personīgu API atslēgu, kuras tvērums ir ierobežots ar piekļuvi tikai šim projektam un tā resursiem.

Kā iestatīt un pārvaldīt darbības ierobežojumus savas organizācijas projektiem?

Tikai organizācijas īpašnieks var iestatīt un pārvaldīt projekta līmeņa darbības ierobežojumus. Papildinformāciju skatiet sadaļā lomas un atļaujas.

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

Modeļu lietojums ļauj konfigurēt, kurus modeļus projekts var izmantot, un katram modelim pēc vajadzības var iestatīt darbības 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ņojuma slieksnis un Modeļu lietojums.

Iestatot mēneša tēriņu ierobežojumu, varat noteikt projekta tēriņu brīdinājuma sliekšņus. Ja lietojums attiecīgajā kalendārajā mēnesī (UTC) pārsniegs šo ierobežojumu, API pieprasījumu apstrāde turpināsies bez pārtraukuma. Šī funkcija palīdz pārraudzīt lietojumu, izmantojot brīdinājumus par tēriņu ierobežojumu, taču tā nenosaka nepārsniedzamu tēriņu limitu. 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 mainīt.

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

Kā iestatīt tēriņu limitus savai organizācijai vai projektam?

OpenAI tagad atbalsta mēneša API tēriņu limitus gan organizācijas, gan projekta līmenī. Tēriņu limits var tikai uzraudzīt tēriņus, tos neierobežojot, vai arī varat to piemērot kā stingru limitu, lai API pieprasījumi pēc limita sasniegšanas neizdotos. Jaunākās konfigurēšanas darbības un darbības principu skatiet izstrādātāju dokumentācijas sadaļā Tēriņu limiti.

Kā izdzēst vai arhivēt projektu?

Projektus var arhivēt jaunajā projektu saraksta lapā vai atsevišķa projekta iestatījumos. Arhivētu projektu nevar atjaunot. Turpinot 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 izdzēst. Mēs saglabājam visu projektu vēsturi, lai nodrošinātu lietojuma un norēķinu uzskaites nepārtrauktību.

Vai ir ierobežots projektu skaits, ko varu izveidot savā organizācijā?

Organizācijas pēc noklusējuma var izveidot līdz 2,000 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 neadministratīvie dalībnieki ārpus projekta. 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?

OpenAI pašlaik nodrošina 100 GB failu krātuves kvotu vienam projektam.

Ja šī kvota tiks pārsniegta, būs redzama šāda kļūda:

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 saistīta ar lietotāja lomu 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 atlasīta vērtība "Redzams organizācijas īpašniekiem".

Vai šis raksts bija noderīgs?