Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Dozvole i ograničenja kolekcija

Lekcija 8 od 16 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Specifični rizik baza znanja
  2. Dva ključa, dvije uloge
  3. Dozvola AddFileToCollection
  4. Kvote i njihovi troškovi
  5. Izoliraj, rotiraj, nadziri
  6. Jedna datoteka, više kolekcija
  7. Ključne točke

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čUpotrebaOpseg
XAI_API_KEYPrijenos datoteka i pretraživanjeOperacije čitanja i korištenja
XAI_MANAGEMENT_API_KEYUpravljanje kolekcijamaAdministrativne 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:

  1. Prijavi se u xAI konzolu
  2. Stvori novi Management API ključ
  3. Omogući dozvolu AddFileToCollection
  4. 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 AddFileToCollection ključ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