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

Permessi u Limiti tal-Kollezzjonijiet

Lezzjoni 8 / 16 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Ir-riskju speċifiku tal-bażijiet tal-għarfien
  2. Żewġ ċwievet, żewġ rwoli
  3. Il-permess AddFileToCollection
  4. Kwoti u l-ispejjeż tagħhom
  5. Iżola, dawwar, immonitorja
  6. Fajl wieħed, kollezzjonijiet multipli
  7. Punti Ewlenin

Ir-riskju speċifiku tal-bażijiet tal-għarfien

Bażi tal-għarfien tal-intrapriża qatt ma hija affari triviali: noti interni, rapporti kunfidenzjali, kuntratti taħt negozjazzjoni. Jekk il-kontrolli tal-aċċess ifallu, ma tnixxix fajl wieħed biss—tesponi l-bażi kollha, flimkien ma’ magna ta’ tfittxija biex issib dak li jimpurtak. Is-sistema ta’ permessi ta’ xAI tnaqqas dan ir-riskju billi tissepara d-drittijiet, filwaqt li l-kwoti jirregolaw l-użu u l-fatturar.

Żewġ ċwievet, żewġ rwoli

L-ekosistema xAI tiddependi fuq żewġ kredenzjali għal ambiti distinti:

ĊavettaUżuAmbitu
XAI_API_KEYTlugħ ta’ fajls u tfittxijaOperazzjonijiet ta’ qari u użu
XAI_MANAGEMENT_API_KEYĠestjoni tal-kollezzjonijietOperazzjonijiet ta’ amministrazzjoni

Din is-separazzjoni tapplika l-prinċipju tal-inqas privileġġ b’mod konkret. Żviluppatur li jqabbad chatbot tas-sapport mal-bażi tiegħek jeħtieġ li jikkonsulta l-kollezzjoni, qatt ma jħassarha. Billi tagħtihom biss iċ-ċavetta standard, żball fl-iskritt jew ċavetta kompromessa ma tistax teqred indiċi mibni fuq perjodu ta’ xhur.

Il-permess AddFileToCollection

Ċavetta tal-API ta’ Ġestjoni (Management API Key) mhix onnipotenti b’mod awtomatiku. Id-drittijiet tagħha huma espliċiti, u l-aktar wieħed kritiku għall-kollezzjonijiet huwa AddFileToCollection. Mingħajru, tista’ toħloq u telenka l-kollezzjonijiet iżda ma tistax iżżid dokument wieħed—sitwazzjoni konfuża, peress li kollox jidher li jaħdem sakemm ma tibdiex l-inġestjoni. Il-ġenerazzjoni ta’ ċavetta korretta tinvolvi erba’ passi:

  1. Idħol fil-konsowl ta’ xAI
  2. Oħloq ċavetta ġdida tal-API ta’ Ġestjoni (Management API Key)
  3. Ippermetti l-permess AddFileToCollection
  4. Aħżen iċ-ċavetta b’mod sikur: varjabbli tal-ambjent jew maniġer tas-sigrieti

Meta l-permess jonqos, l-API tkun espliċita u tirritorna 403:

{
  "error": {
    "message": "Insufficient permissions",
    "type": "permission_error",
    "code": 403
  }
}

L-ewwel pass tiegħek għandu jkun li tiċċekkja d-drittijiet taċ-ċavetta fil-konsowl minflok ma tissuspetta t-talba, li s-sintassi tagħha m’għandha x’taqsam xejn mar-rifjut.

Kwoti u l-ispejjeż tagħhom

Tliet limiti jirregolaw il-ħażna għal kull kont: 100,000 fajl totali, 100 GB ta’ kapaċità kumulattiva, u 100 MB għal kull fajl individwali fil-kollezzjonijiet—aktar mid-doppju tal-48 MB permessi mill-API tal-Fajls (Files API) waħedha, li jħallik tinkludi dokumenti li ma kontix tkun tista’ tibgħat bħala allegati diretti.

Fuq in-naħa tal-fatturar, żewġ linji jispikkaw: It-Tfittxija fil-Kollezzjonijiet (Collections Search) tiġi fatturata b’$2.50 għal kull 1,000 sejħa ta’ tfittxija, filwaqt li l-Allegati tal-Fajls (File Attachments) jiswew $10 għal kull 1,000 sejħa. Id-differenza hija sinifikanti u tiżen fuq l-għażliet arkitettoniċi. Taħt użu intens, l-ikkonsultar ta’ kollezzjoni indiċjata jiswi ferm inqas milli terġa’ tagħmel allegat tal-istess dokument ma’ kull mistoqsija.

Jekk il-ħtiġijiet tiegħek jaqbżu dawn il-kwoti, is-sapport ta’ xAI jista’ jagħti żieda. Ipprepara t-talba tiegħek b’figuri—għadd ta’ fajls fil-mira, volum totali, frekwenza mistennija ta’ tfittxija—minflok stima vaga. Dan iħaffef l-ipproċessar tat-talba.

Iżola, dawwar, immonitorja

L-ewwel prattika tikkonċerna ċ-ċwievet. Assenja ċwievet differenti għal kull ambjent, sabiex skritt ta’ żvilupp qatt ma jkun jista’ jmiss il-bażi tal-produzzjoni. Qatt ma tagħti ċavetta ta’ Ġestjoni (Management) lil servizz li l-unika ħtieġa tiegħu hija t-tfittxija. U dawwar dawn iċ-ċwievet regolarment, speċjalment wara li kollaboratur b’aċċess għas-sigrieti jitlaq.

It-tieni tikkonċerna l-istruttura. Minflok kollezzjoni waħda fejn id-dokumentazzjoni pubblika u l-kuntratti jikkoegżistu, ifred il-bażijiet tiegħek skont il-livell ta’ kunfidenzjalità: bażi “pubblika” għad-dokumentazzjoni miftuħa, bażi “interna” għad-dokumenti tal-kumpanija, u bażi “kunfidenzjali” għad-data sensittiva. Kull servizz imbagħad jirċievi biss l-aċċess li jeħtieġ, u l-mistoqsija “dan iċ-chatbot jista’ jikkonferma kuntratt?” tiġi mwieġba permezz tad-disinn.

It-tielet hija l-monitoraġġ. Iċċekkja l-konsum tiegħek fil-konsowl ta’ xAI, issettja allert fuq kwalunkwe żieda mhux mistennija fil-volum ta’ tfittxija—spiss l-ewwel sinjal ta’ ċiklu barra kontroll—u żomm rekord miktub ta’ liema servizzi jaċċessaw liema kollezzjonijiet.

Fajl wieħed, kollezzjonijiet multipli

Dan l-iżolament ma jeħtieġx id-duplikazzjoni tad-dokumenti tiegħek, peress li l-istess fajl jista’ jappartjeni għal kollezzjonijiet multipli. Rapport tekniku hekk jidher f‘“product-documentation” għat-tim tekniku, f‘“quarterly-reports” għall-maniġment, u f‘“support-base” għas-servizz tal-klijenti. Huwa maħżun darba biss, jingħodd darba biss lejn il-kwoti tiegħek, u jibqa’ searchable fit-tliet kuntesti—veduti tematiċi skont l-udjenza, mingħajr kopji diverġenti.

Punti Ewlenin

  • Żewġ ċwievet API distinti: standard għall-użu, Ġestjoni għall-amministrazzjoni
  • Il-permess AddFileToCollection huwa essenzjali biex timla l-kollezzjonijiet
  • Il-limiti huma 100,000 fajl, 100 GB, u 100 MB għal kull fajl
  • Ifred il-kollezzjonijiet tiegħek skont il-livell ta’ kunfidenzjalità
  • Fajl jista’ jappartjeni għal kollezzjonijiet multipli mingħajr duplikazzjoni