Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Dovoljenja in omejitve zbirk

Lekcija 8 od 16 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Specifično tveganje baz znanja
  2. Dva ključa, dve vlogi
  3. Dovoljenje AddFileToCollection
  4. Kvote in njihovi stroški
  5. Izoliraj, zavrti, spremljaj
  6. Ena datoteka, več zbirk
  7. Ključne ugotovitve

Specifično tveganje baz znanja

Podjetna baza znanja nikoli ni trivialna stvar: interni zapiski, zaupna poročila, pogodbe v pogajanjih. Če nadzor dostopa odpove, ne razkriješ le ene datoteke – razkriješ celotno bazo, skupaj z iskalnikom, ki poiše tisto, kar je pomembno. xAI-jev sistem dovoljenj to tveganje ublaži z ločevanjem pravic, medtem ko kvote urejajo uporabo in obračunavanje.

Dva ključa, dve vlogi

Ekosistem xAI temelji na dveh poverilnicah za različna področja:

KljučUporabaObseg
XAI_API_KEYPrenos datotek in iskanjeOperacije branja in uporabe
XAI_MANAGEMENT_API_KEYUpravljanje zbirkAdministrativne operacije

Ta ločitev konkretno uveljavlja načelo najmanjših privilegijev. Razvijalec, ki povezuje klepetalnega robota za podporo s tvojo bazo, mora zbirko le poizvedovati, nikoli pa je izbrisati. Če mu dodeliš le standardni ključ, skriptna napaka ali kompromitiran ključ ne moreta uničiti indeksa, ki si ga gradil mesece.

Dovoljenje AddFileToCollection

Ključ Management API po privzetem ni vseveden. Njegove pravice so izrecne, najpomembnejša za zbirke pa je AddFileToCollection. Brez nje lahko zbirk ustvarjaš in jih naštevaš, ne moreš pa dodati niti ene same dokumenta – kar je zmedena situacija, saj vse deluje, dokler ne pride do vnosa podatkov. Generiranje pravilnega ključa vključuje štiri korake:

  1. Prijavi se v konzolo xAI
  2. Ustvari nov ključ Management API Key
  3. Omogoči dovoljenje AddFileToCollection
  4. Ključ varno shrani: okoljska spremenljivka ali upravitelj skrivnosti

Ko dovoljenje manjka, je API izrecen in vrne kodo 403:

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

Tvoj prvi korak naj bo preverjanje pravic ključa v konzoli, namesto da sumiš na zahtevo, katere sintaksa z zavrnitvijo nima ničesar.

Kvote in njihovi stroški

Tri zgornje meje urejajo shrambo na račun: skupno 100.000 datotek, 100 GB kumulativne zmogljivosti in 100 MB na posamezno datoteko v zbirkah – kar je več kot dvakratnik omejitve 48 MB, ki jo dopušča zgolj API za datoteke, kar ti omogoča vključitev dokumentov, ki jih ne bi mogel poslati kot neposredne priloge.

Na strani obračuna izstopata dve postavki: Iskanje po zbirkah (Collections Search) se zaračuna po 2,50 $ na 1.000 klicev iskanja, medtem ko priloge datotek (File Attachments) stanejo 10 $ na 1.000 klicev. Razlika je značilna in vpliva na arhitekturne odločitve. Pri veliki obremenitvi poizvedovanje po indeksirani zbirki stane bistveno manj kot ponovna priloga istega dokumenta ob vsakem vprašanju.

Če tvoje potrebe presegajo te kvote, ti lahko podpora xAI odobri povečanje. Pripravi svojo zahtevo s številkami – ciljno število datotek, skupni volumen, pričakovana pogostost iskanja – namesto z nejasno oceno. To pospeši obravnavo zahteve.

Izoliraj, zavrti, spremljaj

Praksa se najprej nanaša na ključe. Dodeli različne ključe za vsako okolje, tako da razvojna skripta nikoli ne more dostopati do produkcijske baze. Nikoli ne daj ključa Management storitvi, ki potrebuje le iskanje. Te ključe redno menjaj, še posebej potem, ko podjetje zapusti sodelavec z dostopom do skrivnosti.

Druga praksa se nanaša na strukturo. Namesto ene same zbirke, kjer sobivata javna dokumentacija in pogodbe, loči svoje baze glede na stopnjo zaupnosti: „javna” baza za odprto dokumentacijo, „interna” baza za podjetniške dokumente in „zaupna” baza za občutljive podatke. Vsaka storitev tako prejme le dostop, ki ga potrebuje, na vprašanje „ali lahko ta klepetalni robot citira pogodbo?” pa je odgovor že vgrajen v zasnovo.

Tretja je spremljanje. Preveri svojo porabo v konzoli xAI, nastavi opozorilo ob vsakem nepričakovanem porastu obsega iskanja – kar je pogosto prvi znak zanke, ki se je izmaknila nadzoru – in vodi pisni zapis o tem, katere storitve dostopajo do katerih zbirk.

Ena datoteka, več zbirk

Ta izolacija ne zahteva podvajanja tvojih dokumentov, saj lahko ista datoteka pripada več zbirkam. Tehnično poročilo se tako pojavi v „product-documentation” za tehnično ekipo, v „quarterly-reports” za vodstvo in v „support-base” za službo za pomoč strankam. Shranjena je le enkrat, šteje se le enkrat v tvoje kvote in ostaja iskana v vseh treh kontekstih – tematski pogledi po občinstvu, brez divergentnih kopij.

Ključne ugotovitve

  • Dva različna ključa API: standardni za uporabo, Management za administracijo
  • Dovoljenje AddFileToCollection je nujno za polnjenje zbirk
  • Omejitve so 100.000 datotek, 100 GB in 100 MB na datoteko
  • Loči svoje zbirke glede na stopnjo zaupnosti
  • Datoteka lahko pripada več zbirkam brez podvajanja