Dovoljenja in omejitve zbirk
Na tej strani
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č | Uporaba | Obseg |
|---|---|---|
XAI_API_KEY | Prenos datotek in iskanje | Operacije branja in uporabe |
XAI_MANAGEMENT_API_KEY | Upravljanje zbirk | Administrativne 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:
- Prijavi se v konzolo xAI
- Ustvari nov ključ Management API Key
- Omogoči dovoljenje
AddFileToCollection - 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
AddFileToCollectionje 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