Oprávnění a limity kolekcí
Na této stránce
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_KEY | Nahrávání souborů a vyhledávání | Operace čtení a využívání |
XAI_MANAGEMENT_API_KEY | Sprá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:
- Přihlas se do konzole xAI
- Vytvoř nový klíč Management API
- Povol oprávnění
AddFileToCollection - 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í
AddFileToCollectionje 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