Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Kolekcijų leidimai ir apribojimai

Paskaita 8 iš 16 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Specifinė žinių bazių rizika
  2. Du raktai, du vaidmenys
  3. Leidimas „AddFileToCollection“
  4. Kvotos ir jų kaina
  5. Izoliuokite, keiskite, stebėkite
  6. Vienas failas, kelios kolekcijos
  7. Svarbiausi punktai

Specifinė žinių bazių rizika

Įmonės žinių bazė niekada nėra trivialus dalykas: joje saugomi vidiniai užrašai, konfidencialios ataskaitos, derinamos sutartys. Jei prieigos valdymas sugenda, nutekina ne tik vieną failą – atveriama visa bazė kartu su paieškos varikliu, leidžiančiu rasti tai, kas svarbu. xAI leidimų sistema šią riziką mažina atskirdama teises, o kvotos reguliuoja naudojimą ir atsiskaitymą.

Du raktai, du vaidmenys

xAI ekosistema naudoja du skirtingus prisijungimo duomenis skirtingoms sritims:

RaktasNaudojimasApimtis
XAI_API_KEYFailų įkėlimas ir paieškaSkaitymo ir naudojimo operacijos
XAI_MANAGEMENT_API_KEYKolekcijų valdymasAdministravimo operacijos

Šis atskyrimas konkrečiai įgyvendina mažiausių privilegijų principą. Kūrėjui, prijungiančiam pagalbos pokalbių robotą prie jūsų bazės, reikia tik užklausti kolekciją, bet niekada jos ištrinti. Suteikus tik standartinį raktą, klaida skripte ar pavogtas raktas negalės sunaikinti per mėnesius kurtos rodyklės.

Leidimas „AddFileToCollection“

Valdymo API raktas pagal nutylėjimą nėra visagalis. Jo teisės yra aiškiai apibrėžtos, o kolekcijoms kritiškiausia yra AddFileToCollection. Be jos galite kurti ir išvardyti kolekcijas, bet negalite pridėti nė vieno dokumento – tai paini situacija, nes viskas atrodo veikiant iki pat duomenų įsisavinimo. Norint sugeneruoti tinkamą raktą, reikia atlikti keturis žingsnius:

  1. Prisijunkite prie xAI konsolės
  2. Sukurkite naują Valdymo API raktą
  3. Įjunkite AddFileToCollection leidimą
  4. Saugiai išsaugokite raktą: naudokite aplinkos kintamąjį arba paslapčių valdyklę

Kai leidimo trūksta, API aiškiai tai nurodo ir grąžina 403 klaidą:

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

Pirmasis jūsų žingsnis turėtų būti patikrinti rakto teises konsolėje, o ne įtarti užklausos, kurios sintaksas neturi nieko bendro su atmetimu.

Kvotos ir jų kaina

Saugojimui vienai paskyrai taikomos trys ribos: iš viso 100 000 failų, bendra talpa 100 GB ir 100 MB vienam individualiam failui kolekcijose – tai daugiau nei dvigubai viršija 48 MB, leidžiamus vien tik Files API, todėl galite įtraukti dokumentus, kurių negalėtumėte siųsti kaip tiesioginių priedų.

Mokėjimų požiūriu išsiskiria dvi eilutės: „Collections Search“ kainuoja 2,50 USD už 1 000 paieškos užklausų, o „File Attachments“ – 10 USD už 1 000 užklausų. Skirtumas reikšmingas ir daro įtaką architektūriniams sprendimams. Esant dideliam krūviui, užklausos indeksuotai kolekcijai kainuoja žymiai mažiau nei to paties dokumento pridėjimas prie kiekvieno klausimo iš naujo.

Jei jūsų poreikiai viršija šias kvotas, xAI pagalba gali suteikti padidinimą. Ruošdami prašymą pateikite skaičius – tikslų failų skaičių, bendrą apimtį, numatomą paieškos dažnumą – o ne miglotus įverčius. Tai pagreitins prašymo nagrinėjimą.

Izoliuokite, keiskite, stebėkite

Pirmoji praktika susijusi su raktais. Skirkite skirtingus raktus kiekvienai aplinkai, kad kūrimo skriptas niekada negalėtų liesti gamybinės bazės. Niekada nesuteikite Valdymo rakto servisui, kuriam reikia tik paieškos. Reguliariai keiskite šiuos raktus, ypač kai prieigą prie paslapčių turėjęs bendradarbis išeina iš darbo.

Antroji susijusi su struktūra. Užuot kūrę vieną kolekciją, kurioje greta egzistuoja vieša dokumentacija ir sutartys, atskirkite savo bazes pagal konfidencialumo lygį: „vieša“ bazė atvirai dokumentacijai, „vidinė“ – įmonės dokumentams ir „konfidenciali“ – jautriems duomenims. Kiekvienas servisas tada gauna tik jam reikalingą prieigą, o klausimas „ar šis pokalbių robotas gali cituoti sutartį?“ yra išspręstas jau projektuojant.

Trečioji – stebėsena. Konsolėje tikrinkite savo suvartojimą, nustatykite įspėjimą bet kokiam netikėtam paieškos apimties šuoliui – tai dažnai pirmasis nesuvaldomos kilpos požymis – ir raštu fiksuokite, kurie servisai turi prieigą prie kurių kolekcijų.

Vienas failas, kelios kolekcijos

Ši izoliacija nereikalauja dubliuoti dokumentų, nes tas pats failas gali priklausyti kelioms kolekcijoms. Techninė ataskaita taip gali atsirasti „product-documentation“ techninei komandai, „quarterly-reports“ vadovybei ir „support-base“ klientų aptarnavimui. Ji saugoma tik vieną kartą, į kvotą įskaičiuojama vieną kartą ir lieka ieškoma visuose trijuose kontekstuose – teminiai rodiniai pagal auditoriją be dubliuojamų kopijų.

Svarbiausi punktai

  • Du skirtingi API raktai: standartinis naudojimui, Valdymo – administravimui
  • Leidimas AddFileToCollection yra būtinas kolekcijų pildymui
  • Ribos: 100 000 failų, 100 GB ir 100 MB vienam failui
  • Atskirkite savo kolekcijas pagal konfidencialumo lygį
  • Failas gali priklausyti kelioms kolekcijoms be dubliavimo