Kogumike loomine ja haldamine
Sellel lehel
Ü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.
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:
| Toiming | Meetod | Lõpp-punkt |
|---|---|---|
| Loo | POST | /v1/collections |
| Loetle | GET | /v1/collections |
| Üksikasjad | GET | /v1/collections/{collection_id} |
| Uuenda | PUT | /v1/collections/{collection_id} |
| Kustuta | DELETE | /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