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 szervezeti tulajdonosok hozhatnak létre projektet. További információért tekintse meg a szerepkörök és engedélyek részt.
A szervezetek közötti váltáshoz vigye az egérmutatót a szervezet neve fölé az oldal bal felső részén, és válassza ki a szervezetet a listából:
Az összevont számlázási csomagban lévő szervezetek esetében az alszervezetek külön azonosítva vannak. Alszervezeteken belül nem hozhatók létre projektek.
Hogyan működnek a projektek?
Minden szervezet tartalmaz egy „Alapértelmezett projektet”, amely nem törölhető. Beállíthatja a sebességkorlátokat, a virtuális modelljogosultságokat és a költési limiteket (2024 novemberétől). Örökli a szervezet teljes konfigurációját, 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 felső sarkában látható projektnév fölé, 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 meghívhatók a projektbe a szervezetbe való meghívásukkor (a „Meghívás az alapértelmezett projektbe” jelölőnégyzet bejelölésével), vagy miután elfogadták a szervezeti meghívást.
Az Admin API-n keresztül meghívott felhasználókra a /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 hívja meg 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 szervezetekben és projektekben, és milyen jogosultságok tartoznak hozzájuk?
Míg a szervezetekben „tulajdonos” és „olvasó” szerepkörök vannak, a projektekben „tulajdonos” és „tag” szerepkörök érhetők el. A projekttagok a szervezeti olvasóknak felelnek meg. Az alábbi táblázatban részletesebben is láthatja, hogy az egyes felhasználói szerepkörökhöz milyen jogosultságok tartoznak.
| Szerepkör | Hatókör | Leírás |
|---|---|---|
| Tulajdonos | Szervezet | Létrehozhatja és megtekintheti az összes projektet, az összes felhasználót és az összes API-kulcsot. A szervezeten belüli összes projektet nyomon követheti a Projektek oldalon . Beállíthat szervezeti költési limiteket és projektköltési limiteket. Jogosultságot adhat mások használati információinak megtekintésére a szervezeten belül. Archiválhat projekteket. |
| Olvasó | Szervezet | Végrehajthat következtetést, használhat erőforrásokat, é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 képességével. Beállíthatja a projekt költési limitjeit. Archiválhatja a projektet. |
| Tag | Projekt | Projektszinten végrehajthat következtetést, használhat erőforrásokat, é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, projekttagot és API-kulcsot, valamint csak ő fér hozzá a Projektek oldalhoz.
Csak a projekt tagjai és a szervezet tulajdonosai láthatják a projektben létrehozott finomhangolt modelleket, az elkészített asszisztensek beszélgetésszá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, vagyis hogy Tulajdonosok vagy Tagok-e.
Hogyan módosíthatom egy felhasználó projektbeli szerepkörét, illetve hogyan távolíthatom el a projektből?
A felhasználók projektbeli szerepkörét csak a projekt tulajdonosa módosíthatja, és csak ő távolíthat el felhasználókat a projektből. További információt a szerepkörökről és engedélyekről szóló részben talál.
Egy projekt 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 lehetőségre. Minden tag szerepkörét Tag vagy Tulajdonos értékre állíthatja. A felhasználó projektből való eltávolításához az Eltávolítás lehetőséget is választhatja.
Mi az a szolgáltatásfiók, és miben különbözik egy normál felhasználói fióktól?
A szolgáltatásfiók egy rendszerszintű hozzáférésre tervezett pszeudo-felhasználó, amely különbözik az egyéni felhasználói fiókoktól. Szolgáltatásfiókokat csak a szervezet és a projekt tulajdonosai hozhatnak létre.
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 szervezetnek, először hozzá kell adnia a szervezethez. 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 listán nem szerepelnek szolgáltatásfiókok. Ebben a lépésben a felhasználó szerepköreként a Tulajdonos vagy a Tag lehetőséget választhatja:
Csapattag hozzáadásakor a Tag vagy a Tulajdonos szerepkört kell hozzárendelnie. A projekttagok olvasási vagy adatmódosítási API-kéréseket indíthatnak, míg a projekttulajdonosok a projekt beállításait és költési korlátait is módosíthatják, valamint kezelhetik a projekttagokat. További információt a szerepkörökről és engedélyekről szóló részben talál.
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. A projektet a navigációs sáv legördülő menüjéből választhatja ki:
Ezután lépjen a szervezeti beállítások -> Projekt -> Tagok menüpontba, majd kattintson a + Szolgáltatásfiók lehetőségre:
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
Függetlenül attól, hogy a szolgáltatásfiókot szervezeti szinten hozza létre, vagy egy projekthez egyedi fiókot készít, a létrehozáskor megadhat egy egyedi, betűkből, számokból és kötőjelekből álló szolgáltatásfiók-azonosítót, hogy könnyen azonosítható legyen.
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 egy 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. Ezeket az engedélyeket a projekt API-kulcsainak beállításaiban módosíthatja.
A szolgáltatásfiókok a projekttagok mellett jelennek meg a projekt tagbeállítási oldalán. A szolgáltatásfiókok 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 projektekhez tartozó API-kulcsokat az adott projekt beállítási oldalán hozhatja létre és kezelheti. Nyissa meg a szervezeti beállításokat, válassza ki a projektet, majd kattintson az API-kulcsok lehetőségre.
Ú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ás vagy Írás engedéllyel a /v1/assistants végponthoz:
Csak olvasás — Minden végponthoz olvasási engedély van beállítva.
Hogyan történik a több projekthez vagy szervezethez tartozó felhasználók hozzáféréskezelése?
A felhasználók annyi projektnek lehetnek tagjai, amennyire szükség van. Egy projekten belül a felhasználók személyes API-kulcsot hozhatnak létre, amely az adott projekthez és annak erőforrásaihoz való hozzáférésre van korlátozva.
Hogyan állíthatom be és kezelhetem a szervezetem projektjeinek használati korlátait?
Csak egy szervezet tulajdonosa állíthatja be és kezelheti a projektszintű használati korlátokat. További információért tekintse meg a szerepkörök és engedélyek részt.
A szervezeti beállításokban kattintson a frissíteni kívánt projektre, és válassza a Korlátok lehetőséget a navigációs lista Projekt szakaszában. Ezen az oldalon frissítheti a Modellhasználat beállításait.
A modellhasználat lehetővé teszi annak beállítását, hogy a projekt mely modelleket használhatja, és a használati korlátok szükség szerint modellenként állíthatók be.
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ót a szerepkörökről és engedélyekről szóló részben talál. A szervezeti szintű korlátok módosításához nyissa meg a szervezeti beállításokat, kattintson a Korlátok lehetőségre, majd görgessen le a Használati korlátok részhez.
A projektkorlátok beállításához nyissa meg a szervezeti beállításokat, kattintson a frissíteni kívánt projektre, majd válassza a Korlátok lehetőséget. Itt 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 adhat meg a projekthez. Ha a használat egy adott naptári hónapban (UTC szerint) meghaladja ezt a korlátot, az API-kérések feldolgozása megszakítás nélkül folytatódik. Ez a funkció a költési korlátokról szóló riasztásokkal segíti a használat nyomon követését, de nem szab szigorú felső határt a költésnek. Projektköltési korlát létrehozásakor alapértelmezés szerint riasztás jön létre a 100%-os küszöbértéknél. További, eltérő küszöbértékű riasztásokat a Riasztás hozzáadása lehetőségre kattintva állíthat be.
Vegye figyelembe, 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 limiteket a szervezetemhez vagy a projektemhez?
Az OpenAI mostantól havi API-költési limiteket támogat szervezeti és projektszinten egyaránt. A költési limit figyelheti a költést kényszerítés nélkül, vagy szigorú limitként is érvényesíthető, így az API-kérések sikertelenek lesznek, miután a költés eléri a limitet. A legfrissebb konfigurációs lépésekért és működési részletekért lásd a fejlesztői dokumentáció Költési limitek részét.
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 projektet megtekintheti ugyanazon a projektlista oldalon, az „Archivált” lapon.
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átja annak, hogy hány projektem lehet a szervezetemben?
A szervezetek alapértelmezés szerint legfeljebb 2000 projektet hozhatnak létre.
Megoszthatók az erőforrások projektek között?
A projekt erőforrásai (például fájlok, asszisztensek, tárhely vagy szálak) a projekthez vannak kötve, és a projekten kívüli, nem rendszergazda tagok nem férhetnek hozzájuk. Továbbá az erőforrások nem helyezhetők át 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 projektenkénti fájltárhelykvóta?
Az OpenAI jelenleg projektenként 100 GB-os fájltárhelykvótát biztosít.
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ó projektbeli szerepkörétől. Ehelyett a szervezetben betöltött 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 „Szervezettulajdonosok számára látható” értékre van állítva.