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

Vytváranie a správa kolekcií

Lekcia 5 z 16 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Od izolovaných súborov po znalostnú databázu
  2. Samostatné API a dôvod jeho existencie
  3. Vytvorenie tvojej prvej kolekcie
  4. Päť dostupných operácií
  5. Kľúčové poznatky

Od izolovaných súborov po znalostnú databázu

Doteraz každý dokument stál osamote: nahral si ho, odkázal sa naň a index vytvorený pre túto príležitosť spolu s dopytom zmizol. Kolekcie menia mierku: zoskupujú tvoje súbory do štruktúrovaných znalostných databáz, ktoré sa indexujú raz a sú neobmedzene dostupné na dotazovanie. Toto je základ RAG (Retrieval-Augmented Generation) s Grokom a rozdiel spoznáš hneď, keď tím podpory vyhľadáva v dvoch stovkách produktových listov namiesto jedného PDF.

Predstav si kolekciu ako inteligentný priečinok. Vložíš doň dokumenty, xAI ich zindexuje pre sémantické vyhľadávanie a Grok prehľadáva túto databázu, aby odpovedal s presnosťou a vytiahol tri užitočné pasáže z tisícov.

100k
Files per account
100 GB
Total capacity
CRUD
Full operations
$2.50
Per 1,000 searches

Samostatné API a dôvod jeho existencie

Kolekcie nespravuješ prostredníctvom API, ktoré si používal od začiatku kurzu. Patria pod Management API, hostované na management-api.x.ai, so základnou URL:

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

Toto oddelenie nie je architektonický rozmar. Vytváranie, úprava alebo odstraňovanie kolekcie sú administratívne operácie s vážnymi dôsledkami, a preto xAI vyžaduje vyhradený kľúč: Management API Key s oprávnením AddFileToCollection. Výhoda pre tímy je okamžitá: služba, ktorá dopytuje databázu z tvojej verejnej aplikácie, dostane štandardný kľúč a nemôže nič zničiť; iba tvoje pipeline na ingestiu dát drží kľúč na správu.

Vytvorenie tvojej prvej kolekcie

Vytvorenie sa obmedzuje na jediný volanie s názvom:

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"}'

Odozva vráti identifikátor, ktorý si musíš uložiť:

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

Tento názov si vyber starostlivo: objaví sa vo všetkých tvojich zoznamoch a o šesť mesiacov bude jediným vodítkom, podľa ktorého rozlíšiš dve susedné databázy. Názov technical-docs túto úlohu splní; test2 nie. Prijmi konvenciu už pri prvej kolekcii, pretože premenovanie databázy, na ktorú už odkazujú tri aplikácie, stojí viac než jej správne pomenovanie hneď na začiatku.

Päť dostupných operácií

Management API poskytuje úplnú sadu operácií CRUD pre kolekcie:

OperáciaMetódaKoncový bod
VytvoriťPOST/v1/collections
ZoznamGET/v1/collections
DetailyGET/v1/collections/{collection_id}
AktualizovaťPUT/v1/collections/{collection_id}
OdstrániťDELETE/v1/collections/{collection_id}

Výpis tvojich kolekcií prebieha bez parametrov a poskytuje užitočný prehľad pred akoukoľvek údržbovou operáciou:

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

Odstránenie nasleduje rovnakú logiku, pričom určuješ identifikátor získaný pri vytvorení:

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

Jedna vec by ťa mala upokojiť, keď tento príkaz spustíš: odstránením kolekcie sa odstráni indexovanie, nie súbory. Tvoje dokumenty zostávajú dostupné prostredníctvom Files API a môžu byť znovu zindexované inde. Strácaš štruktúru vyhľadávania, nie surový materiál – čo znamená, že obnova zle organizovanej databázy je oveľa menej riziková, než sa zdá.

Kľúčové poznatky

  • Kolekcie zoskupujú tvoje súbory do indexovaných znalostných databáz pre RAG
  • Správa prebieha cez Management API (management-api.x.ai), nie cez štandardné API
  • Vyžaduje sa Management API Key s oprávnením AddFileToCollection
  • Limity sú 100 000 súborov a 100 GB na účet
  • Päť operácií CRUD pokrýva vytváranie, čítanie, aktualizáciu a odstraňovanie