Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Kogumite õigused ja piirangud

Õppetund 8 / 16 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Teadmistebaaside spetsiifiline risk
  2. Kaks võtit, kaks rolli
  3. AddFileToCollection luba
  4. Kvoodid ja nende kulud
  5. Isolateeri, pööra, jälgi
  6. Üks fail, mitu kogumit
  7. Peamised punktid

Teadmistebaaside spetsiifiline risk

Ettevõtte teadmistebaas pole kunagi tühiasi: sisemised märkmed, konfidentsiaalsed aruanded, läbirääkimistel olevad lepingud. Kui juurdepääsukontrollid ebaõnnestuvad, ei lekita mitte ainult üksikut faili, vaid paljastatakse kogu baas koos otsingumootoriga, mis aitab leida just seda, mis oluline on. xAI õigussüsteem leevendab seda riski, eraldades õigused, samas kui kvoodid reguleerivad kasutust ja arveldust.

Kaks võtit, kaks rolli

xAI ökosüsteem tugineb kahele erineva ulatusega mandaadile:

VõtiKasutusUlatus
XAI_API_KEYFailide üleslaadimine ja otsingLugemis- ja kasutustoimingud
XAI_MANAGEMENT_API_KEYKogumite haldusHaldustoimingud

See eraldamine rakendab konkreetset vähimate õiguste printsiipi. Arendaja, kes ühendab tugichatbotti sinu baasiga, peab saama kogumit pärida, mitte seda kunagi kustutada. Andes talle ainult standardvõtme, ei saa skriptiviga või kompromiteeritud võti hävitada kuude jooksul üles ehitatud indeksit.

AddFileToCollection luba

Haldus-API võti pole vaikimisi kõikvõimas. Selle õigused on sõnaselged ja kogumite jaoks on kõige kriitilisem neist AddFileToCollection. Ilma selleta saad küll kogumeid luua ja loetleda, kuid ei saa lisada ainsatki dokumenti – see tekitab segadust, kuna kõik näib toimivat kuni sisestamiseni. Õige võtme genereerimine koosneb neljast sammust:

  1. Logi sisse xAI konsooli
  2. Loo uus haldus-API võti
  3. Luba õigus AddFileToCollection
  4. Salvesta võti turvaliselt: keskkonnamuutujana või saladuste halduris

Kui luba puudub, on API selge ja tagastab veakoodi 403:

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

Sinu esimene samm peaks olema kontrollida võtme õigusi konsoolis, selle asemel et kahtlustada päringut, mille süntaksil pole tagasilükkamisega midagi pistmist.

Kvoodid ja nende kulud

Kontot reguleerivad kolm ladustamise ülempiiri: kokku 100 000 faili, mahutavust 100 GB ja 100 MB ühe faili kohta kogumites – see on enam kui kaks korda rohkem kui Files API poolt lubatud 48 MB, võimaldades kaasata dokumente, mida ei saaks saata otseste manustena.

Arvelduse osas paistavad silma kaks rida: Kogumite otsingut arveldatakse 2,50 dollari eest 1000 otsingukõne kohta, samas kui failide manused maksavad 10 dollarit 1000 kõne kohta. Erinevus on märkimisväärne ja mõjutab arhitektuuri valikuid. Suure koormuse korral maksab indekseeritud kogumi pärimine oluliselt vähem kui sama dokumendi iga küsimusega uuesti manustamine.

Kui sinu vajadused ületavad need kvoodid, võib xAI tugi anda suurendust. Valmista oma taotlus ette numbritega – sihtfailide arv, kogumaht, eeldatav otsingusagedus – mitte ebamäärase hinnanguga. See kiirendab taotluse menetlemist.

Isolateeri, pööra, jälgi

Esimene tava puudutab võtmeid. Määra igale keskkonnale erinevad võtmed, nii et arendusskript ei saaks kunagi puutuda tootmisbaasi. Ära anna haldusvõtit teenusele, mille ainus vajadus on otsing. Ja pööra neid võtmeid regulaarselt, eriti pärast seda, kui saladustele ligipääsu omav kaaslane lahkub.

Teine puudutab struktuuri. Üheainsa kogumi asemel, kus avalik dokumentatsioon ja lepingud koos eksisteerivad, eralda oma baasid konfidentsiaalsuse taseme järgi: „avalik“ baas avatud dokumentatsioonile, „sisemine“ baas ettevõtte dokumentidele ja „konfidentsiaalne“ baas tundlikele andmetele. Iga teenus saab seejärel ainult vajaliku juurdepääsu ja küsimusele „kas see chatbot saab lepingut tsiteerida?“ on vastus juba disaini sisse ehitatud.

Kolmas on jälgimine. Kontrolli oma tarbimist xAI konsoolis, sea häire iga ootamatu otsingumahu tõusu korral – mis on sageli esimene märk lõputust tsüklist – ja pea kirjalikku arvestust sellest, millised teenused millistele kogumitele ligi pääsevad.

Üks fail, mitu kogumit

See isolatsioon ei nõua dokumentide dubleerimist, kuna sama fail võib kuuluda mitmesse kogumisse. Tehniline aruanne ilmub seega nii tehnilise meeskonna „toote-dokumentatsiooni“, juhtkonna „kvartaliaruannete“ kui ka klienditeeninduse „tugibaasi“. See salvestatakse ainult üks kord, loetakse kvootidesse ainult üks kord ja jääb otsitavaks kõigis kolmes kontekstis – temaatilised vaated sihtrühma järgi, ilma erinevate koopiateta.

Peamised punktid

  • Kaks erinevat API võtit: standard kasutuseks, haldus võti administratsiooniks
  • Luba AddFileToCollection on kogumite täitmiseks hädavajalik
  • Piirangud on 100 000 faili, 100 GB ja 100 MB faili kohta
  • Eralda oma kogumid konfidentsiaalsuse taseme järgi
  • Fail võib kuuluda mitmesse kogumisse ilma dubleerimiseta