OpenAI
Tämä sivu on konekäännetty. Katso alkuperäinen englanninkielinen artikkeli.

Projektien hallinta API-alustalla

Päivitetty: 8 days ago

Projektien tarkoituksena on tarjota asiakkaille mahdollisuus järjestää työnsä. Organisaatiot voivat hallita käyttöoikeuksia ja rajoja, valmistella palvelutilejä (käyttöliittymän kautta) ja seurata käyttöä projektin rajatussa laajuudessa (esim. mallit, ominaisuudet, säikeet, assistentit, hienosäätö, tallennustila jne.). Käyttötoiminta voidaan eritellä projekteittain, ja käyttäjät voivat tarkastella laskutusta ja määrittää budjetteja projektikohtaisesti.

Organisaation omistajat voivat tarkastella kaikkia aktiivisia ja arkistoituja projektejaan Projektit-sivulla. Lue lisää API-alustan käyttäjärooleista ja käyttöoikeuksista.

Image

Kuka voi luoda projektin?

Vain organisaation omistajat voivat luoda projektin. Katso lisätietoja kohdasta roolit ja käyttöoikeudet.

Voit vaihtaa organisaatiosta toiseen viemällä osoittimen sivun vasemmassa yläkulmassa olevan organisaation nimen päälle ja valitsemalla organisaation luettelosta:

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

Niissä organisaatioissa, joilla on yhdistetty laskutussuunnitelma, aliorganisaatiot tunnistetaan erikseen. Projekteja ei voi luoda aliorganisaatioissa.

Image

Miten projektit toimivat?

Jokaisessa organisaatiossa on “Oletusprojekti”, jota ei voi poistaa. Voit määrittää nopeusrajoitukset, virtuaalimallien käyttöoikeudet ja kulutusbudjetit (marraskuusta 2024 alkaen). Se perii organisaation koko määrityksen, joten et voi lisätä siihen suoraan jäseniä tai palvelutilejä.

Miten luon projektin?

Vie ensin osoitin sivun vasemmassa kulmassa olevan projektin nimen päälle ja valitse Create project.

API platform project menu with Create project highlighted under Default project

Anna projektille nimi, kuvaus ja verkkosivusto ja valitse sitten Create.

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

Miten lisään käyttäjiä projektiin?

Uusia organisaation jäseniä ei lisätä automaattisesti oletusprojektiin. Uudet jäsenet voidaan kutsua projektiin joko silloin, kun heidät kutsutaan organisaatioon (ottamalla käyttöön valintaruutu ”Kutsu oletusprojektiin”), tai sen jälkeen, kun jäsen on hyväksynyt organisaatiokutsun.

Admin API:n kautta kutsutut käyttäjät noudattavat sääntöjä, jotka on kuvattu kohteessa /organization/invites-endpoint.

Jos käyttäjien kutsuminen projektiin käyttöliittymän tai Admin API:n kautta aiheuttaa virheen, varmista ensin ennen kutsun uudelleenlähetystä, että kohdeprojekti on olemassa eikä sitä ole arkistoitu.

Organisaation omistajat lisätään automaattisesti omistajiksi organisaatiossa luotaviin uusiin projekteihin.

Mitä eri käyttäjärooleja organisaatioissa ja projekteissa on, ja mitä käyttöoikeuksia niihin sisältyy?

Siinä missä organisaatioilla on omistaja- ja lukijaroolit, projekteilla on omistaja- ja jäsenroolit. Projektin jäsenet vastaavat organisaation lukijoita. Alla olevassa taulukossa on tarkempi kuvaus kunkin käyttäjäroolin käyttöoikeuksista.

RooliLaajuusKuvaus
OmistajaOrganisaatioVoi luoda ja tarkastella kaikkia projekteja, kaikkia käyttäjiä ja kaikkia API-avaimia. Voi seurata kaikkia organisaation projekteja

Projektit-sivun
avulla. Voi määrittää organisaation budjetteja ja projektibudjetteja. Voi myöntää muille organisaatiossa oikeuden tarkastella käyttötietoja. Voi arkistoida projekteja.
LukijaOrganisaatioVoi suorittaa päättelyä, käyttää resursseja ja luoda avaimia omissa projekteissaan. Voidaan lisätä projekteihin.
Ei voi luoda projekteja eikä hallinnoida käyttäjiä.
OmistajaProjektiVoi lisätä muita käyttäjiä projektiin ja nimetä projektin uudelleen sekä käyttää kaikkia jäsenen oikeuksia. Voi määrittää projektibudjetteja. Voi arkistoida projektin.
JäsenProjektiVoi suorittaa päättelyä, käyttää resursseja ja luoda avaimia projektitasolla.

Jos en ole organisaation omistaja, mihin minulla on käyttöoikeus?

Käyttäjät, jotka eivät ole organisaation omistajia, näkevät vain projektit, joiden jäseniä he ovat. Vain organisaation omistaja voi nähdä kaikki projektit, jäsenet ja API-avaimet projektitasolla sekä käyttää Projektit-sivua.

  • Vain projektin jäsenet (ja organisaation omistajat) voivat nähdä kyseisessä projektissa luodut hienosäädetyt mallit, luotujen Assistenttien säikeet tai lisätyt tiedostot.

  • Projektin jäsenet voivat nähdä, keitä projektin muut jäsenet ovat ja mitkä heidän roolinsa ovat (eli Omistaja tai Jäsen).

Miten päivitän käyttäjän projektiroolin tai poistan käyttäjän projektista?

Vain projektin omistaja voi päivittää käyttäjän projektiroolin tai poistaa käyttäjän projektista. Katso lisätietoja kohdasta roolit ja käyttöoikeudet.

Päivitä käyttäjä projektissa siirtymällä organisaatioasetuksiin, valitsemalla projekti ja napsauttamalla Jäsenet. Voit määrittää kunkin jäsenen rooliksi Jäsenen tai Omistajan. Voit myös poistaa käyttäjän projektista valitsemalla Poista.

Mikä on palvelutili, ja miten se eroaa tavallisesta käyttäjätilistä?

Palvelutili toimii järjestelmäkäyttöön suunniteltuna pseudokäyttäjänä ja eroaa yksittäisistä käyttäjätileistä. Vain organisaation ja projektin omistajat voivat luoda palvelutilejä.

Palvelutilit on rajattu vain projekteihin.

Lisää jäsen projektiin

Jos napsautat + Add member -painiketta, näet luettelon organisaatiosi käyttäjistä, joiden rooli on Reader. Jos haluat lisätä käyttäjän, joka ei tällä hetkellä kuulu organisaatioosi, sinun on ensin lisättävä hänet organisaatioon (voit jättää valintaruudun ”Lisää oletusprojektiin” valitsematta, jos et halua antaa näille käyttäjille laajempaa käyttöoikeutta). Tässä luettelossa ei näy palvelutilejä. Tässä vaiheessa voit valita, onko heidän roolinsa joko Owner vai Member:

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

Kun lisäät tiimin jäsenen, sinun on annettava hänelle rooliksi joko Jäsen tai Omistaja. Projektin jäsenet voivat tehdä API-pyyntöjä, jotka lukevat tai muokkaavat tietoja, kun taas projektin omistajat voivat myös muokata projektin asetuksia ja budjetteja sekä hallita projektin jäseniä. Katso lisätietoja kohdasta roolit ja käyttöoikeudet.

Palvelutilin luominen projektille

Siirry ensin projektiin, jolle haluat luoda palvelutilin, valitsemalla se navigointipalkin avattavasta valikosta:

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

Siirry sitten organisaatioasetuksiin -> Projekti -> Jäsenet -> napsauta + Service account:

Projektitasolla luodut palvelutilit ovat projektikohtaisia, eikä niitä voi käyttää sen projektin ulkopuolella, jossa ne on luotu.

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

Palvelutilin nimeäminen

Riippumatta siitä, luotko palvelutilin organisaatiotasolla vai projektille yksilöllisen tilin, voit luoda palvelutilille yksilöllisen tunnuksen, joka koostuu kirjaimista, numeroista ja väliviivoista, jotta palvelutili on helppo tunnistaa.

Tallenna palvelutilin API-avain

Kun olet valinnut Luo-painikkeen, palvelutilille luodaan heti API-avain ja salainen avain näytetään. Tallenna tämä salainen avain turvalliseen paikkaan. Tietoturvasyistä et voi tarkastella sitä uudelleen OpenAI-tilisi kautta. Jos kadotat tämän salaisen avaimen, sinun on luotava uusi.

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

Palvelutilin API-avaimen käyttöoikeudet ovat oletusarvoisesti luku- ja kirjoitusoikeudet kaikkiin projektin API-resursseihin. Näitä käyttöoikeuksia voi päivittää projektisi API-avainten asetuksissa.

Palvelutilit luetellaan projektin jäsenten rinnalla projektisi jäsenasetussivulla. Katso täältä lisätietoja palvelutilin käyttöoikeuden päivittämisestä tai poistamisesta projektisi jäsenasetussivulla.

Kaikki sekä projektien että organisaatioiden palvelutilit näytetään ihmiskäyttäjiesi rinnalla organisaatiotason jäsensivulla.

Palvelutilejä hallinnoidaan tavallisten tilien tapaan. Organisaatio -> Jäsenet-valikosta voit poistaa palvelutilin tai päivittää roolin:

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

Miten hallinnoin API-avaimia organisaationi projekteissa?

Voit luoda ja hallinnoida kunkin projektin API-avaimia kyseisen projektin asetussivulla. Valitse organisaatioasetuksissa projekti ja napsauta API-avaimet.

Luo uusi salainen avain valitsemalla + Create new secret key. Voit myös muokata salaisen avaimen käyttöoikeuksia valitsemalla sen vieressä olevan muokkauskuvakkeen.

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

Voit määrittää kunkin API-avaimesi käyttöoikeudet, kun luot uuden salaisen avaimen tai muokkaat olemassa olevaa avainta.

Käytettävissä on kolme käyttöoikeustasoa: Kaikki, Rajoitettu ja Vain luku.

  • Kaikki — Salaiselle avaimelle määritetään täydet käyttöoikeudet. Tämä on oletusasetus.

  • Rajoitettu — Antaa käyttäjän määrittää kullekin endpointille oikeudet Ei mitään, Luku ja Kirjoitus.

    • Luot esimerkiksi API-avaimen, jolla ei nimenomaisesti ole luku- tai kirjoitusoikeutta endpointiin /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Vain luku — Lukuoikeudet määritetään kaikille endpointeille.

Miten käyttöoikeuksia hallitaan käyttäjille, jotka kuuluvat useisiin projekteihin tai organisaatioihin?

Käyttäjät voivat olla jäseninä niin monessa projektissa kuin on tarpeen. Projektissa käyttäjät voivat luoda անձkohtaisen API-avaimen, joka on rajattu kyseiseen projektiin ja sen resursseihin.

Miten määritän ja hallinnoin organisaationi projektien pyyntörajoja?

Vain organisaation omistaja voi määrittää ja hallinnoida projektitason pyyntörajoja. Katso lisätietoja kohdasta roolit ja käyttöoikeudet.

Napsauta organisaatioasetuksissa projektia, jonka haluat päivittää, ja valitse navigointiluettelon Projekti-osiossa Rajat. Voit päivittää tällä sivulla kohdan Mallien käyttö.

Mallien käyttö antaa määrittää, mitä malleja projekti voi käyttää, ja pyyntörajat voidaan asettaa kullekin mallille tarpeen mukaan.

Miten määritän ja hallinnoin organisaationi projektien budjetteja?

Vain organisaation omistajat ja projektin omistajat voivat määrittää ja hallinnoida projektibudjetteja. Katso lisätietoja kohdasta roolit ja käyttöoikeudet. Jos haluat muuttaa rajoja organisaatiotasolla, napsauta organisaatioasetuksissa kohtaa Rajat, ja vieritä alas kohtaan Käyttörajat.

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

Määritä projektin rajat napsauttamalla organisaatioasetuksissa päivitettävää projektia ja valitsemalla Rajat. Voit päivittää kohdat Kuukausibudjetti, Ilmoituskynnys ja Mallien käyttö.


Kuukausibudjetin määrittäminen antaa sinun asettaa projektille pehmeät kulutuskynnykset. Kun käyttö ylittää tämän rajan tietyn kalenterikuukauden (UTC) aikana, API-pyyntöjen käsittely jatkuu keskeytyksettä. Tämä ominaisuus on suunniteltu auttamaan käytön seuraamisessa budjettihälytysten avulla, mutta se ei aseta kulutukselle kovaa ylärajaa. Kun projektibudjetti luodaan, hälytys luodaan oletusarvoisesti 100 %:n kynnykselle. Lisäbudjetteja eri kynnysarvoille voi määrittää napsauttamalla Lisää hälytys.

Huomaa, että organisaation omistajat ja projektin omistajat saavat aina nämä viestit, eikä tätä voi mukauttaa.

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

Miten poistan tai arkistoin projektin?

Projektit voidaan arkistoida joko uudella projektiluettelosivulla tai yksittäisen projektin asetuksissa. Kun projekti on arkistoitu, sitä ei voi palauttaa. Kun jatkat arkistointia, sinua pyydetään antamaan projektin nimi jatkaaksesi.

Voit tarkastella kaikkien arkistoitujen projektien luetteloa saman projektiluettelosivun Arkistoidut-välilehdellä.

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

Projektien poistaminen ei ole mahdollista. Säilytämme kaikkien projektien historian, jotta käytön ja laskutuksen seurannan jatkuvuus voidaan varmistaa.

Onko organisaatiossani olevien projektien määrälle rajoitusta?

Organisaatiot voivat oletusarvoisesti luoda enintään 2 000 projektia.

Voidaanko resursseja jakaa projektien välillä?

Projektin resurssit (kuten tiedostot, assistantit, tallennustila tai säikeet) on rajattu projektiin, eikä niihin pääse käsiksi projektin ulkopuoliset ei-admin-jäsenet. Lisäksi resursseja ei voi siirtää projektien välillä.

Yksi poikkeus on, että “Oletusprojektin” fine-tuneja voidaan käyttää muista projekteista.

Mikä on tiedostotallennuksen kiintiö projektia kohden?

OpenAI tukee tällä hetkellä 100 Gt:n tiedostotallennuskiintiötä projektia kohden.

Jos tämä kiintiö ylittyy, näet հետևavan virheen:

Olet ylittänyt tiedostotallennuskiintiösi. Organisaatiot on rajoitettu 100 Gt:n tiedostoihin. Pienennä tiedoston kokoa tai ota yhteyttä tukeen.

Suosittelemme poistamaan tilillesi tallennetut käyttämättömät tiedostot. Viitteeksi voit tarkastella ja listata tiedostoja API:n avulla.

Olen projektin omistaja. Miksi en näe projektini käytön koontinäyttöä?

Projektin käytön koontinäytön näkyvyys ei liity käyttäjän rooliin projektissa. Sen sijaan sen määrittävät roolisi organisaatiossa ja asetukset osoitteessa https://platform.openai.com/settings/organization/data-controls/visibility

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

Jos et näe käytön koontinäyttöä, tämän asetuksen arvoksi on todennäköisesti määritetty ”Näkyy organisaation omistajille”.

Oliko tästä artikkelista apua?