Ustvarjanje in upravljanje zbirk
Na tej strani
Od osamljenih datotek do zbirke znanja
Do zdaj je vsak dokument stal sam zase: naložil si ga, se nanj skliceval in indeks, zgrajen za to priložnost, je izginil skupaj z poizvedbo. Zbirke spremenijo merilo: tvoje datoteke združijo v strukturirane zbirke znanja, ki so indeksirane enkrat in na voljo za poizvedbe za nedoločen čas. To je temelj tehnologije RAG (Retrieval-Augmented Generation) z orodjem Grok, razlika pa postane očitna, ko ekipa za podporo poišče podatke v dvesto tehničnih listih namesto v enem samem PDF-u.
Na zbirko glej kot na pametno mapo. Vanjo odložiš dokumente, xAI jih indeksira za semantično iskanje, Grok pa preišče to bazo, da natančno odgovori in izmed tisočev izvleče tri koristne odlomke.
Ločen API in razlogi zanj
Zbirk ne upravljaš prek API-ja, ki si ga uporabljal od začetka tečaja. Spadajo pod Management API, ki gostuje na naslovu management-api.x.ai, z osnovnim URL-jem:
https://management-api.x.ai/v1
Ta ločitev ni arhitekturna muha. Ustvarjanje, spreminjanje ali brisanje zbirke so upravne operacije s težkimi posledicami, zato xAI zanje zahteva poseben ključ: Management API Key z dovoljenjem AddFileToCollection. Prednost za ekipe je takojšnja: storitev, ki poizveduje po bazi iz tvoje javne aplikacije, prejme standardni ključ in ne more ničesar uničiti; ključ za upravljanje ima le tvoj cevovod za vnos podatkov.
Ustvari svojo prvo zbirko
Ustvarjanje se zreducira na en sam klic z imenom:
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 vrne identifikator, ki si ga moraš zapomniti:
{
"collection_id": "col_xyz789",
"collection_name": "technical-docs",
"created_at": "2026-04-01T10:00:00Z"
}
Ime izberi skrbno: pojavilo se bo na vseh tvojih seznamih in čez šest mesecev bo edini namig, ki ti bo omogočil razlikovanje med dvema sosednjima bazama. Ime technical-docs to vlogo opravi, test2 pa ne. Sprejmi konvencijo že pri prvi zbirki, saj preimenovanje baze, na katero se že sklicujejo tri aplikacije, stane več kot dobro poimenovanje od samega začetka.
Pet razpoložljivih operacij
Management API omogoča celoten nabor operacij CRUD za zbirke:
| Operacija | Metoda | Končna točka |
|---|---|---|
| Ustvari | POST | /v1/collections |
| Seznam | GET | /v1/collections |
| Podrobnosti | GET | /v1/collections/{collection_id} |
| Posodobi | PUT | /v1/collections/{collection_id} |
| Izbriši | DELETE | /v1/collections/{collection_id} |
Izpis tvojih zbirk poteka brez parametrov in pred vsakim vzdrževalnim posegom ponudi koristen pregled:
curl https://management-api.x.ai/v1/collections \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Brisanje sledi isti logiki, pri čemer določiš identifikator, pridobljen ob ustvarjanju:
curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Ena stvar naj te pomiri, ko zaženeš ta ukaz: brisanje zbirke odstrani indeksiranje, ne pa datotek. Tvoji dokumenti ostanejo dostopni prek Files API in jih lahko ponovno indeksiraš drugje. Izgubiš strukturo za iskanje, ne pa surovega gradiva – kar pomeni, da je ponovna gradnja slabo organizirane baze veliko manj tvegana, kot se zdi.
Ključne ugotovitve
- Zbirke združujejo tvoje datoteke v indeksirane zbirke znanja za RAG
- Upravljanje poteka prek Management API (
management-api.x.ai), ne standardnega API-ja - Potreben je Management API Key z dovoljenjem
AddFileToCollection - Omejitve znašajo 100.000 datotek in 100 GB na račun
- Pet operacij CRUD pokriva ustvarjanje, branje, posodabljanje in brisanje