Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Oprávnění a limity kolekcí

Lekce 8 z 16 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Specifické riziko znalostních bází
  2. Dva klíče, dvě role
  3. Oprávnění AddFileToCollection
  4. Kvóty a jejich náklady
  5. Izoluj, rotuj, monitoruj
  6. Jeden soubor, více kolekcí
  7. Klíčové poznatky

Specifické riziko znalostních bází

Podniková znalostní báze není nikdy triviální záležitost: interní poznámky, důvěrné zprávy, smlouvy v jednání. Pokud selžou kontroly přístupu, neunikne jen jeden soubor – odhalíš celou bázi i s vyhledávačem, který najde to podstatné. Systém oprávnění xAI toto riziko zmírňuje oddělením práv, zatímco kvóty řídí využívání a fakturaci.

Dva klíče, dvě role

Ekosystém xAI spoléhá na dva pověřovací údaje pro odlišné rozsahy:

KlíčVyužitíRozsah
XAI_API_KEYNahrávání souborů a vyhledáváníOperace čtení a využívání
XAI_MANAGEMENT_API_KEYSpráva kolekcíAdministrativní operace

Toto oddělení konkrétně uplatňuje princip nejmenších privilegií. Vývojář, který připojuje chatbota podpory k tvé bázi, potřebuje kolekci pouze dotazovat, nikdy ji mazat. Pokud mu dáš pouze standardní klíč, chyba ve skriptu nebo kompromitace klíče nemůže zničit index budovaný měsíce.

Oprávnění AddFileToCollection

Klíč Management API není ve výchozím nastavení všemocný. Jeho práva jsou explicitní a tím nejkritičtějším pro kolekce je AddFileToCollection. Bez něj můžeš kolekce vytvářet a vypisovat, ale nemůžeš přidat ani jeden dokument – což je matoucí situace, protože vše vypadá, že funguje, dokud nedojde k ingestaci. Generování správného klíče zahrnuje čtyři kroky:

  1. Přihlas se do konzole xAI
  2. Vytvoř nový klíč Management API
  3. Povol oprávnění AddFileToCollection
  4. Klíč bezpečně ulož: jako proměnnou prostředí nebo do správce tajných údajů

Když oprávnění chybí, API je explicitní a vrátí chybu 403:

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

Tvým prvním krokem by měla být kontrola práv klíče v konzoli, nikoliv podezírání požadavku, jehož syntaxe s odmítnutím nemá nic společného.

Kvóty a jejich náklady

Tři stropy řídí úložiště na účet: celkem 100 000 souborů, souhrnná kapacita 100 GB a 100 MB na jednotlivý soubor v kolekcích – což je více než dvojnásobek limitu 48 MB povoleného samotným API pro soubory, což ti umožňuje zahrnout dokumenty, které bys nemohl poslat jako přímé přílohy.

Na straně fakturace vynikají dvě položky: Vyhledávání v kolekcích je účtováno 2,50 $ za 1 000 volání vyhledávání, zatímco přílohy souborů stojí 10 $ za 1 000 volání. Rozdíl je významný a váží na architektonických rozhodnutích. Při vysokém využití stojí dotazování indexované kolekce výrazně méně než opětovné připojování stejného dokumentu ke každé otázce.

Pokud tvoje potřeby překročí tyto kvóty, podpora xAI může povolit zvýšení. Připrav svou žádost s čísly – cílový počet souborů, celkový objem, očekávaná frekvence vyhledávání – místo vágního odhadu. To urychlí vyřízení žádosti.

Izoluj, rotuj, monitoruj

První praxe se týká klíčů. Přiřaď různé klíče každému prostředí, aby se vývojářský skript nikdy nedostal k produkční bázi. Nikdy nedávej klíč Management službě, jejíž jedinou potřebou je vyhledávání. A tyto klíče pravidelně rotuj, zejména poté, co odejde spolupracovník s přístupem k tajným údajům.

Druhá se týká struktury. Místo jediné kolekce, kde koexistuje veřejná dokumentace a smlouvy, odděl své báze podle úrovně důvěrnosti: „veřejná“ báze pro otevřenou dokumentaci, „interní“ báze pro firemní dokumenty a „důvěrná“ báze pro citlivá data. Každá služba pak obdrží pouze přístup, který potřebuje, a na otázku „může tento chatbot citovat smlouvu?“ odpoví již samotný návrh systému.

Třetí je monitorování. Kontroluj svou spotřebu v konzoli xAI, nastav alert na jakýkoli neočekávaný nárůst objemu vyhledávání – což je často první známka smyčky vymknuté kontrole – a veď písemnou evidenci o tom, které služby přistupují ke kterým kolekcím.

Jeden soubor, více kolekcí

Tato izolace nevyžaduje duplikování tvých dokumentů, protože stejný soubor může patřit do více kolekcí. Technická zpráva se tak objeví v „product-documentation“ pro technický tým, v „quarterly-reports“ pro vedení a v „support-base“ pro zákaznický servis. Je uložen pouze jednou, započítává se pouze jednou do tvých kvót a zůstává vyhledatelný ve všech třech kontextech – tematické pohledy podle publika, bez divergentních kopií.

Klíčové poznatky

  • Dva odlišné klíče API: standardní pro využívání, Management pro administraci
  • Oprávnění AddFileToCollection je zásadní pro naplnění kolekcí
  • Limity jsou 100 000 souborů, 100 GB a 100 MB na soubor
  • Odděl své kolekce podle úrovně důvěrnosti
  • Soubor může patřit do více kolekcí bez duplikace