Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Kogumike loomine ja haldamine

Õppetund 5 / 16 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Üksikutest failidest teadmiste baasini
  2. Eraldi API ja selle põhjus
  3. Loo oma esimene kogumik
  4. Viis saadaolevat toimingut
  5. Peamised punktid

Üksikutest failidest teadmiste baasini

Seni seisis iga dokument omaette: laadisid selle üles, viitasid sellele ja sel puhuks loodud indeks kadus koos päringuga. Kogumikud muudavad mastaapi: need grupeerivad su failid struktureeritud teadmiste baasideks, mis indekseeritakse üks kord ja on seejärel määramatu aja jooksul päritavad. See on RAG-i (Retrieval-Augmented Generation) alus Grokiga ning erinevus tuleb selgelt välja, kui tugimeeskond otsib kahest sajast tootelehest, mitte ühestainsast PDF-failist.

Mõtle kogumikule kui targale kaustale. Sa laadid sinna dokumente, xAI indekseerib need semantiliseks otsinguks ja Grok otsib sellest baasist, et vastata täpselt, tuues välja kolm kasulikku lõiku tuhandete seast.

100k
Faile konto kohta
100 GB
Kogumaht
CRUD
Täielikud toimingud
$2.50
1000 otsingu kohta

Eraldi API ja selle põhjus

Sa ei halda kogumikke API kaudu, mida oled kursuse algusest saadik kasutanud. Need kuuluvad haldus-API (Management API) alla, mida majutatakse aadressil management-api.x.ai baas-URL-iga:

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

See eraldamine pole arhitektuurne kapriis. Kogumiku loomine, muutmine või kustutamine on haldustoimingud, millel on suured tagajärjed, ja xAI nõuab nende jaoks spetsiaalset võtit: haldus-API võtit (Management API Key) õigusega AddFileToCollection. Kasu meeskondadele on kohene: teenus, mis pärib baasi sinu avalikust rakendusest, saab tavalise võtme ega saa midagi hävitada; ainult sinu andmesisestuse torustik hoiab haldusvõtit.

Loo oma esimene kogumik

Loomine taandub ühele väljakutsele nimega:

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

Vastus tagastab säilitatava identifikaatori:

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

Vali see nimi hoolikalt: see ilmub kõigisse su loenditesse ja kuue kuu pärast on see ainus vihje, mis võimaldab eristada kaht kõrvutiasuvat baasi. technical-docs täidab seda rolli; test2 mitte. Võta kasutusele konventsioon juba esimesest kogumikust alates, sest baasi ümbernimetamine, millele viitavad juba kolm rakendust, maksab rohkem kui selle algusest peale korralik nimetamine.

Viis saadaolevat toimingut

Haldus-API pakub kogumikele täielikku CRUD-komplekti:

ToimingMeetodLõpp-punkt
LooPOST/v1/collections
LoetleGET/v1/collections
ÜksikasjadGET/v1/collections/{collection_id}
UuendaPUT/v1/collections/{collection_id}
KustutaDELETE/v1/collections/{collection_id}

Oma kogumike loetlemine toimub ilma parameetriteta ja annab kasuliku ülevaate enne mis tahes hooldustoimingut:

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

Kustutamine järgib sama loogikat, määrates loomisel saadud identifikaatori:

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

Üks asi peaks sind selle käsu käivitamisel rahustama: kogumiku kustutamine eemaldab indekseerimise, mitte faile. Su dokumendid jäävad failide API kaudu kättesaadavaks ja neid saab mujal uuesti indekseerida. Sa kaotad otsingustruktuuri, mitte toormaterjali – mis teeb halvasti organiseeritud baasi ülesehitamise palju vähem riskantseks, kui esmapilgul tundub.

Peamised punktid

  • Kogumikud grupeerivad su failid indekseeritud teadmiste baasideks RAG-i jaoks
  • Haldamine toimub haldus-API (management-api.x.ai) kaudu, mitte tavalise API kaudu
  • Vajalik on haldus-API võti õigusega AddFileToCollection
  • Piirangud on 100 000 faili ja 100 GB konto kohta
  • Viis CRUD-toimingut katavad loomise, lugemise, uuendamise ja kustutamise