Oħloq u ġestixxi l-kollezzjonijiet
F'din il-paġna
Minn fajls iżolati għal bażi tal-għarfien
S’issa, kull dokument kien wieqed waħdu: kont ittellgħu, tirreferenzjah, u l-indiċi mibni għall-okkażjoni kien jisparixxi mal-mistoqsija. Il-kollezzjonijiet ibiddlu l-iskala: jiggruppow il-fajls tiegħek f’bażijiet tal-għarfien strutturati, indiċjati darba biss u li jistgħu jiġu kkonsultati għal żmien indefinit. Din hija l-bażi tar-RAG—Retrieval-Augmented Generation—ma’ Grok, u d-differenza tidher hekk kif tim ta’ appoġġ jikkonsulta mitejn skeda tal-prodott minflok PDF wieħed.
Ħu l-kollezzjoni bħala folder intelliġenti. Tiddipożita d-dokumenti, xAI tindċjahom għat-tiftix semantiku, u Grok ifittex f’din il-bażi biex iwieġeb b’preċiżjoni, jiġbed it-tliet passi utli fost eluf.
API separat, u għaliex
Inti ma tiġestixxix il-kollezzjonijiet mill-API li użajt mill-bidu tal-kors. Dawn jaqgħu taħt l-Management API, ospitat fuq management-api.x.ai, bl-URL bażi:
https://management-api.x.ai/v1
Din is-separazzjoni mhix kapriċċ arkitettoniku. Il-ħolqien, il-modifika jew it-tħassir ta’ kollezzjoni huma operazzjonijiet amministrattivi b’konsegwenzi tqal, u xAI jeħtieġ ċavetta ddedikata għalihom: Management API Key, bil-permess AddFileToCollection. Il-benefiċċju huwa immedjat għat-timijiet: is-servizz li jikkonsulta l-bażi mill-applikazzjoni pubblika tiegħek jirċievi ċ-ċavetta standard u ma jista’ jeqred xejn; biss il-pipeline ta’ ingestjoni tiegħek iżomm iċ-ċavetta tal-ġestjoni.
Oħloq l-ewwel kollezzjoni tiegħek
Il-ħolqien jinżel għal sejħa waħda b’isem:
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"}'
Ir-risposta tirritorna l-identifikatur li għandek iżżomm:
{
"collection_id": "col_xyz789",
"collection_name": "technical-docs",
"created_at": "2026-04-01T10:00:00Z"
}
Agħżel dan l-isem bir-reqqa: jidher fil-listi kollha tiegħek u, sitt xhur wara, ikun l-unika indizju li jħallik tiddistingwi żewġ bażijiet ħdejn xulxin. technical-docs iwettaq dan ir-rwol; test2 le. Adotta konvenzjoni mill-ewwel kollezzjoni, għax li tibdel isem bażi diġà referenzjata minn tliet applikazzjonijiet jisw aktar milli li tsemmiha tajjeb mill-bidu.
Il-ħames operazzjonijiet disponibbli
Il-Management API jesponi sett sħiħ ta’ CRUD fuq il-kollezzjonijiet:
| Operazzjoni | Metodu | Endpoint |
|---|---|---|
| Oħloq | POST | /v1/collections |
| Elenska | GET | /v1/collections |
| Dettalji | GET | /v1/collections/{collection_id} |
| Aġġorna | PUT | /v1/collections/{collection_id} |
| Ħassar | DELETE | /v1/collections/{collection_id} |
L-elencar tal-kollezzjonijiet tiegħek iseħħ mingħajr parametri u jagħti ħarsa ġenerali utli qabel kwalunkwe operazzjoni ta’ manutenzjoni:
curl https://management-api.x.ai/v1/collections \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
It-tħassir isegwi l-istess loġika, billi jindika l-identifikatur miksub fil-ħolqien:
curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Hemm affari waħda li għandha tikkonfortak meta tmexxi dan il-kmand: it-tħassir ta’ kollezzjoni jneħħi l-indiċjar, mhux il-fajls. Id-dokumenti tiegħek jibqgħu aċċessibbli permezz tal-Files API u jistgħu jiġu indiċjati mill-ġdid f’post ieħor. Titlifx l-istruttura tat-tiftix, mhux il-materja prima—li jagħmel li terġa’ tibni bażi organizzata ħażin inqas riskjuża milli tidher.
Punti Ewlenin
- Il-kollezzjonijiet jiggruppow il-fajls tiegħek f’bażijiet tal-għarfien indiċjati għar-RAG
- Il-ġestjoni ssir permezz tal-Management API (
management-api.x.ai), mhux l-API standard - Hi meħtieġa Management API Key bil-permess
AddFileToCollection - Il-limiti huma 100,000 fajl u 100 GB għal kull kont
- Il-ħames operazzjonijiet CRUD ikopru l-ħolqien, il-qari, l-aġġornament u t-tħassir