Gyűjtemények jogosultságai és korlátai
Ezen az oldalon
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:
| Kulcs | Használat | Hatókör |
|---|---|---|
XAI_API_KEY | Fájlfeltöltés és keresés | Olvasási és használati műveletek |
XAI_MANAGEMENT_API_KEY | Gyűjteménykezelés | Adminisztrá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:
- Jelentkezz be az xAI konzolba
- Hozz létre egy új Management API kulcsot
- Engedélyezd az
AddFileToCollectionjogosultságot - 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
AddFileToCollectionjogosultsá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