Permessi u Limiti tal-Kollezzjonijiet
F'din il-paġna
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:
| Ċavetta | Użu | Ambitu |
|---|---|---|
XAI_API_KEY | Tlugħ ta’ fajls u tfittxija | Operazzjonijiet ta’ qari u użu |
XAI_MANAGEMENT_API_KEY | Ġestjoni tal-kollezzjonijiet | Operazzjonijiet 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:
- Idħol fil-konsowl ta’ xAI
- Oħloq ċavetta ġdida tal-API ta’ Ġestjoni (Management API Key)
- Ippermetti l-permess
AddFileToCollection - 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
AddFileToCollectionhuwa 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