Przejdź do głównej treści
Polski— Wybierz język
Menu

Uprawnienia i limity kolekcji

Lekcja 8 z 16 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Specyficzne ryzyko baz wiedzy
  2. Dwa klucze, dwie role
  3. Uprawnienie AddFileToCollection
  4. Kwoty i ich koszty
  5. Izoluj, rotuj, monitoruj
  6. Jeden plik, wiele kolekcji
  7. Kluczowe wnioski

Specyficzne ryzyko baz wiedzy

Baza wiedzy przedsiębiorstwa nigdy nie jest błaha: wewnętrzne notatki, poufne raporty, umowy w trakcie negocjacji. Jeśli kontrola dostępu zawiedzie, nie wycieka pojedynczy plik – ujawniasz całą bazę, wraz z silnikiem wyszukiwania pozwalającym odnaleźć to, co najważniejsze. System uprawnień xAI łagodzi to ryzyko poprzez rozdzielenie praw, podczas gdy kwoty zarządzają użytkowaniem i rozliczeniami.

Dwa klucze, dwie role

Ekosystem xAI opiera się na dwóch poświadczeniach o odrębnym zakresie:

KluczZastosowanieZakres
XAI_API_KEYPrzesyłanie plików i wyszukiwanieOperacje odczytu i użytkowania
XAI_MANAGEMENT_API_KEYZarządzanie kolekcjamiOperacje administracyjne

To rozdzielenie konkretnie realizuje zasadę najmniejszych uprawnień. Deweloper podpinający bota wsparcia do Twojej bazy musi móc odpytywać kolekcję, ale nigdy jej usuwać. Przyznając mu tylko standardowy klucz, błędy w skrypcie lub kompromitacja klucza nie zniszczą indeksu budowanego przez miesiące.

Uprawnienie AddFileToCollection

Klucz Management API nie jest domyślnie wszechmocny. Jego prawa są jawne, a najważniejszym dla kolekcji jest AddFileToCollection. Bez niego możesz tworzyć i listować kolekcje, ale nie dodasz ani jednego dokumentu – sytuacja myląca, gdyż wszystko wydaje się działać aż do momentu ingestii. Wygenerowanie poprawnego klucza wymaga czterech kroków:

  1. Zaloguj się do konsoli xAI
  2. Utwórz nowy klucz Management API
  3. Włącz uprawnienie AddFileToCollection
  4. Bezpiecznie przechowaj klucz: zmienna środowiskowa lub menedżer sekretów

Gdy brakuje uprawnień, API jest jednoznaczne i zwraca kod 403:

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

Twoim pierwszym krokiem powinno być sprawdzenie praw klucza w konsoli, zamiast podejrzewania żądania, którego składnia nie ma nic wspólnego z odrzuceniem.

Kwoty i ich koszty

Trzy limity governują przestrzeń dyskową na konto: łącznie 100 000 plików, 100 GB pojemności skumulowanej oraz 100 MB na pojedynczy plik w kolekcjach – to ponad dwukrotnie więcej niż 48 MB dozwolone przez samo API Files, co pozwala dołączać dokumenty, których nie mógłbyś wysłać jako bezpośrednich załączników.

Po stronie rozliczeń wyróżniają się dwie pozycje: Wyszukiwanie w kolekcjach (Collections Search) kosztuje 2,50 USD za 1000 wywołań wyszukiwania, podczas gdy Załączniki plików (File Attachments) to 10 USD za 1000 wywołań. Różnica jest znacząca i wpływa na wybory architektoniczne. Przy dużym obciążeniu odpytywanie zindeksowanej kolekcji kosztuje znacznie mniej niż ponowne dołączanie tego samego dokumentu przy każdym pytaniu.

Jeśli Twoje potrzeby przekraczają te kwoty, wsparcie xAI może przyznać zwiększenie limitu. Przygotuj wniosek z konkretnymi liczbami – docelowa liczba plików, całkowity wolumen, oczekiwana częstotliwość wyszukiwania – zamiast mglistych szacunków. To przyspieszy przetwarzanie zgłoszenia.

Izoluj, rotuj, monitoruj

Pierwsza praktyka dotyczy kluczy. Przypisz różne klucze do każdego środowiska, aby skrypt deweloperski nigdy nie dotknął bazy produkcyjnej. Nigdy nie przekazuj klucza Management serwisowi, który potrzebuje tylko wyszukiwania. Rotuj te klucze regularnie, zwłaszcza gdy współpracownik mający dostęp do sekretów odchodzi z firmy.

Druga dotyczy struktury. Zamiast jednej kolekcji, gdzie współistnieje publiczna dokumentacja i umowy, rozdziel swoje bazy według poziomu poufności: baza „publiczna“ dla otwartej dokumentacji, „wewnętrzna“ dla dokumentów firmowych i „poufna“ dla wrażliwych danych. Każdy serwis otrzymuje wtedy tylko niezbędny dostęp, a pytanie „czy ten bot może cytować umowę?“ znajduje odpowiedź już na etapie projektu.

Trzecia to monitorowanie. Sprawdzaj zużycie w konsoli xAI, ustaw alert przy każdym nieoczekiwanym wzroście wolumenu wyszukiwań – często pierwszy znak pętli wymykającej się spod kontroli – i prowadź pisemny rejestr tego, które serwisy uzyskują dostęp do których kolekcji.

Jeden plik, wiele kolekcji

Ta izolacja nie wymaga duplikowania dokumentów, ponieważ ten sam plik może należeć do wielu kolekcji. Raport techniczny pojawia się więc w „product-documentation“ dla zespołu technicznego, w „quarterly-reports“ dla kadry zarządzającej i w „support-base“ dla obsługi klienta. Jest przechowywany tylko raz, liczy się tylko raz do limitów i pozostaje wyszukiwalny we wszystkich trzech kontekstach – widoki tematyczne według odbiorcy, bez rozbieżnych kopii.

Kluczowe wnioski

  • Dwa odrębne klucze API: standardowy do użytkowania, Management do administracji
  • Uprawnienie AddFileToCollection jest niezbędne do wypełniania kolekcji
  • Limity to 100 000 plików, 100 GB i 100 MB na plik
  • Rozdzielaj kolekcje według poziomu poufności
  • Plik może należeć do wielu kolekcji bez duplikacji