Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Gyűjtemények jogosultságai és korlátai

8. lecke 16 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. A tudásbázisok sajátos kockázata
  2. Két kulcs, két szerepkör
  3. Az AddFileToCollection jogosultság
  4. Kvóták és költségeik
  5. Izolálás, rotálás, monitorozás
  6. Egy fájl, több gyűjtemény
  7. Főbb megállapítások

A tudásbázisok sajátos kockázata

Egy vállalati tudásbázis sosem triviális dolog: belső jegyzetek, bizalmas jelentések, tárgyalás alatt álló szerződések. Ha a hozzáférés-vezérlés meghibásodik, nem csupán egyetlen fájlt szivárogtatsz ki, hanem az egész bázist feltárod, egy beépített keresőmotorral együtt, amely segít megtalálni a lényeges információkat. Az xAI jogosultsági rendszere enyhíti ezt a kockázatot a jogok szétválasztásával, míg a kvóták a használatot és a számlázást szabályozzák.

Két kulcs, két szerepkör

Az xAI ökoszisztéma két különböző hatókörre szóló hitelesítő adatot használ:

KulcsHasználatHatókör
XAI_API_KEYFájlfeltöltés és keresésOlvasási és használati műveletek
XAI_MANAGEMENT_API_KEYGyűjteménykezelésAdminisztrációs műveletek

Ez a szétválasztás a legkisebb jogosultság elvét konkrétan alkalmazza. Egy fejlesztőnek, aki egy ügyfélszolgálati chatbotot köt össze a bázisoddal, csak lekérdeznie kell a gyűjteményt, törölnie soha. Ha csak a szabványos kulcsot adod neki, egy szkripthiba vagy egy feltört kulcs sem tudja megsemmisíteni a hónapok alatt felépített indexet.

Az AddFileToCollection jogosultság

Egy Management API kulcs alapértelmezés szerint nem mindenható. A jogai explicit módon vannak meghatározva, és a gyűjtemények szempontjából a legkritikusabb az AddFileToCollection jogosultság. Enélkül létrehozhatsz és listázhatsz gyűjteményeket, de egyetlen dokumentumot sem tudsz hozzáadni – ez zavaros helyzet, hiszen minden úgy tűnik, működik egészen a betáplálásig. Egy helyes kulcs generálása négy lépésből áll:

  1. Jelentkezz be az xAI konzolba
  2. Hozz létre egy új Management API kulcsot
  3. Engedélyezd az AddFileToCollection jogosultságot
  4. Tárold biztonságosan a kulcsot: környezeti változóban vagy titokkezelőben

Ha hiányzik a jogosultság, az API egyértelműen jelez, és egy 403-as hibát ad vissza:

{
  "error": {
    "message": "Insufficient permissions",
    "type": "permission_error",
    "code": 403
  }
}

Az első lépésed az legyen, hogy ellenőrzöd a kulcs jogait a konzolban, ahelyett, hogy a kérést gyanúsítanád, amelynek szintaxisának semmi köze az elutasításhoz.

Kvóták és költségeik

Három felső korlát szabályozza a fiókonkénti tárhelyet: összesen 100 000 fájl, 100 GB kumulatív kapacitás és gyűjteményenként 100 MB egyedi fájlonként – ez több mint kétszerese a csak Files API által engedélyezett 48 MB-nak, így olyan dokumentumokat is includálhatsz, amelyeket közvetlen mellékletként nem tudtál volna elküldeni.

A számlázás oldalán két tétel emelkedik ki: a Collections Search keresési hívásonként 2,50 USD-be kerül 1000 hívásra vetítve, míg a File Attachments költsége 10 USD 1000 hívásonként. A különbség jelentős, és súlyt nyom az architektúrális döntésekre. Nagy igénybevétel esetén egy indexelt gyűjtemény lekérdezése jelentősen olcsóbb, mint ugyanannak a dokumentumnak a minden egyes kérdéssel történő újbóli csatolása.

Ha igényeid meghaladják ezeket a kvótákat, az xAI támogatás növelést engedélyezhet. Készítsd elő a kérelmedet konkrét számokkal – célzott fájlszám, teljes volumen, várható keresési gyakoriság –, ne pedig homályos becslésekkel. Ez felgyorsítja a kérelem feldolgozását.

Izolálás, rotálás, monitorozás

Az első gyakorlat a kulcsokra vonatkozik. Rendelj különböző kulcsokat minden környezethez, így egy fejlesztési szkript soha nem érheti el az éles bázist. Soha ne adj Management kulcsot olyan szolgáltatásnak, amelynek egyetlen igénye a keresés. És rendszeresen forgasd ezeket a kulcsokat, különösen akkor, ha egy titkokhoz hozzáférő munkatárs távozik.

A második a struktúrára vonatkozik. Ahelyett, hogy egyetlen gyűjteményben coexistálna a nyilvános dokumentáció és a szerződések, válaszd szét a bázisaidat titkossági szint szerint: egy „nyilvános“ bázis a nyílt dokumentációnak, egy „belső“ bázis a vállalati dokumentumoknak és egy „bizalmas“ bázis az érzékeny adatoknak. Így minden szolgáltatás csak a szükséges hozzáférést kapja meg, és a „hivatkozhat-e ez a chatbot egy szerződésre?“ kérdésre már a tervezés szintjén megvan a válasz.

A harmadik a monitorozás. Ellenőrizd a fogyasztásodat az xAI konzolban, állíts be riasztást a keresési volumen váratlan növekedésére – ami gyakran az első jele egy elszabadult ciklusnak –, és vezess írásos nyilvántartást arról, hogy mely szolgáltatások mely gyűjteményeket érik el.

Egy fájl, több gyűjtemény

Ez az izolálás nem igényli a dokumentumaid duplikálását, mivel ugyanaz a fájl több gyűjteményhez is tartozhat. Egy technikai jelentés így megjelenhet a „product-documentation“ gyűjteményben a műszaki csapat számára, a „quarterly-reports“ban a vezetés számára, és a „support-base“ben az ügyfélszolgálat számára. Csak egyszer van tárolva, csak egyszer számít bele a kvótádba, és mindhárom kontextusban kereshető marad – tematikus nézetek közönség szerint, eltérő másolatok nélkül.

Főbb megállapítások

  • Két különböző API-kulcs: szabványos a használathoz, Management az adminisztrációhoz
  • Az AddFileToCollection jogosultság elengedhetetlen a gyűjtemények feltöltéséhez
  • A korlátok: 100 000 fájl, 100 GB és fájlonként 100 MB
  • Válaszd szét a gyűjteményeidet titkossági szint szerint
  • Egy fájl több gyűjteményhez is tartozhat duplikálás nélkül