Projektien tarkoitus on auttaa asiakkaita organisoimaan 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, avustajat, hienosäätö, tallennustila jne.). Käyttötoiminnan voi eritellä projekteittain, ja käyttäjät voivat tarkastella laskutusta ja määrittää kulutusrajat projektikohtaisesti.
Organisaation omistajat voivat tarkastella kaikkia aktiivisia ja arkistoituja projektejaan Projektit-sivulla. Lue lisää aiheesta API-alusta: käyttäjäroolit ja käyttöoikeudet.
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:
Niissä organisaatioissa, joilla on yhdistetty laskutussuunnitelma, aliorganisaatiot tunnistetaan erikseen. Projekteja ei voi luoda aliorganisaatioissa.
Miten projektit toimivat?
Jokaiseen organisaatioon kuuluu ”Oletusprojekti”, jota ei voi poistaa. Voit määrittää nopeusrajoitukset, virtuaalisten mallien käyttöoikeudet ja kulutusrajat (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 yläkulmassa olevan projektin nimen päälle ja valitse Luo projekti.
Anna projektille nimi, kuvaus ja verkkosivusto ja valitse sitten Luo.
Miten lisään käyttäjiä projektiin?
Organisaatioon lisättyjä uusia jäseniä ei lisätä automaattisesti ”Oletusprojektiin”. Uudet jäsenet voidaan kutsua projektiin joko organisaatiokutsun yhteydessä (valitsemalla ”Kutsu oletusprojektiin” -valintaruutu) tai sen jälkeen, kun jäsen on hyväksynyt organisaatiokutsun.
Admin API:n kautta kutsuttuihin käyttäjiin sovelletaan /organization/invites-endpointin sääntöjä.
Jos käyttäjien kutsuminen projektiin käyttöliittymän tai Admin API:n kautta aiheuttaa virheen, varmista ennen kutsun lähettämistä uudelleen, että kohdeprojekti on olemassa eikä sitä ole arkistoitu.
Organisaation omistajat lisätään automaattisesti omistajiksi organisaatiossa luotuihin uusiin projekteihin.
Mitä eri käyttäjärooleja organisaatioissa ja projekteissa on, ja mitä käyttöoikeuksia niihin kuuluu?
Organisaatioissa on ”omistaja”- ja ”lukija”-roolit, kun taas projekteissa on ”omistaja”- ja ”jäsen”-roolit. Projektin jäsenet vastaavat organisaation lukijoita. Alla olevassa taulukossa kuvataan tarkemmin, mitä käyttöoikeuksia kuhunkin käyttäjärooliin kuuluu.
| Rooli | Laajuus | Kuvaus |
|---|---|---|
| Omistaja | Organisaatio | Voi luoda ja tarkastella kaikkia projekteja, kaikkia käyttäjiä ja kaikkia API-avaimia. Voi seurata kaikkia organisaation projekteja Projektit-sivulla . Voi määrittää organisaation kulutusrajat ja projektien kulutusrajat. Voi myöntää muille organisaation jäsenille oikeuden tarkastella käyttötietoja. Voi arkistoida projekteja. |
| Lukija | Organisaatio | Voi suorittaa inferenssiä, käyttää resursseja ja luoda avaimia omissa projekteissaan. Voidaan lisätä projekteihin. Ei voi luoda projekteja eikä hallita käyttäjiä. |
| Omistaja | Projekti | Voi lisätä projektiin muita käyttäjiä ja nimetä projektin uudelleen sekä käyttää kaikkia jäsenen toimintoja. Voi määrittää projektin kulutusrajat. Voi arkistoida projektin. |
| Jäsen | Projekti | Voi suorittaa inferenssiä, käyttää resursseja ja luoda avaimia projektitasolla. |
Mihin minulla on käyttöoikeus, jos en ole organisaation omistaja?
Käyttäjät, jotka eivät ole organisaation omistajia, näkevät vain projektit, joiden jäseniä he ovat. Vain organisaation omistaja näkee kaikki projektit, jäsenet ja projektitason API-avaimet sekä pääsee Projektit-sivulle.
Vain projektin jäsenet ja organisaation omistajat näkevät projektissa luodut hienosäädetyt mallit, luotujen Assistantien keskusteluketjut ja lisätyt tiedostot.
Projektin jäsenet näkevät kaikki muut projektin jäsenet ja heidän roolinsa (esimerkiksi 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. Lisätietoja on kohdassa roolit ja käyttöoikeudet.
Voit päivittää projektin käyttäjää siirtymällä organisaation asetuksiin, valitsemalla projektin ja napsauttamalla Jäsenet. Voit määrittää kunkin jäsenen rooliksi Jäsen tai Omistaja. 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.
Jäsenen lisääminen projektiin
Kun napsautat + Lisää jäsen -painiketta, näet luettelon organisaatiosi käyttäjistä, joiden rooli on Lukija. Jos haluat lisätä käyttäjän, joka ei vielä kuulu organisaatioosi, hänet on ensin lisättävä organisaatioon. Voit jättää ”Lisää oletusprojektiin” -valintaruudun valitsematta, ellet halua antaa käyttäjälle laajempia käyttöoikeuksia. Luettelossa ei näytetä palvelutilejä. Tässä vaiheessa voit valita käyttäjän rooliksi joko Omistaja tai Jäsen:
Kun lisäät tiimin jäsenen, hänen roolikseen on määritettävä joko Jäsen tai Omistaja. Projektin jäsenet voivat tehdä API-pyyntöjä, jotka lukevat tai muokkaavat tietoja. Projektin omistajat voivat lisäksi muuttaa projektin asetuksia ja kulutusrajoja sekä hallita projektin jäseniä. Lisätietoja on kohdassa roolit ja käyttöoikeudet.
Palvelutilin luominen projektille
Siirry ensin projektiin, jolle haluat luoda palvelutilin, valitsemalla se siirtymispalkin avattavasta valikosta:
Siirry sitten kohtaan Organisaation asetukset -> Projekti -> Jäsenet ja napsauta + Palvelutili:
Projektitasolla luodut palvelutilit ovat projektikohtaisia, eikä niitä voi käyttää sen projektin ulkopuolella, jossa ne on luotu.
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 valitset Luo-painikkeen, palvelutilille luodaan heti API-avain ja salainen avain tulee näkyviin. Tallenna salainen avain turvalliseen paikkaan. Tietoturvasyistä et voi tarkastella sitä enää myöhemmin OpenAI-tilisi kautta. Jos kadotat salaisen avaimen, sinun on luotava uusi.
Palvelutilin API-avaimella on oletusarvoisesti kaikkien projektin API-resurssien luku- ja kirjoitusoikeudet. Näitä käyttöoikeuksia voi päivittää projektin API-avainten asetuksissa.
Palvelutilit näkyvät projektin jäsenten rinnalla projektin jäsenasetussivulla. Katso täältä lisätietoja palvelutilin käyttöoikeuksien päivittämisestä tai poistamisesta projektin 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:
Miten hallitsen API-avaimia organisaationi projekteissa?
Voit luoda ja hallita kunkin projektin API-avaimia projektin asetussivulla. Siirry organisaation asetuksiin, valitse projekti ja napsauta API-avaimet.
Luo uusi salainen avain valitsemalla + Luo uusi salainen avain. Voit muokata salaisen avaimen käyttöoikeuksia myös valitsemalla sen vieressä olevan Muokkaa-kuvakkeen.
Voit määrittää kunkin API-avaimen käyttöoikeudet luodessasi uuden salaisen avaimen tai muokkaamalla olemassa olevaa avainta.
Käytettävissä on kolme käyttöoikeustasoa: Kaikki, Rajoitettu ja Vain luku.
Kaikki — Salaiselle avaimelle annetaan täydet käyttöoikeudet. Tämä on oletusasetus.
Rajoitettu — Käyttäjä voi määrittää kullekin endpointille käyttöoikeudeksi Ei mitään, Luku tai Kirjoitus.
Voit esimerkiksi luoda API-avaimen, jolla ei ole erikseen luku- tai kirjoitusoikeutta /v1/assistants-endpointiin:
Vain luku — Kaikille endpointeille annetaan lukuoikeudet.
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 organisaationi projektien kulutusrajat ja hallitsen niitä?
Vain organisaation omistajat ja projektin omistajat voivat määrittää projektin kulutusrajoja ja hallita niitä. Lisätietoja on kohdassa roolit ja käyttöoikeudet. Voit muuttaa organisaatiotason rajoja siirtymällä organisaation asetuksiin, napsauttamalla Rajat ja vierittämällä kohtaan Käyttörajat.
Voit määrittää projektin rajat siirtymällä organisaation asetuksiin, napsauttamalla päivitettävää projektia ja valitsemalla Rajat. Voit päivittää kuukausittaisen kulutusrajan, ilmoituskynnyksen ja mallien käytön.
Kuukausittaisella kulutusrajalla voit määrittää projektille joustavan kulutuskynnyksen. Kun käyttö ylittää tämän rajan tietyn kalenterikuukauden aikana (UTC), API-pyyntöjen käsittely jatkuu keskeytyksettä. Ominaisuus auttaa seuraamaan käyttöä kulutusrajahälytysten avulla, mutta se ei aseta kulutukselle ehdotonta ylärajaa. Kun projektille luodaan kulutusraja, oletusarvoisesti luodaan hälytys 100 prosentin kynnykselle. Voit määrittää lisähälytyksiä eri kynnyksille napsauttamalla Lisää hälytys.
Huomaa, että organisaation ja projektin omistajat saavat aina nämä viestit, eikä tätä voi mukauttaa.
Miten määritän kulutusrajat organisaatiolle tai projektille?
OpenAI tukee nyt kuukausittaisia API-kulutusrajoja sekä organisaatio- että projektitasolla. Kulutusraja voi seurata kulutusta ilman valvottua rajoitusta, tai voit ottaa sen käyttöön ehdottomana rajana, jolloin API-pyynnöt epäonnistuvat, kun kulutus saavuttaa rajan. Uusimmat määritysohjeet ja toimintatavat ovat kehittäjädokumentaation kohdassa Kulutusrajat.
Miten poistan tai arkistoin projektin?
Projektin voi arkistoida joko uudella projektiluettelosivulla tai yksittäisen projektin asetuksissa. Arkistoitua projektia ei voi palauttaa. Kun jatkat arkistointia, sinua pyydetään vahvistamaan toiminto antamalla projektin nimi.
Näet kaikki arkistoidut projektit saman projektiluettelosivun ”Arkistoidut”-välilehdellä.
Projekteja ei voi poistaa. Säilytämme kaikkien projektien historian, jotta käytön ja laskutuksen seuranta pysyy yhtenäisenä.
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 projektikohtainen tiedostotallennustilan kiintiö?
OpenAI tukee tällä hetkellä 100 gigatavun projektikohtaista tiedostotallennustilan kiintiötä.
Jos tämä kiintiö ylittyy, näet seuraavan 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 hallintapaneelia?
Projektin Käytön hallintapaneelin näkyvyys ei riipu käyttäjän roolista projektissa. Sen määräävät sen sijaan roolisi organisaatiossa ja asetukset osoitteessa https://platform.openai.com/settings/organization/data-controls/visibility
Jos et näe Käytön hallintapaneelia, tämän asetuksen arvona on todennäköisesti ”Näkyy organisaation omistajille”.