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

Projektu pārvaldība API platformā

Atjaunināts: 7 days ago

Projektu mērķis ir dot klientiem iespēju organizēt savu darbu. Organizācijas var pārvaldīt piekļuvi un ierobežojumus, nodrošināt pakalpojumu kontus (izmantojot UI) un izsekot lietojumu pret ierobežotu tvērumu projektā (piem., modeļi, iespējas, pavedieni, asistenti, precizēšana, krātuve utt.). Lietojuma aktivitāti var sadalīt pēc projekta, un lietotāji var skatīt norēķinus un iestatīt budžetus katram projektam.

Organizācijas īpašnieki var skatīt visus savus aktīvos un arhivētos projektus Projektu lapā. 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 “Noklusējuma projekts”, kuru nevar dzēst. Jūs varat konfigurēt ātruma ierobežojumus, virtuālā modeļa atļaujas un tēriņu budžetus (no 2024. gada novembra). Tas pārmanto pilnu organizācijas konfigurāciju, tāpēc nevarat tam tieši pievienot dalībniekus vai servisa kontus.

Kā izveidot projektu?

Vispirms virziet kursoru virs projekta nosaukuma lapas kreisajā stūrī un atlasiet Create project.

API platform project menu with Create project highlighted under Default project

Ievadiet projekta nosaukumu, aprakstu un vietni un pēc tam atlasiet Create.

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

Kā pievienot lietotājus projektam?

Nesen pievienoti organizācijas dalībnieki netiek automātiski pievienoti „Noklusējuma projektam”. Jaunos dalībniekus var uzaicināt uz projektu, kad viņi tiek uzaicināti uz organizāciju (iespējojot 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.

Lietotājiem, kas uzaicināti, izmantojot Admin API, tiek piemēroti noteikumi, kas aprakstīti /organization/invites galapunktā.

Ja, uzaicinot lietotājus uz projektu, izmantojot UI vai Admin API, rodas kļūda, pirms atkārtotas uzaicinājuma nosūtīšanas vispirms 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 projektiem, kas izveidoti organizācijā.

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

Kamēr organizācijām ir „īpašnieka” un „lasītāja” lomas, projektiem ir „īpašnieka” un „dalībnieka” lomas. Projekta dalībnieki ir līdzīgi organizācijas lasītājiem. Detalizētāku aprakstu par atļaujām, kas piešķirtas katrai lietotāja lomai, skatiet tālāk esošajā tabulā.

LomaTvērumsApraksts
Ī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

Projektu lapu
. Var iestatīt organizācijas budžetus un projektu budžetus. Var piešķirt atļaujas skatīt lietojuma informāciju citiem organizācijā. 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 budžetus. Var arhivēt projektu.
DalībnieksProjektsVar veikt inferenci, izmantot resursus un izveidot atslēgas projekta līmenī.

Ja neesmu organizācijas īpašnieks, kam man ir piekļuve?

Lietotāji, kas 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 projekta līmenī un piekļūt Projektu lapai.

  • Tikai projekta dalībnieki (un organizācijas īpašnieki) var redzēt šajā projektā izveidotos precizētos modeļus, pavedienus no jebkuriem izveidotajiem Asistentiem vai jebkurus pievienotos failus.

  • Projekta dalībnieki var redzēt, kuri ir visi pārējie šī projekta dalībnieki un kādas ir viņu lomas (t. i., Īpašnieks vai Dalībnieks).

Kā atjaunināt lietotāja projekta lomu vai noņemt lietotāju no projekta?

Tikai projekta īpašnieks var atjaunināt lietotāja projekta lomu vai noņemt lietotāju no projekta. Papildinformāciju skatiet sadaļā lomas un atļaujas.

Lai atjauninātu lietotāju projektā, dodieties uz saviem organizācijas iestatījumiem, atlasiet projektu un noklikšķiniet uz Dalībnieki. Varat katra dalībnieka lomu iestatīt kā Dalībnieks vai Īpašnieks. Varat arī atlasīt Noņemt, lai noņemtu lietotāju no projekta.

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.

Pievienot dalībnieku projektam

Noklikšķinot uz pogas + Add member, tiks parādīts jūsu organizācijas lietotāju saraksts ar lomu Reader. Ja vēlaties pievienot lietotāju, kas pašlaik nav jūsu organizācijā, vispirms viņš jāpievieno organizācijai (varat atstāt izvēles rūtiņu „Pievienot noklusējuma projektam” neatzīmētu, ja nevēlaties šiem lietotājiem piešķirt plašāku piekļuvi). Šajā sarakstā netiks iekļauti pakalpojumu konti. Šajā darbībā varat izvēlēties, vai viņu loma ir Owner vai Member:

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

Pievienojot komandas dalībnieku, jums viņam jāpiešķir Dalībnieka vai Īpašnieka loma. 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 projekta budžetus, kā arī pārvaldīt projekta dalībniekus. Papildinformāciju skatiet sadaļā lomas un atļaujas.

Kā izveidot pakalpojuma kontu projektam

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

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

Pēc tam dodieties uz saviem organizācijas iestatījumiem -> Projekts -> Dalībnieki -> noklikšķiniet uz + Service account:

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 nekavējoties tiek izveidota API atslēga, un tiks parādīta slepenā atslēga. Saglabājiet šo slepeno atslēgu drošā vietā. Drošības apsvērumu dēļ jūs to vairs nevarēsiet skatīt savā OpenAI kontā. Ja pazaudēsiet šo slepeno atslēgu, jums būs jāģenerē jauna.

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

Pakalpojuma konta API atslēgas atļaujām pēc noklusējuma ir lasīšanas un rakstīšanas piekļuve visiem projekta API resursiem. Šīs atļaujas var atjaunināt jūsu projekta API atslēgu iestatījumos.

Pakalpojumu konti ir uzskaitīti kopā ar projekta dalībniekiem jūsu projekta dalībnieku iestatījumu lapā. Lūdzu, skatiet šeit, lai uzzinātu vairāk par pakalpojuma konta piekļuves atjaunināšanu vai noņemšanu jūsu projekta dalībnieku iestatījumu lapā.

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 savas organizācijas projektos?

API atslēgas katram projektam varat izveidot un pārvaldīt attiecīgā projekta iestatījumu lapā. Savos organizācijas iestatījumos atlasiet projektu un noklikšķiniet uz API atslēgas.

Lai izveidotu jaunu slepeno atslēgu, atlasiet + Create new secret key. Varat arī atlasīt rediģēšanas ikonu blakus slepenajai atslēgai, lai rediģētu tās atļaujas.

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 iestatītas pilnas atļaujas. Šis ir noklusējuma iestatījums.

  • Ierobežotas — ļauj lietotājam katram galapunktam iestatīt atļaujas Nav, Lasīt un Rakstīt.

    • Piemēram, jūs izveidojat API atslēgu, kurai konkrēti nav atļaujas lasīt vai rakstīt 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 budžetus savas organizācijas projektiem?

Tikai organizācijas īpašnieki un projekta īpašnieki var iestatīt un pārvaldīt projekta budžetus. Papildinformāciju skatiet sadaļā lomas un atļaujas. Lai mainītu ierobežojumus organizācijas līmenī, savos organizācijas iestatījumos noklikšķiniet uz Ierobežojumi, un ritiniet lejup līdz Lietojuma ierobežojumi.

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

Lai iestatītu projekta ierobežojumus, savos organizācijas iestatījumos noklikšķiniet uz projekta, kuru vēlaties atjaunināt, un atlasiet Ierobežojumi. Varat atjaunināt Mēneša budžetu, Paziņojumu slieksni un Modeļu lietojumu.

Iestatot mēneša budžetu, varat noteikt mīkstus tēriņu sliekšņus savam projektam. Ja lietojums noteiktā kalendārajā mēnesī (UTC) pārsniedz šo ierobežojumu, API pieprasījumi turpinās tikt apstrādāti bez pārtraukuma. Šī funkcija ir paredzēta, lai palīdzētu pārraudzīt lietojumu ar budžeta brīdinājumiem, taču tā neievieš stingru tēriņu limitu. Kad tiek izveidots projekta budžets, pēc noklusējuma tiek izveidots brīdinājums pie 100% sliekšņa. Papildu budžetus ar dažādiem sliekšņiem var iestatīt, noklikšķinot uz Pievienot brīdinājumu.

Lūdzu, ņemiet vērā, ka organizācijas īpašnieks(-i) un projekta īpašnieks(-i) 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ā dzēst vai arhivēt projektu?

Projektus var arhivēt vai nu jaunajā projektu saraksta lapā, vai atsevišķa projekta iestatījumos. Kad projekts ir arhivēts, to nevar atjaunot. Turpinot arhivēšanu, jums tiks lūgts ievadīt projekta nosaukumu, lai varētu turpināt.

Visu arhivēto projektu sarakstu varat skatīt cilnē „Arhivēti” tajā pašā projektu saraksta lapā.

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

Projektus dzēst nav iespējams; mēs saglabājam visu projektu vēsturi, lai nodrošinātu lietojuma un norēķinu izsekošanas 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 failu glabātuves kvota vienam projektam?

OpenAI pašlaik atbalsta 100 GB failu glabātuves kvotu vienam projektam.

Ja šī kvota tiek 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 saistīta ar lietotāja lomu projektā. Tā vietā to nosaka jūsu loma organizācijā un iestatījumi vietnē https://platform.openai.com/settings/organization/data-controls/visibility

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

Ja nevarat redzēt lietojuma informācijas paneli, šis iestatījums, visticamāk, ir iestatīts uz „Redzams organizācijas īpašniekiem”.

Vai šis raksts bija noderīgs?