Oprávnenia a obmedzenia kolekcií
Na tejto strane
Špecifické riziko znalostných báz
Podniková znalostná báza nie je nikdy triviálna záležitosť: interne poznámky, dôverné správy, zmluvy v štádiu rokovaní. Ak zlyhajú kontroly prístupu, neunikne len jeden súbor – odhalíš celú bázu aj so zabudovaným vyhľadávačom, ktorý nájde presne to, čo má zostať skryté. Systém oprávnení xAI toto riziko zmierňuje oddelením práv, zatiaľ čo kvóty riadia využitie a fakturáciu.
Dva kľúče, dve role
Ekosystém xAI sa spolieha na dva typy poverení pre odlišné rozsahy činností:
| Kľúč | Využitie | Rozsah |
|---|---|---|
XAI_API_KEY | Nahrávanie súborov a vyhľadávanie | Operácie čítania a využívania |
XAI_MANAGEMENT_API_KEY | Správa kolekcií | Administratívne operácie |
Toto oddelenie konkrétne uplatňuje princíp najmenších privilégií. Vývojár, ktorý pripája chatbot podpory k tvojej báze, potrebuje kolekciu iba dopytovať, nie ju mazať. Ak mu poskytneš len štandardný kľúč, chyba v skripte alebo kompromitácia kľúča nezničí index, ktorý si budoval mesiace.
Oprávnenie AddFileToCollection
Kľúč Management API nie je predvolene všemocný. Jeho práva sú explicitné a tým najkritickejším pre kolekcie je AddFileToCollection. Bez neho dokážeš kolekcie vytvárať a vypisovať, ale nemôžeš pridať ani jeden dokument – čo je mätúca situácia, keďže všetko vyzerá funkčne až do momentu ingestie. Generovanie správneho kľúča zahŕňa štyri kroky:
- Prihlásenie do konzoly xAI
- Vytvorenie nového kľúča Management API
- Povolenie oprávnenia
AddFileToCollection - Bezpečné uloženie kľúča: premenná prostredia alebo správca tajomstiev
Keď toto oprávnenie chýba, API je jasné a vráti chybu 403:
{
"error": {
"message": "Insufficient permissions",
"type": "permission_error",
"code": 403
}
}
Tvojím prvým krokom by mala byť kontrola práv kľúča v konzole, namiesto podozrievania požiadavky, ktorej syntax s odmietnutím nemá nič spoločné.
Kvóty a ich náklady
Tri stropy riadia úložisko na účet: celkovo 100 000 súborov, súhrnná kapacita 100 GB a 100 MB na jednotlivý súbor v kolekciách – čo je viac než dvojnásobok limitu 48 MB povoleného samotným API pre súbory, čo ti umožňuje zahrnúť dokumenty, ktoré by si nemohol odoslať ako priame prílohy.
Na strane fakturácie vynikajú dve položky: Vyhľadávanie v kolekciách (Collections Search) sa účtuje sumou 2,50 $ za 1 000 volaní vyhľadávania, zatiaľ čo prílohy súborov (File Attachments) stoja 10 $ za 1 000 volaní. Rozdiel je významný a váži pri architektonických rozhodnutiach. Pri vysokom využití stojí dopytovanie indexovanej kolekcie výrazne menej než opätovné pripájanie toho istého dokumentu ku každej otázke.
Ak tvoje potreby presahujú tieto kvóty, podpora xAI môže povoliť ich zvýšenie. Priprav si žiadosť s konkrétnymi číslami – cieľový počet súborov, celkový objem, očakávaná frekvencia vyhľadávania – namiesto vágnych odhadov. Urýchli to vybavenie tvojej žiadosti.
Izoluj, obmieňaj, monitoruj
Prvým pravidlom sú kľúče. Priraď rôzne kľúče každému prostrediu, aby sa vývojársky skript nikdy nedostal k produkčnej báze. Nikdy neposkytuj kľúč Management službe, ktorá potrebuje iba vyhľadávať. A tieto kľúče pravidelne obmieňaj, najmä potom, čo organizáciu opustí spolupracovník s prístupom k tajomstvám.
Druhým pravidlom je štruktúra. Namiesto jednej kolekcie, kde koexistujú verejná dokumentácia a zmluvy, rozdeľ svoje bázy podľa úrovne dôvernosti: „verejná“ báza pre otvorenú dokumentáciu, „interná“ báza pre firemné dokumenty a „dôverná“ báza pre citlivé údaje. Každá služba potom dostane iba prístup, ktorý potrebuje, a otázka „môže tento chatbot citovať zmluvu?“ je zodpovedaná už samotným návrhom systému.
Tretím pravidlom je monitorovanie. Kontroluj svoju spotrebu v konzole xAI, nastav alert pri akomkoľvek neočakávanom náraste objemu vyhľadávania – čo je často prvý znak slučky, ktorá sa vymkla spod kontroly – a vedi si písomnú evidenciu o tom, ktoré služby pristupujú ku ktorým kolekciám.
Jeden súbor, viacero kolekcií
Táto izolácia si nevyžaduje duplikovanie dokumentov, keďže ten istý súbor môže patriť do viacerých kolekcií. Technická správa sa tak objaví v „product-documentation“ pre technický tím, v „quarterly-reports“ pre manažment a v „support-base“ pre zákaznícku podporu. Je uložená iba raz, započítava sa do kvót len raz a zostáva vyhľadateľná vo všetkých troch kontextoch – tematické pohľady podľa cieľovej skupiny bez divergentných kópií.
Kľúčové poznatky
- Dva odlišné kľúče API: štandardný na využitie, Management na administráciu
- Oprávnenie
AddFileToCollectionje nevyhnutné na naplnenie kolekcií - Limity sú 100 000 súborov, 100 GB a 100 MB na súbor
- Rozdeľ svoje kolekcie podľa úrovne dôvernosti
- Súbor môže patriť do viacerých kolekcií bez duplikácie