Vytváření a správa kolekcí
Na této stránce
Od izolovaných souborů k znalostní bázi
Doposud stál každý dokument osamoceně: nahrál jsi ho, odkázal se na něj a index vytvořený pro tuto příležitost s dotazem zmizel. Kolekce mění měřítko: sdružují tvoje soubory do strukturovaných znalostních bází, které jsou indexovány jednou a neomezeně dotazovatelné. To je základ RAG (Retrieval-Augmented Generation) s modelem Grok a rozdíl poznáš okamžitě, jakmile tým podpory dotazuje dvě stě produktových listů místo jediného PDF.
Představ si kolekci jako chytrou složku. Nahraješ do ní dokumenty, xAI je zaindexuje pro sémantické vyhledávání a Grok prohledá tuto bázi, aby odpověděl s přesností a vytáhl tři užitečné pasáže z tisíců.
Samostatné API a důvody
Kolekce nespravuješ prostřednictvím API, které jsi používal od začátku kurzu. Spadají pod Management API, hostované na management-api.x.ai, s následující základní URL:
https://management-api.x.ai/v1
Toto oddělení není architektonickým rozmarem. Vytváření, úprava nebo mazání kolekce jsou administrativní operace s vážnými důsledky, a proto xAI vyžaduje vyhrazený klíč: Management API Key s oprávněním AddFileToCollection. Přínos pro týmy je okamžitý: služba, která dotazuje bázi z tvé veřejné aplikace, obdrží standardní klíč a nemůže nic zničit; pouze tvé ingestion pipeline drží klíč pro správu.
Vytvoření první kolekce
Vytvoření se zredukuje na jediný volání s názvem:
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"}'
Odpověď vrátí identifikátor, který si musíš uložit:
{
"collection_id": "col_xyz789",
"collection_name": "technical-docs",
"created_at": "2026-04-01T10:00:00Z"
}
Vyber tento název pečlivě: objeví se ve všech tvých seznamech a za šest měsíců bude jediným vodítkem, které ti umožní rozlišit dvě sousední báze. Název technical-docs tuto roli splní; test2 ne. Přijmi konvenci již u první kolekce, protože přejmenování báze, na kterou již odkazují tři aplikace, stojí více než její správné pojmenování od začátku.
Pět dostupných operací
Management API exposes a full CRUD set on collections:
| Operace | Metoda | Koncový bod |
|---|---|---|
| Vytvořit | POST | /v1/collections |
| Seznam | GET | /v1/collections |
| Detaily | GET | /v1/collections/{collection_id} |
| Aktualizovat | PUT | /v1/collections/{collection_id} |
| Smazat | DELETE | /v1/collections/{collection_id} |
Výpis tvých kolekcí probíhá bez parametrů a poskytuje užitečný přehled před jakoukoli údržbovou operací:
curl https://management-api.x.ai/v1/collections \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Mazání následuje stejnou logiku a označuje identifikátor získaný při vytvoření:
curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Jedna věc by tě měla uklidnit, když tento příkaz spustíš: smazání kolekce odstraní indexaci, nikoliv soubory. Tvé dokumenty zůstávají přístupné prostřednictvím Files API a mohou být znovu zaindexovány jinde. Ztrácíš strukturu vyhledávání, nikoliv surový materiál – což činí obnovu špatně organizované báze mnohem méně rizikovou, než se zdá.
Klíčové poznatky
- Kolekce sdružují tvoje soubory do indexovaných znalostních bází pro RAG
- Správa probíhá přes Management API (
management-api.x.ai), nikoliv standardní API - Je vyžadován Management API Key s oprávněním
AddFileToCollection - Limity jsou 100 000 souborů a 100 GB na účet
- Pět operací CRUD pokrývá vytváření, čtení, aktualizaci a mazání