OpenAI
Ez az oldal gépi fordítással készült. Tekintsd meg az eredeti angol nyelvű cikket.

Projektek kezelése az API-platformon

Frissítve: 8 days ago

A projektek célja, hogy lehetőséget adjanak az ügyfeleknek munkájuk rendszerezésére. A szervezetek kezelhetik a hozzáférést és a korlátokat, szolgáltatásfiókokat hozhatnak létre (a 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 projektek szerint bontható, a felhasználók pedig projektenként megtekinthetik a számlázást és beállíthatják a költségkereteket.

A szervezeti tulajdonosok az összes aktív és archivált projektjüket megtekinthetik a Projektek oldalon. Tudjon meg többet a felhasználói szerepkörökről és engedélyekről az API Platformon.

Image

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:

Projects page with the organization switcher open, listing Personal and Staging organizations

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.

Image

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.

API platform project menu with Create project highlighted under Default project

Adjon meg nevet, leírást és webhelyet a projekthez, majd válassza a Create lehetőséget.

Create a new project dialog in the API platform with fields for project name, use case, and business website

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 különböző felhasználói szerepkörök vannak a szervezetekben és projektekben, és milyen engedélyek tartoznak hozzájuk?

Míg a szervezetekben „tulajdonos” és „olvasó” szerepkörök vannak, a projektekben „tulajdonos” és „tag” szerepkörök léteznek. A projekttagok a szervezeti olvasóknak felelnek meg. Az alábbi táblázatban részletesebb leírást talál arról, hogy az egyes felhasználói szerepkörökhöz milyen engedélyek tartoznak.

SzerepkörHatókörLeírás
TulajdonosSzervezetLétrehozhatja/megtekintheti az összes projektet, felhasználót és API-kulcsot. Képes a szervezeten belüli összes projektet figyelni a

Projektek oldal
segítségével. Beállíthat szervezeti költségkereteket és projektköltségkereteket. Engedélyeket adhat másoknak a szervezetben a használati információk megtekintéséhez. Archiválhat projekteket.
OlvasóSzervezetVégezhet 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.
TulajdonosProjektMás felhasználókat adhat hozzá a projekthez, átnevezheti a projektet, és rendelkezik a Tag összes képességével. Beállíthat projektköltségkereteket. Archiválhatja a projektet.
TagProjektVégezhet következtetést, használhat erőforrásokat, és kulcsokat hozhat létre projektszinten.

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örrel rendelkező felhasználók listája. Ha olyan felhasználót szeretne hozzáadni, aki jelenleg nem tagja a szervezetének, először hozzá kell adnia őt a szervezethez (az „Hozzáadás az alapértelmezett projekthez” jelölőnégyzetet üresen hagyhatja, ha nem szeretne szélesebb körű hozzáférést adni ezeknek a felhasználóknak). 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:

Project members with Add team members dialog assigning a user the Member role

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 a projektbeállításokat és a projektköltségkereteket is módosíthatják, valamint kezelhetik a projekttagokat. További információért tekintse meg a szerepkörök és engedélyek 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:

API platform project switcher open with options to create a project or manage projects

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.

Project Members page with Create a service account dialog after selecting the Service account option

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.

Members page with Save your key modal after creating a service account

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:

OpenAI API Members settings with a service account role menu open for Reader or Owner

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.

API keys page for a project with the Create new secret key button highlighted

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:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • 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öltségkereteit?

Csak egy szervezet tulajdonosai és egy projekt tulajdonosai állíthatják be és kezelhetik a projektköltségkereteket. További információért tekintse meg a szerepkörök és engedélyek részt. A szervezeti szintű korlátok módosításához a szervezeti beállításokban kattintson a Korlátok elemre, majd görgessen le a Használati korlátok részhez.

Project Limits page with organization budget controls, usage alerts, and model rate limits table

A projektkorlátok beállításához a szervezeti beállításokban kattintson a frissíteni kívánt projektre, és válassza a Korlátok lehetőséget. Frissítheti a Havi költségkeret, az Értesítési küszöb és a Modellhasználat beállításait.

A havi költségkeret beállításával puha költési küszöböket határozhat meg a projektjéhez. Ha a használat egy adott naptári hónapon (UTC) belül meghaladja ezt a korlátot, az API-kérések feldolgozása megszakítás nélkül folytatódik. Ez a funkció a használat költségkeret-riasztásokon keresztüli nyomon követését segíti, de nem érvényesít kemény költési plafont. Projektköltségkeret létrehozásakor alapértelmezés szerint a 100%-os küszöbnél jön létre riasztás. További költségkeretek különböző küszöböknél a Riasztás hozzáadása elemre kattintva állíthatók be.

Kérjük, vegye figyelembe, hogy a szervezet tulajdonosa(i) és a projekt tulajdonosa(i) mindig megkapják ezeket az üzeneteket, és ez nem szabható testre.

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

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.

API platform Projects page with the Archived tab selected to view archived projects

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.

Project setting for Usage dashboard visibility with Visible to organization owners selected

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.

Hasznos volt ez a cikk?