Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Stvaranje i upravljanje kolekcijama

Lekcija 5 od 16 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Od izoliranih datoteka do baze znanja
  2. Zaseban API i razlog za to
  3. Stvori svoju prvu kolekciju
  4. Pet dostupnih operacija
  5. Ključne točke

Od izoliranih datoteka do baze znanja

Do sada je svaki dokument stajao sam za sebe: učitaš ga, referenciraš, a indeks izgrađen za tu priliku nestaje zajedno s upitom. Kolekcije mijenjaju razmjere: grupiraju tvoje datoteke u strukturirane baze znanja, indeksirane jednom i dostupne za upite na neodređeno vrijeme. To je temelj RAG-a (Retrieval-Augmented Generation) s Grokom, a razlika je očita čim tim za podršku pretražuje dvjesto tehničkih listova proizvoda umjesto jednog PDF-a.

Zamisli kolekciju kao pametnu mapu. U nju odlažeš dokumente, xAI ih indeksira za semantičko pretraživanje, a Grok pretražuje tu bazu kako bi precizno odgovorio, izdvajajući tri korisna odlomka među tisućama.

100k
Datoteka po računu
100 GB
Ukupni kapacitet
CRUD
Potpune operacije
$2.50
Po 1.000 pretraživanja

Zaseban API i razlog za to

Kolekcijama ne upravljaš putem API-ja koji si koristio od početka tečaja. One spadaju pod Management API, hostiran na management-api.x.ai, s osnovnim URL-om:

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

Ova odvojenost nije arhitektonski hir. Stvaranje, modificiranje ili brisanje kolekcije su administrativne operacije s teškim posljedicama, pa xAI za njih zahtijeva poseban ključ: Management API Key s dozvolom AddFileToCollection. Prednost je za timove trenutna: servis koji iz tvoje javne aplikacije upituje bazu prima standardni ključ i ne može ništa uništiti; samo tvoj pipeline za unos podataka drži ključ za upravljanje.

Stvori svoju prvu kolekciju

Stvaranje se svodi na jedan poziv s nazivom:

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

Odgovor vraća identifikator koji moraš sačuvati:

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

Odaberi taj naziv pažljivo: pojavit će se na svim tvojim popisima i, za šest mjeseci, bit će jedini trag koji ti omogućuje razlikovanje dviju susjednih baza. technical-docs ispunjava tu ulogu; test2 neće. Usvoji konvenciju imenovanja već kod prve kolekcije jer preimenovanje baze na koju se već oslanjaju tri aplikacije košta više nego da je ispravno nazoveš od početka.

Pet dostupnih operacija

Management API izlaže puni skup CRUD operacija nad kolekcijama:

OperacijaMetodaKrajnja točka (Endpoint)
StvaranjePOST/v1/collections
PopisGET/v1/collections
DetaljiGET/v1/collections/{collection_id}
AžuriranjePUT/v1/collections/{collection_id}
BrisanjeDELETE/v1/collections/{collection_id}

Ispisivanje popisa tvojih kolekcija događa se bez parametara i daje koristan pregled prije bilo kakve operacije održavanja:

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

Brisanje slijedi istu logiku, označavanjem identifikatora dobivenog pri stvaranju:

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

Jedna stvar trebala bi te uvjeriti kada pokreneš ovu naredbu: brisanje kolekcije uklanja indeksiranje, ali ne i datoteke. Tvoji dokumenti ostaju dostupni putem Files API-ja i mogu se ponovno indeksirati drugdje. Gubiš strukturu pretraživanja, a ne sirovi materijal – što činí ponovnu izgradnju loše organizirane baze daleko manje rizičnom nego što se čini.

Ključne točke

  • Kolekcije grupiraju tvoje datoteke u indeksirane baze znanja za RAG
  • Upravljanje se odvija putem Management API-ja (management-api.x.ai), a ne standardnog API-ja
  • Potreban je Management API Key s dozvolom AddFileToCollection
  • Ograničenja su 100.000 datoteka i 100 GB po računu
  • Pet CRUD operacija pokriva stvaranje, čitanje, ažuriranje i brisanje