Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Oprávnenia a obmedzenia kolekcií

Lekcia 8 z 16 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Špecifické riziko znalostných báz
  2. Dva kľúče, dve role
  3. Oprávnenie AddFileToCollection
  4. Kvóty a ich náklady
  5. Izoluj, obmieňaj, monitoruj
  6. Jeden súbor, viacero kolekcií
  7. Kľúčové poznatky

Š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žitieRozsah
XAI_API_KEYNahrávanie súborov a vyhľadávanieOperácie čítania a využívania
XAI_MANAGEMENT_API_KEYSprá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:

  1. Prihlásenie do konzoly xAI
  2. Vytvorenie nového kľúča Management API
  3. Povolenie oprávnenia AddFileToCollection
  4. 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 AddFileToCollection je 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