A projektek célja, hogy az ügyfelek rendszerezhessék a munkájukat. A szervezetek kezelhetik a hozzáférést és a limiteket, szolgáltatásfiókokat hozhatnak létre (a felhasználói felületen keresztül), és nyomon követhetik a használatot egy projekten belüli korlátozott hatókörben (pl. modellek, képességek, szálak, asszisztensek, finomhangolás, tárhely stb.). A használati tevékenység projektenként bontható, a felhasználók pedig projektenként megtekinthetik a számlázást és beállíthatják a költési limiteket.
A szervezettulajdonosok az összes aktív és archivált projektjüket megtekinthetik a Projektek oldalon. Tudjon meg többet az API Platform felhasználói szerepköreiről és jogosultságairól.
Ki hozhat létre projektet?
Csak a szervezet tulajdonosai hozhatnak létre projektet. További információért tekintse meg a szerepköröket és engedélyeket.
A szervezetek közötti váltáshoz vigye az egérmutatót az oldal bal felső részén található szervezetnévre, majd válassza ki a szervezetet a listából:
Az összevont számlázási csomagot használó szervezeteknél az alszervezetek külön vannak megjelölve. Alszervezeteken belül nem hozhatók létre projektek.
Hogyan működnek a projektek?
Minden szervezet rendelkezik egy „Alapértelmezett projekttel”, amely nem törölhető. Beállíthatja a sebességkorlátokat, a virtuális modellek engedélyeit és a költési korlátokat (2024 novemberétől). A szervezet teljes konfigurációját örökli, ezért közvetlenül nem adhat hozzá tagokat vagy szolgáltatásfiókokat.
Hogyan hozhatok létre projektet?
Először vigye az egérmutatót az oldal bal sarkában található projektnévre, majd válassza a Projekt létrehozása lehetőséget.
Adja meg a projekt nevét, leírását és webhelyét, majd válassza a Létrehozás lehetőséget.
Hogyan adhatok felhasználókat egy projekthez?
Az újonnan hozzáadott szervezeti tagok nem kerülnek be automatikusan az „Alapértelmezett projektbe”. Az új tagok a szervezetbe való meghívásukkor (a "Meghívás az alapértelmezett projektbe" jelölőnégyzet bejelölésével), illetve a szervezeti meghívás elfogadása után hívhatók meg a projektbe.
Az Admin API-n keresztül meghívott felhasználókra az /organization/invites végpontnál ismertetett szabályok vonatkoznak.
Ha hiba történik, amikor a felhasználókat a felhasználói felületen vagy az Admin API-n keresztül meghívja egy projektbe, a meghívás újbóli elküldése előtt ellenőrizze, hogy a célprojekt létezik-e, és nincs-e archiválva.
A szervezet tulajdonosai automatikusan tulajdonosként kerülnek be a szervezeten belül létrehozott új projektekbe.
Milyen felhasználói szerepkörök vannak a szervezeteken és projekteken belül, és milyen engedélyek tartoznak hozzájuk?
Míg a szervezetekben „tulajdonos” és „olvasó” szerepkör van, a projektekben „tulajdonos” és „tag” szerepkör használható. A projekttagok a szervezeti olvasóknak felelnek meg. Az alábbi táblázat részletesebben ismerteti az egyes felhasználói szerepkörökhöz tartozó engedélyeket.
| Szerepkör | Hatókör | Leírás |
|---|---|---|
| Tulajdonos | Szervezet | Létrehozhatja és megtekintheti az összes projektet, felhasználót és API-kulcsot. A szervezet összes projektjét figyelemmel kísérheti a Projektek oldalon . Beállíthatja a szervezet és a projektek költési korlátait. Engedélyt adhat más szervezeti tagoknak a használati adatok megtekintésére. Archiválhat projekteket. |
| Olvasó | Szervezet | Következtetést végezhet, erőforrásokat használhat és kulcsokat hozhat létre a projektjeiben. Hozzáadható projektekhez. Nem hozhat létre projekteket, és nem kezelhet felhasználókat. |
| Tulajdonos | Projekt | Más felhasználókat adhat a projekthez, átnevezheti a projektet, és rendelkezik a Tag minden jogosultságával. Beállíthatja a projekt költési korlátait. Archiválhatja a projektet. |
| Tag | Projekt | Projektszinten következtetést végezhet, erőforrásokat használhat és kulcsokat hozhat létre. |
Mihez férek hozzá, ha nem vagyok a szervezet Tulajdonosa?
A szervezetben Tulajdonos szerepkörrel nem rendelkező felhasználók csak azokat a projekteket láthatják, amelyeknek tagjai. Csak a szervezet tulajdonosa láthatja az összes projektet, projektszintű tagot és API-kulcsot, illetve csak ő férhet hozzá a Projektek oldalhoz.
Csak a projekt tagjai és a szervezet tulajdonosai láthatják a projektben létrehozott finomhangolt modelleket, a létrehozott Asszisztensek szálait és a hozzáadott fájlokat.
A projekt tagjai láthatják a projekt összes többi tagját és azok szerepkörét (például Tulajdonos vagy Tag).
Hogyan módosíthatom egy felhasználó projektszerepkörét, illetve hogyan távolíthatom el a projektből?
Csak a projekt tulajdonosa módosíthatja egy felhasználó projektszerepkörét, illetve távolíthatja el a projektből. További információért tekintse meg a szerepköröket és engedélyeket.
A projekt egyik felhasználójának módosításához nyissa meg a szervezeti beállításokat, válassza ki a projektet, majd kattintson a Tagok elemre. Minden tag szerepkörét Tag vagy Tulajdonos értékre állíthatja. A felhasználó projektből való eltávolításához a Eltávolítás lehetőséget is választhatja.
Mi az a szolgáltatásfiók, és miben különbözik a hagyományos felhasználói fióktól?
A szolgáltatásfiók rendszerhozzáférésre tervezett pszeudofelhasználóként működik, és elkülönül az egyéni felhasználói fiókoktól. Csak a szervezet és a projekt tulajdonosai hozhatnak létre szolgáltatásfiókokat.
A szolgáltatásfiókok csak projektekhez vannak kötve.
Tag hozzáadása egy projekthez
A + Tag hozzáadása gombra kattintva megjelenik a szervezet Olvasó szerepkörű felhasználóinak listája. Ha olyan felhasználót szeretne hozzáadni, aki jelenleg nem tagja a szervezetének, először fel kell vennie a szervezetbe (ha nem szeretne szélesebb körű hozzáférést adni neki, hagyja üresen a 'Hozzáadás az alapértelmezett projekthez" jelölőnégyzetet). A lista nem tartalmazza a szolgáltatásfiókokat. Ebben a lépésben kiválaszthatja, hogy a szerepköre Tulajdonos vagy Tag legyen:
Csapattag hozzáadásakor a Tag vagy a Tulajdonos szerepkört kell hozzárendelnie. A projekttagok az adatok olvasására vagy módosítására szolgáló API-kéréseket indíthatnak, a projekttulajdonosok pedig ezenfelül módosíthatják a projekt beállításait és költési korlátait, valamint kezelhetik a projekttagokat. További információért tekintse meg a szerepköröket és engedélyeket.
Szolgáltatásfiók létrehozása egy projekthez
Először nyissa meg azt a projektet, amelyhez szolgáltatásfiókot szeretne létrehozni. Ehhez válassza ki a navigációs sáv legördülő listájából:
Ezután nyissa meg a szervezeti beállításokat -> Projekt -> Tagok -> majd kattintson a + Szolgáltatásfiók elemre:
A projekt szintjén létrehozott szolgáltatásfiókok egyediek az adott projekthez, és nem használhatók azon a projekten kívül, amelyben létrehozták őket.
A szolgáltatásfiók elnevezése
Akár szervezeti szinten, akár kizárólag egy projekthez hozza létre a szolgáltatásfiókot, a létrehozásakor betűkből, számokból és kötőjelekből álló egyedi szolgáltatásfiók-azonosítót adhat meg, amellyel könnyen azonosíthatja a fiókot.
A szolgáltatásfiók API-kulcsának mentése
A Létrehozás gomb kiválasztása után azonnal létrejön a szolgáltatásfiók API-kulcsa, és megjelenik a titkos kulcs. Mentse ezt a titkos kulcsot biztonságos helyre. Biztonsági okokból később nem tekintheti meg újra az OpenAI-fiókjában. Ha elveszíti ezt a titkos kulcsot, újat kell létrehoznia.
A szolgáltatásfiók API-kulcsa alapértelmezés szerint olvasási és írási engedéllyel rendelkezik a projekt összes API-erőforrásához. Ezek az engedélyek a projekt API-kulcsokra vonatkozó beállításaiban módosíthatók.
A szolgáltatásfiókok a projekttagok mellett jelennek meg a projekt tagbeállítási oldalán. A szolgáltatásfiók hozzáférésének módosításáról vagy eltávolításáról a projekt tagbeállítási oldalán itt talál további információt.
A projektekhez és szervezetekhez tartozó összes szolgáltatásfiók az emberi felhasználók mellett jelenik meg a szervezeti szintű tagok oldalán.
A szolgáltatásfiókok a normál fiókokhoz hasonlóan kezelhetők. A Szervezet -> Tagok menüből eltávolíthat egy szolgáltatásfiókot, vagy frissítheti a szerepkörét:
Hogyan kezelhetem az API-kulcsokat a szervezetem projektjeiben?
Az egyes projektek API-kulcsait az adott projekt beállítási oldalán hozhatja létre és kezelheti. A szervezeti beállításokban válassza ki a projektet, majd kattintson az API-kulcsok elemre.
Új titkos kulcs létrehozásához válassza az + Új titkos kulcs létrehozása lehetőséget. A titkos kulcs melletti Szerkesztés ikont választva az engedélyeit is módosíthatja.
Az egyes API-kulcsok engedélyeit új titkos kulcs létrehozásakor vagy egy meglévő kulcs szerkesztésével állíthatja be.
Három engedélyszint érhető el: Összes, Korlátozott és Csak olvasás.
Összes — A titkos kulcs teljes körű engedélyeket kap. Ez az alapértelmezett beállítás.
Korlátozott — Lehetővé teszi, hogy a felhasználó minden végponthoz Nincs, Olvasás vagy Írás engedélyt állítson be.
Létrehozhat például olyan API-kulcsot, amely kifejezetten nem rendelkezik olvasási vagy írási engedéllyel a /v1/assistants végponthoz:
Csak olvasás — Minden végponthoz olvasási engedély van beállítva.
Hogyan kezelhető a több projekthez vagy szervezethez tartozó felhasználók hozzáférése?
A felhasználók tetszőleges számú projekt tagjai lehetnek. A felhasználók egy projekten belül olyan személyes API-kulcsot hozhatnak létre, amelynek hatóköre és hozzáférése az adott projektre és annak erőforrásaira korlátozódik.
Hogyan állíthatom be és kezelhetem a szervezetem projektjeinek sebességkorlátait?
A projektszintű sebességkorlátokat csak a szervezet tulajdonosa állíthatja be és kezelheti. További információért tekintse meg a szerepköröket és engedélyeket.
A szervezeti beállításokban kattintson a módosítani kívánt projektre, majd a navigációs lista Projekt részében válassza a Korlátok lehetőséget. Ezen az oldalon módosíthatja a Modellhasználatot.
A Modellhasználat résznél beállíthatja, hogy a projekt mely modelleket használhatja, a sebességkorlátokat pedig szükség szerint modellenként adhatja meg.
Hogyan állíthatom be és kezelhetem a szervezetem projektjeinek költési korlátait?
A projektek költési korlátait csak a szervezet és az adott projekt tulajdonosai állíthatják be és kezelhetik. További információért tekintse meg a szerepköröket és engedélyeket. A szervezeti szintű korlátok módosításához nyissa meg a szervezeti beállításokat, kattintson a Korlátok elemre, majd görgessen le a Használati korlátok részhez.
A projekt korlátainak beállításához nyissa meg a szervezeti beállításokat, kattintson a módosítani kívánt projektre, majd válassza a Korlátok lehetőséget. Módosíthatja a Havi költési korlátot, az Értesítési küszöbértéket és a Modellhasználatot.
A havi költési korlát beállításával rugalmas költési küszöbértéket határozhat meg a projekthez. Ha a használat egy adott naptári hónapban (UTC szerint) túllépi ezt a korlátot, az API-kérések feldolgozása megszakítás nélkül folytatódik. Ez a funkció költésikorlát-riasztásokkal segíti a használat figyelését, de nem érvényesít szigorú költési plafont. A projekt költési korlátjának létrehozásakor alapértelmezés szerint a 100%-os küszöbértékhez jön létre riasztás. A Riasztás hozzáadása elemre kattintva további riasztásokat állíthat be más küszöbértékekhez.
Felhívjuk figyelmét, hogy ezeket az üzeneteket mindig megkapják a szervezet és a projekt tulajdonosai, és ez nem szabható személyre.
Hogyan állíthatok be költési korlátokat a szervezetemhez vagy a projektemhez?
Az OpenAI mostantól szervezeti és projektszinten is támogatja a havi API-költési korlátokat. A költési korlát csak figyelheti a kiadásokat, de szigorú korlátként is érvényesíthető, hogy a keret elérése után az API-kérések sikertelenek legyenek. A legújabb beállítási lépéseket és működési részleteket a fejlesztői dokumentáció Költési korlátok című részében találja.
Hogyan törölhetek vagy archiválhatok egy projektet?
A projektek az új projektlista oldalán vagy az adott projekt beállításaiban archiválhatók. Az archivált projektek nem állíthatók vissza. Az archiválás folytatásához meg kell adnia a projekt nevét.
Az összes archivált projekt listáját ugyanezen a projektlista oldalon, az „Archivált” lapon tekintheti meg.
A projektek nem törölhetők. A használat és a számlázás folyamatos nyomon követése érdekében minden projekt előzményét megőrizzük.
Van korlátozás arra, hogy hány projekt lehet a szervezetemben?
A szervezetek alapértelmezés szerint legfeljebb 2000 projektet hozhatnak létre.
Megoszthatók az erőforrások a projektek között?
A projekterőforrások (például fájlok, asszisztensek, tárhely vagy szálak) az adott projekthez tartoznak, és a projekten kívüli, nem rendszergazda tagok nem férhetnek hozzájuk. Ezenkívül az erőforrások nem helyezhetők át a projektek között.
Az egyetlen kivétel az, hogy az „Alapértelmezett projektben” lévő finomhangolások más projektekből is elérhetők.
Mekkora a fájltárolási kvóta projektenként?
Az OpenAI jelenleg projektenként 100 GB-os fájltárolási kvótát támogat.
A kvóta túllépésekor a következő hiba jelenik meg:
Túllépte a fájltárolási kvótát. A szervezetek legfeljebb 100 GB fájlt tárolhatnak. Kérjük, csökkentse a fájl méretét, vagy lépjen kapcsolatba az ügyfélszolgálattal.Javasoljuk, hogy törölje a fiókjában tárolt, nem használt fájlokat. Tájékoztatásul: az API-val megtekintheti és listázhatja a fájlokat.
Projekttulajdonos vagyok. Miért nem látom a projektem Használati irányítópultját?
A projekt Használati irányítópultjának láthatósága nem függ a felhasználó projekten belüli szerepkörétől. Ehelyett a szervezeten belüli szerepköre és a https://platform.openai.com/settings/organization/data-controls/visibility oldalon megadott beállítások határozzák meg.
Ha nem látja a Használati irányítópultot, ez a beállítás valószínűleg a "Szervezeti tulajdonosok számára látható" értékre van állítva.