Vytváranie a správa kolekcií
Na tejto strane
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.
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ácia | Metóda | Koncový bod |
|---|---|---|
| Vytvoriť | POST | /v1/collections |
| Zoznam | GET | /v1/collections |
| Detaily | GET | /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