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

Tworzenie i zarządzanie kolekcjami

Lekcja 5 z 16 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Od pojedynczych plików do bazy wiedzy
  2. Osobne API i powód jego istnienia
  3. Stwórz swoją pierwszą kolekcję
  4. Pięć dostępnych operacji
  5. Kluczowe wnioski

Od pojedynczych plików do bazy wiedzy

Do tej pory każdy dokument istniał osobno: przesyłałeś go, odwoływałeś się do niego, a indeks zbudowany na tę okazję znikał wraz z zapytaniem. Kolekcje zmieniają skalę: grupują Twoje pliki w ustrukturyzowane bazy wiedzy, indeksowane raz i dostępne do zapytań w nieskończoność. To fundament RAG (Retrieval-Augmented Generation) z Grokiem, a różnica staje się widoczna natychmiast, gdy zespół wsparcia przeszukuje dwieście kart produktów zamiast jednego pliku PDF.

Traktuj kolekcję jak inteligentny folder. Wgrywasz do niego dokumenty, xAI indeksuje je pod kątem wyszukiwania semantycznego, a Grok przeszukuje tę bazę, aby precyzyjnie odpowiedzieć, wyciągając trzy przydatne fragmenty spośród tysięcy.

100k
Plików na konto
100 GB
Całkowita pojemność
CRUD
Pełne operacje
$2.50
Za 1000 wyszukiwań

Osobne API i powód jego istnienia

Kolekcjami nie zarządzasz poprzez API, z którego korzystałeś od początku kursu. Podlegają one pod Management API, hostowane na management-api.x.ai, z bazowym adresem URL:

https://management-api.x.ai/v1

Ten podział nie jest kaprysem architektonicznym. Tworzenie, modyfikowanie lub usuwanie kolekcji to operacje administracyjne o poważnych konsekwencjach, dlatego xAI wymaga do nich dedykowanego klucza: Management API Key z uprawnieniem AddFileToCollection. Korzyść dla zespołów jest natychmiastowa: usługa odpytująca bazę z Twojej publicznej aplikacji otrzymuje standardowy klucz i nie może niczego zniszczyć; tylko Twój proces ingestii (wgrywania danych) posiada klucz zarządczy.

Stwórz swoją pierwszą kolekcję

Tworzenie sprowadza się do jednego wywołania z nazwą:

curl -X POST https://management-api.x.ai/v1/collections \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection_name": "technical-docs"}'

Odpowiedź zwraca identyfikator, który musisz zapisać:

{
  "collection_id": "col_xyz789",
  "collection_name": "technical-docs",
  "created_at": "2026-04-01T10:00:00Z"
}

Wybierz tę nazwę ostrożnie: pojawi się ona na wszystkich Twoich listach i za sześć miesięcy będzie jedyną wskazówką pozwalającą odróżnić dwie sąsiadujące bazy. technical-docs spełnia tę rolę; test2 – nie. Przyjmij konwencję nazewnictwa już przy pierwszej kolekcji, ponieważ zmiana nazwy bazy, do której odwołują się już trzy aplikacje, kosztuje więcej niż dobre nazwanie jej na start.

Pięć dostępnych operacji

Management API udostępnia pełny zestaw operacji CRUD na kolekcjach:

OperacjaMetodaPunkt końcowy
TworzeniePOST/v1/collections
ListaGET/v1/collections
SzczegółyGET/v1/collections/{collection_id}
AktualizacjaPUT/v1/collections/{collection_id}
UsuwanieDELETE/v1/collections/{collection_id}

Wyświetlenie listy kolekcji odbywa się bez parametrów i daje użyteczny przegląd przed jakąkolwiek operacją konserwacyjną:

curl https://management-api.x.ai/v1/collections \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"

Usuwanie działa na tej samej zasadzie, wskazując identyfikator uzyskany podczas tworzenia:

curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"

Jedna rzecz powinna Cię uspokoić podczas uruchamiania tego polecenia: usunięcie kolekcji usuwa indeksowanie, ale nie same pliki. Twoje dokumenty pozostają dostępne poprzez Files API i mogą zostać zaindeksowane gdzie indziej. Tracisz strukturę wyszukiwania, a nie surowy materiał – co sprawia, że odbudowa źle zorganizowanej bazy jest znacznie mniej ryzykowna, niż się wydaje.

Kluczowe wnioski

  • Kolekcje grupują Twoje pliki w indeksowane bazy wiedzy przeznaczone dla RAG
  • Zarządzanie odbywa się poprzez Management API (management-api.x.ai), a nie standardowe API
  • Wymagany jest Management API Key z uprawnieniem AddFileToCollection
  • Limity to 100 000 plików i 100 GB na konto
  • Pięć operacji CRUD obejmuje tworzenie, odczyt, aktualizację i usuwanie