A projektek célja, hogy az ügyfelek számára lehetővé tegyék a munkájuk rendszerezését. A szervezetek kezelhetik a hozzáférést és a korlátokat, létrehozhatnak szolgáltatásfiókokat (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 megtekinthetik a számlázást és projektenként költségkereteket állíthatnak be.
A szervezet tulajdonosai az összes aktív és archivált projektjüket megtekinthetik a Projects page 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 lásd a szerepkörök és jogosultságok részt.
A szervezetek közötti váltáshoz vigye az egérmutatót az oldal bal felső részén a szervezet neve fölé, majd válassza ki a szervezetet a listából:
Azoknál a szervezeteknél, amelyek összevont számlázási csomagot használnak, az alszervezetek külön vannak azonosítva. 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öltségkereteket (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 a projekt neve fölé, majd válassza a Create project lehetőséget.
Adjon meg nevet, leírást és webhelyet a projekthez, majd válassza a Create lehetőséget.
Hogyan adhatok hozzá felhasználókat egy projekthez?
Az újonnan hozzáadott szervezeti tagok nem kerülnek be automatikusan az „Alapértelmezett projektbe”. Az új tagokat vagy a szervezetbe való meghíváskor lehet meghívni a projektbe (az „Invite to default project” jelölőnégyzet bejelölésével), vagy azután, hogy a tag elfogadta a szervezeti meghívást.
A rendszergazdai API-n keresztül meghívott felhasználókra a /organization/invites végpont által meghatározott szabályok vonatkoznak.
Ha hibába ütközik, amikor felhasználókat hív meg egy projektbe a felhasználói felületen vagy a rendszergazdai API-n keresztül, az ismételt meghívás elküldése előtt először erősítse meg, hogy a célprojekt létezik és nincs archiválva.
A szervezet tulajdonosai automatikusan tulajdonosként kerülnek hozzáadásra a szervezeten belül létrehozott új projektekhez.
Milyen különböző felhasználói szerepkörök vannak a szervezeteken és projekteken belül, és ezek milyen jogosultságokkal járnak?
Míg a szervezetekben „owner” és „reader” szerepkörök vannak, a projektekben „owner” és „member” szerepkörök léteznek. A projekttagok a szervezeti olvasóknak felelnek meg. Az egyes felhasználói szerepkörökhöz tartozó jogosultságok részletesebb leírását az alábbi táblázat tartalmazza.
| Szerepkör | Hatókör | Leírás |
|---|---|---|
| Tulajdonos | Szervezet | Létrehozhatja/megtekintheti az összes projektet, az összes felhasználót és az összes API-kulcsot. Képes a szervezeten belüli összes projekt figyelésére a Projects page segítségével. Beállíthat szervezeti és projektköltségkereteket. Jogosultságot adhat másoknak a szervezeten belüli használati információk megtekintésére. Archiválhat projekteket. |
| Olvasó | Szervezet | Végrehajthat inferenciát, használhat erőforrásokat és kulcsokat hozhat létre a projektjeiben. Projektekhez adható hozzá. Nem hozhat létre projekteket és nem kezelhet felhasználókat. |
| Tulajdonos | Projekt | Más felhasználókat adhat a projekthez és átnevezheti a projektet, valamint rendelkezik egy Tag összes képességével. Beállíthat projektköltségkereteket. Archiválhatja a projektet. |
| Tag | Projekt | Inferenciát hajthat végre, erőforrásokat használhat és kulcsokat hozhat létre projekt szinten. |
Ha nem vagyok Tulajdonos a szervezetben, mihez férek hozzá?
Azok a felhasználók, akik nem Tulajdonosok a szervezetben, csak azokat a projekteket láthatják, amelyeknek tagjai. Csak a szervezet tulajdonosa láthatja az összes projektet, tagot és API-kulcsot projekt szinten, és férhet hozzá a Projects page oldalhoz.
Csak egy projekt tagjai (és a szervezet tulajdonosai) láthatják az adott projekten belül létrehozott finomhangolt modelleket, a létrehozott Asszisztensek szálait vagy a hozzáadott fájlokat.
Egy projekt tagjai láthatják, kik a projekt többi tagjai és azok szerepköreit is (azaz Owner vagy Member).
Hogyan frissíthetem egy felhasználó projektszerepkörét, vagy hogyan távolíthatok el egy felhasználót egy projektből?
Csak a projekt tulajdonosa frissítheti egy felhasználó projektszerepkörét, vagy távolíthat el egy felhasználót a projektből. További információért lásd a szerepkörök és jogosultságok részt.
Ha egy projektben szeretne frissíteni egy felhasználót, lépjen a szervezeti beállításokhoz, válassza ki a projektet, majd kattintson a Members elemre. Lehetősége van minden tag szerepkörét Member vagy Owner értékre állítani. A felhasználó projektből való eltávolításához a Remove 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 projekthez
Ha a + Add member gombra kattint, megjelenik a szervezetében lévő, Reader szerepkörű felhasználók listája. Ha olyan felhasználót szeretne hozzáadni, aki jelenleg még nincs a szervezetében, először a szervezethez kell hozzáadnia őt (az „Add to Default Project” jelölőnégyzetet üresen hagyhatja, ha nem szeretne ezeknek a felhasználóknak szélesebb hozzáférést adni). Ez a lista nem tartalmazza a szolgáltatásfiókokat. Ebben a lépésben kiválaszthatja, hogy a szerepköre Owner vagy Member legyen:
Amikor hozzáad egy csapattagot, hozzá kell rendelnie a Member vagy az Owner szerepkört. A projekttagok olyan API-kéréseket indíthatnak, amelyek adatokat olvasnak vagy módosítanak, míg a projekttulajdonosok emellett módosíthatják a projektbeállításokat és a projektköltségkereteket, valamint kezelhetik a projekttagokat. További információért lásd a szerepkörök és jogosultságok részt.
Szolgáltatásfiók létrehozása projekthez
Először a navigációs sávban található legördülő menüből válassza ki azt a projektet, amelyhez szolgáltatásfiókot szeretne létrehozni:
Ezután lépjen a szervezeti beállításokhoz -> Project -> Members -> és kattintson a + Service account 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 Create gomb kiválasztása után a rendszer azonnal létrehoz egy API-kulcsot a szolgáltatásfiókhoz, és megjeleníti a titkos kulcsot. Mentse ezt a titkos kulcsot biztonságos helyre. Biztonsági okokból ezt később nem tudja újra megtekinteni az OpenAI-fiókján keresztül. Ha elveszíti ezt a titkos kulcsot, újat kell létrehoznia.
A szolgáltatásfiók API-kulcsának jogosultságai alapértelmezés szerint olvasási és írási hozzáférést adnak a projekt összes API-erőforrásához. Ezek a jogosultságok a projekt API Keys beállításaiban frissíthetők.
A szolgáltatásfiókok a projekt tagjai mellett szerepelnek a projekt tagbeállítási oldalán. A projekt tagbeállítási oldalán a szolgáltatásfiók hozzáférésének frissítéséről vagy eltávolításáról további információt itt talál.
A projektek és szervezetek összes szolgáltatásfiókja az emberi felhasználók mellett jelenik meg a szervezeti szintű tagok oldalon.
A szolgáltatásfiókok kezelése ugyanúgy történik, mint a normál fiókoké. Az Organization -> Members menüben eltávolíthat egy szolgáltatásfiókot, vagy frissítheti a szerepkörét:
Hogyan kezelhetem az API-kulcsokat a szervezetem projektjein belül?
Minden projekthez létrehozhat és kezelhet API-kulcsokat az adott projekt beállítási oldalán. A szervezeti beállításokban válassza ki a projektet, majd kattintson az API Keys elemre.
Új titkos kulcs létrehozásához válassza a + Create new secret key lehetőséget. A titkos kulcs melletti Szerkesztés ikon kiválasztásával annak jogosultságait is módosíthatja.
Minden API-kulcshoz beállíthat jogosultságokat új titkos kulcs létrehozásakor vagy meglévő kulcs szerkesztésével.
Három jogosultsági szint érhető el: All, Restricted és Read Only.
All — A titkos kulcshoz teljes jogosultságok vannak beállítva. Ez az alapértelmezett beállítás.
Restricted — Lehetővé teszi, hogy a felhasználó minden végponthoz None, Read és Write jogosultságot állítson be.
Például létrehozhat egy API-kulcsot, amely kifejezetten nem rendelkezik Read vagy Write jogosultsággal a /v1/assistants végponthoz:
Read Only — Az összes végponthoz olvasási jogosultság 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 sebességkorlátait?
Csak a szervezet Tulajdonosa állíthat be és kezelhet projekt szintű sebességkorlátokat. További információért lásd a szerepkörök és jogosultságok részt.
A szervezeti beállításokban kattintson a frissíteni kívánt projektre, majd a navigációs lista Projekt részében válassza a Limits elemet. Ezen az oldalon frissítheti a Model Usage beállítást.
A modellhasználat lehetővé teszi annak konfigurálását, hogy a projekt mely modelleket használhatja, a sebességkorlátok pedig szükség szerint modellenként állíthatók be.
Hogyan állíthatom be és kezelhetem a szervezetem projektjeinek költségkereteit?
Csak a szervezet tulajdonosai és egy projekt tulajdonosai állíthatják be és kezelhetik a projektköltségkereteket. További információért lásd a szerepkörök és jogosultságok részt. A szervezeti szintű korlátok módosításához a szervezeti beállításokban kattintson a Limits lehetőségre, majd görgessen le a Usage limits részhez.
A projekt korlátainak beállításához a szervezeti beállításokban kattintson a frissíteni kívánt projektre, majd válassza a Limits lehetőséget. Frissítheti a Monthly budget, a Notification threshold és a Model Usage beállításokat.
A havi költségkeret beállításával puha költési küszöböket határozhat meg a projekthez. Ha a használat egy adott naptári hónapon (UTC) belül meghaladja ezt a korlátot, az API-kérések megszakítás nélkül továbbra is feldolgozásra kerülnek. Ez a funkció arra szolgál, hogy költségkeret-riasztások segítségével nyomon követhesse a használatot, de nem érvényesít szigorú költési plafont. Amikor egy projektköltségkeret létrejön, alapértelmezés szerint 100%-os küszöbnél riasztás jön létre. További, eltérő küszöbökön lévő költségkeretek a Add Alert gombra kattintva állíthatók be.
Felhívjuk figyelmét, hogy ezeket az üzeneteket a szervezet tulajdonosa(i) és a projekt tulajdonosa(i) mindig megkapják, és ez nem testreszabható.
Hogyan törölhetek vagy archiválhatok egy projektet?
A projektek archiválhatók az új projektlista oldalon vagy egy adott projekt beállításainál. Ha egy projekt archiválva lett, nem állítható vissza. Az archiválás folytatásához meg kell adnia a projekt nevét.
Az összes archivált projekt listáját ugyanazon a projektlista oldalon, az „Archived” lapon tekintheti meg.
Projektek törlése nem lehetséges; az összes projektről előzményeket őrzünk meg a használat és a számlázás nyomon követésének folytonossága érdekében.
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 fájltárolási kvóta projektenként?
Az OpenAI jelenleg projektenként 100 GB fájl tárolási kvótát támogat.
Ha ezt a kvótát túllépi, a következő hibaüzenet 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.
Projekt tulajdonosa vagyok, miért nem látom a projektem Használati irányítópultját?
Egy 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 alatti beállítások határozzák meg.
Ha nem lát Használati irányítópultot, akkor ez a beállítás valószínűleg a „Visible to organization owners” értékre van állítva.