Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Oħloq u ġestixxi l-kollezzjonijiet

Lezzjoni 5 / 16 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Minn fajls iżolati għal bażi tal-għarfien
  2. API separat, u għaliex
  3. Oħloq l-ewwel kollezzjoni tiegħek
  4. Il-ħames operazzjonijiet disponibbli
  5. Punti Ewlenin

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.

100k
Fajls għal kull kont
100 GB
Kapaċità totali
CRUD
Operazzjonijiet sħaħ
$2.50
Għal kull 1,000 tiftixa

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:

OperazzjoniMetoduEndpoint
OħloqPOST/v1/collections
ElenskaGET/v1/collections
DettaljiGET/v1/collections/{collection_id}
AġġornaPUT/v1/collections/{collection_id}
ĦassarDELETE/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