Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Vytváření a správa kolekcí

Lekce 5 z 16 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Od izolovaných souborů k znalostní bázi
  2. Samostatné API a důvody
  3. Vytvoření první kolekce
  4. Pět dostupných operací
  5. Klíčové poznatky

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ů.

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

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:

OperaceMetodaKoncový bod
VytvořitPOST/v1/collections
SeznamGET/v1/collections
DetailyGET/v1/collections/{collection_id}
AktualizovatPUT/v1/collections/{collection_id}
SmazatDELETE/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í