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 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 felhasználókat egy projekthez?
Az újonnan hozzáadott szervezeti tagok nem kerülnek automatikusan hozzáadásra az „Alapértelmezett projekthez”. Az új tagok meghívhatók a projektbe akkor, amikor meghívják őket a szervezetbe (az „Meghívás az alapértelmezett projektbe” jelölőnégyzet bejelölésével), vagy azután, hogy a tag elfogadta a szervezeti meghívást.
Az Admin API-n keresztül meghívott felhasználók a /organization/invites végpont által meghatározott szabályokat követik.
Ha hibát tapasztal, amikor felhasználókat hív meg egy projektbe a felületen vagy az Admin API-n keresztül, a meghívó újbóli elküldése előtt először ellenőrizze, hogy a célprojekt létezik, és nincs archiválva.
A szervezeti tulajdonosok automatikusan tulajdonosként kerülnek hozzáadásra a szervezeten belül létrehozott új projektekhez.
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. |
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 szervezeti tulajdonos láthatja az összes projektet, tagot és API-kulcsot projektszinten, és férhet hozzá a Projektek oldalhoz.
Csak egy projekt tagjai (és a szervezeti tulajdonosok) láthatják az adott projektben létrehozott finomhangolt modelleket, a létrehozott Asszisztensek szálait vagy a hozzáadott fájlokat.
Egy projekt tagjai láthatják, kik az adott projekt többi tagjai, valamint a szerepkörüket (azaz Tulajdonos vagy Tag).
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 tekintse meg a szerepkörök és engedélyek részt.
Egy projektben lévő felhasználó frissítéséhez lépjen a szervezeti beállításokhoz, válassza ki a projektet, és kattintson a Tagok elemre. Minden tag szerepkörét beállíthatja Tagként vagy Tulajdonosként. A felhasználó projektből való eltávolításához a Eltávolítás lehetőséget is kivá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
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 nem tartozik a szervezetéhez, előbb hozzá kell adnia a szervezethez (az „Hozzáadás az alapértelmezett projekthez” 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örük Owner vagy Member legyen:
Amikor csapattagot ad hozzá, a Tag vagy a Tulajdonos szerepkört kell hozzárendelnie. A projekttagok olyan API-kéréseket küldhetnek, amelyek adatokat olvasnak vagy módosítanak, míg a projekttulajdonosok emellett a projektbeállításokat és a projekt költési limitjeit is módosíthatják, valamint kezelhetik a projekt tagjait. További információért tekintse meg a szerepkörök és jogosultságok részt.
Hogyan hozhat létre szolgáltatásfiókot egy projekthez
Először navigáljon ahhoz a projekthez, amelyhez szolgáltatásfiókot szeretne létrehozni, a navigációs sávban található legördülő menüből választva:
Ezután lépjen a szervezeti beállításokhoz -> Projekt -> Tagok -> kattintson a + Service account 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
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.
Mentse el a szolgáltatásfiók API-kulcsát
A Létrehozás gomb kiválasztása után azonnal létrejön egy API-kulcs a szolgáltatásfiókhoz, és megjelenik a titkos kulcs. Mentse el ezt a titkos kulcsot biztonságos helyre. Biztonsági okokból nem fogja tudni újra megtekinteni az OpenAI-fiókján keresztül. Ha elveszíti ezt a titkos kulcsot, újat kell generálnia.
A szolgáltatásfiók API-kulcsának engedélyei alapértelmezés szerint a projekt összes API-erőforrásának olvasására és írására vannak beállítva. Ezek az engedélyek frissíthetők a projekt API-kulcsok beállításaiban.
A szolgáltatásfiókok a projekttagok mellett szerepelnek a projekt tagbeállítási oldalán. Kérjük, tekintse meg ezt, ha többet szeretne megtudni a szolgáltatásfiók hozzáférésének frissítéséről vagy eltávolításáról a projekt tagbeállítási oldalán.
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?
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-kulcsok elemre.
Új titkos kulcs létrehozásához válassza a + Create new secret key lehetőséget. A titkos kulcs melletti Szerkesztés ikont is kiválaszthatja az engedélyei szerkesztéséhez.
Az egyes API-kulcsokhoz engedélyeket állíthat be új titkos kulcs létrehozásakor vagy egy meglévő kulcs szerkesztésével.
Három engedélyszint érhető el: Összes, Korlátozott és Csak olvasás.
Összes — A titkos kulcshoz teljes engedélyek vannak beállítva. Ez az alapértelmezett beállítás.
Korlátozott — Lehetővé teszi a felhasználó számára, hogy minden végponthoz Nincs, Olvasás és Írás engedélyeket állítson be.
Például létrehoz egy API-kulcsot, amelynek kifejezetten nincs engedélye a /v1/assistants végpont olvasására vagy írására:
Csak olvasás — Minden végponthoz olvasási engedélyek vannak 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 limitjeit?
A projekt költési limitjeit csak a szervezet tulajdonosai és a projekt tulajdonosai állíthatják be és kezelhetik. További információért tekintse meg a szerepkörök és jogosultságok részt. A szervezeti szintű limitek módosításához a szervezeti beállításokban kattintson a Limitek elemre, majd görgessen le a Használati limitek részhez.
A projektlimitek beállításához a szervezeti beállításokban kattintson a frissíteni kívánt projektre, majd válassza a Limitek lehetőséget. Frissítheti a Havi költési limitet, az Értesítési küszöböt és a Modellhasználatot.
A havi költési limit beállításával puha költési küszöböket határozhat meg a projektje számára. Ha a használat egy adott naptári hónapon belül (UTC) meghaladja ezt a limitet, az API-kérések feldolgozása megszakítás nélkül folytatódik. Ez a funkció abban segít, hogy költésilimit-riasztásokkal figyelje a használatot, de nem kényszerít ki szigorú felső korlátot a költésre. Projektköltési limit létrehozásakor alapértelmezés szerint a 100%-os küszöbnél riasztás jön létre. További riasztásokat különböző küszöböknél a Riasztás hozzáadása elemre kattintva állíthat be.
Felhívjuk figyelmét, hogy ezeket az üzeneteket a szervezet tulajdonosa(i) és a projekt tulajdonosa(i) mindig megkapják, és ez nem szabható testre.
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 archiválhatók az új projektlista oldalon vagy az adott projekt beállításaiban. Ha egy projektet archiváltak, nem állítható vissza. Az archiválás folytatásakor a rendszer kérni fogja, hogy adja meg a projekt nevét a továbblépéshez.
Az összes archivált projekt listáját ugyanazon a projektlista oldalon, az „Archivált” lapon tekintheti meg.
A projektek törlése nem lehetséges; minden projekt előzményét megőrizzük 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.
Projekttulajdonos 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 oldalon található 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 „Látható a szervezeti tulajdonosok számára” értékre van állítva.