Dozvole i ograničenja kolekcija
Na ovoj stranici
Specifični rizik baza znanja
Poslovna baza znanja nikada nije trivijalna stvar: interni zapisi, povjerljiva izvješća, ugovori u pregovorima. Ako kontrole pristupa zakažu, ne curi samo jedna datoteka – otkrivaš cijelu bazu, zajedno s tražilicom koja pronalazi ono što je bitno. xAI-ov sustav dozvola ublažava taj rizik razdvajanjem prava, dok kvote upravljaju korištenjem i naplatom.
Dva ključa, dvije uloge
xAI ekosustav oslanja se na dvije vjerodajnice za različite opsege:
| Ključ | Upotreba | Opseg |
|---|---|---|
XAI_API_KEY | Prijenos datoteka i pretraživanje | Operacije čitanja i korištenja |
XAI_MANAGEMENT_API_KEY | Upravljanje kolekcijama | Administrativne operacije |
Ovo razdvajanje konkretno primjenjuje princip najmanjih privilegija. Programeru koji povezuje chatbot za podršku s tvojom bazom treba mogućnost upita nad kolekcijom, nikada njezino brisanje. Dodjelom samo standardnog ključa, skriptna pogreška ili kompromitirani ključ ne mogu uništiti indeks građen mjesecima.
Dozvola AddFileToCollection
Management API ključ po defaultu nije svemoćan. Njegova prava su eksplicitna, a najkritičnija za kolekcije je AddFileToCollection. Bez nje možeš stvarati i izlistavati kolekcije, ali ne možeš dodati niti jedan dokument – zbunjujuća situacija jer sve djeluje ispravno sve do ingestije. Generiranje ispravnog ključa uključuje četiri koraka:
- Prijavi se u xAI konzolu
- Stvori novi Management API ključ
- Omogući dozvolu
AddFileToCollection - Sigurno pohrani ključ: varijabla okruženja ili upravitelj tajnama
Kada dozvola nedostaje, API je eksplicitan i vraća 403:
{
"error": {
"message": "Insufficient permissions",
"type": "permission_error",
"code": 403
}
}
Tvoj prvi korak trebao bi biti provjera prava ključa u konzoli, umjesto sumnje u zahtjev čija sintaksa nema veze s odbijanjem.
Kvote i njihovi troškovi
Tri ograničenja upravljaju pohranom po računu: ukupno 100.000 datoteka, kumulativni kapacitet od 100 GB i 100 MB po pojedinačnoj datoteci u kolekcijama – što je više od dvostruko u odnosu na 48 MB dopuštenih samim Files API-jem, omogućujući ti uključivanje dokumenata koja nisi mogao poslati kao izravne privitke.
Što se tiče naplate, ističu se dvije stavke: Pretraživanje kolekcija naplaćuje se po 2,50 USD za 1.000 poziva pretraživanja, dok Privici datoteka koštaju 10 USD za 1.000 poziva. Razlika je značajna i utječe na arhitektonske izbore. Pod velikim opterećenjem, upit nad indeksiranom kolekcijom košta znatno manje od ponovnog attachinga istog dokumenta uz svako pitanje.
Ako tvoje potrebe premašuju ove kvote, xAI podrška može odobriti povećanje. Pripremi svoj zahtjev s brojкамa – ciljni broj datoteka, ukupni volumen, očekivana učestalost pretraživanja – umjesto s nejasnom procjenom. To ubrzava obradu zahtjeva.
Izoliraj, rotiraj, nadziri
Prva praksa tiče se ključeva. Dodijeli različite ključeve svakom okruženju kako skripta za razvoj nikada ne bi mogla dirati produkcijsku bazu. Nikada nemoj davati Management ključ servisu kojem je jedina potreba pretraživanje. Redovito rotiraj ove ključeve, posebno nakon što suradnik s pristupom tajnama napusti tvrtku.
Druga se tiče strukture. Umjesto jedne kolekcije gdje javna dokumentacija i ugovori koegzistiraju, razdvoji svoje baze prema razini povjerljivosti: „javna“ baza za otvorenu dokumentaciju, „interna“ baza za dokumente tvrtke i „povjerljiva“ baza za osjetljive podatke. Svaki servis tada prima samo pristup koji mu je potreban, a na pitanje „može li ovaj chatbot citirati ugovor?“ odgovoreno je već u dizajnu.
Treća je nadzor. Provjeri svoju potrošnju u xAI konzoli, postavi alert na bilo kakav neočekivani rast volumena pretraživanja – što je često prvi znak beskonačne petlje – i vodi pisani zapis o tome koji servisi pristupaju kojim kolekcijama.
Jedna datoteka, više kolekcija
Ova izolacija ne zahtijeva dupliciranje tvojih dokumenata jer ista datoteka može pripadati više kolekcija. Tehničko izvješće tako se pojavljuje u „product-documentation“ za tehnički tim, u „quarterly-reports“ za vodstvo i u „support-base“ za korisničku službu. Pohranjena je samo jednom, broji se samo jednom prema tvojim kvotama i ostaje pretraživa u sva tri konteksta – tematski pogledi po publici, bez divergentnih kopija.
Ključne točke
- Dva različita API ključa: standardni za korištenje, Management za administraciju
- Dozvola
AddFileToCollectionključna je za punjenje kolekcija - Ograničenja su 100.000 datoteka, 100 GB i 100 MB po datoteci
- Razdvoji svoje kolekcije prema razini povjerljivosti
- Datoteka može pripadati više kolekcija bez dupliciranja