Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Atļaujas un ierobežojumi kolekcijām

Nodarbība 8 no 16 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Zināšanu bāzu specifiskie riski
  2. Divas atslēgas, divas lomas
  3. Atļauja AddFileToCollection
  4. Kvotas un to izmaksas
  5. Izolē, rotē, uzraugi
  6. Viens fails, vairākas kolekcijas
  7. Galvenās atziņas

Zināšanu bāzu specifiskie riski

Uzņēmuma zināšanu bāze nekad nav triviāla lieta: tajā glabājas iekšējās piezīmes, konfidenciāli ziņojumi, līgumi, par kuriem vēl notiek sarunas. Ja piekļuves kontrole neizdodas, tu nenošļāc tikai vienu failu – tu atklāj visu bāzi, turklāt kopā ar meklētāju, kas palīdz atrast vissvarīgāko. xAI atļauju sistēma šo risku mazina, nodalot tiesības, savukārt kvotas regulē lietojumu un rēķinus.

Divas atslēgas, divas lomas

xAI ekosistēma izmanto divus akreditācijas datus dažādām darbības jomām:

AtslēgaLietojumsDarbības joma
XAI_API_KEYFailu augšupielāde un meklēšanaLasīšanas un lietojuma operācijas
XAI_MANAGEMENT_API_KEYKolekciju pārvaldībaAdministrācijas operācijas

Šī nodalīšana konkrēti īsteno vismazāko privilēģiju principu. Izstrādātājam, kurš pieslēdz atbalsta čatbotu tavai bāzei, ir jāspēj vaicāt kolekcijai, bet nekādā gadījumā to dzēst. Piešķirot tam tikai standarta atslēgu, skripta kļūda vai kompromitēta atslēga nevar iznīcināt indeksu, kas veidots mēnešiem.

Atļauja AddFileToCollection

Pēc noklusējuma Management API atslēga nav visvarena. Tās tiesības ir tieši definētas, un kolekcijām kritiskākā ir AddFileToCollection. Bez tās tu vari izveidot un uzskaitīt kolekcijas, bet nevari pievienot nevienu dokumentu – tas rada mulsinošu situāciju, jo šķiet, ka viss strādā, līdz sākas datu ielāde. Pareizas atslēgas ģenerēšana ietver četrus soļus:

  1. Pieraksties xAI konsolē
  2. Izveido jaunu Management API atslēgu
  3. Aktivizē atļauju AddFileToCollection
  4. Droši saglabā atslēgu: vides mainīgajā vai noslēpumu pārvaldniekā

Ja atļaujas trūkst, API sniedz skaidru atbildi un atgriež 403:

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

Tavam pirmajam solim jābūt atslēgas tiesību pārbaudei konsolē, nevis pieprasījuma apšaubīšanai, kura sintaksei ar noraidījumu nav nekāda sakara.

Kvotas un to izmaksas

Trīs griesti nosaka krātuvi katram kontam: kopā 100 000 failu, 100 GB kopējā ietilpība un 100 MB vienam failam kolekcijās – tas ir vairāk nekā divreiz vairāk nekā 48 MB, ko pieļauj tikai Files API, ļaujot iekļaut dokumentus, kurus nevarētu nosūtīt kā tiešus pielikumus.

Rēķinu pusē izceļas divas pozīcijas: Kolekciju meklēšana tiek tarifēta ar 2,50 USD par 1000 meklēšanas izsaukumiem, savukārt failu pielikumi maksā 10 USD par 1000 izsaukumiem. Atšķirība ir nozīmīga un ietekmē arhitektūras izvēles. Pie lielas slodzes vaicājumi indeksētai kolekcijai izmaksā ievērojami mazāk nekā tā paša dokumenta atkārtota pievienoš pie katra jautājuma.

Ja tavas vajadzības pārsniedz šīs kvotas, xAI atbalsts var piešķirt palielinājumu. Sagatavo savu pieprasījumu ar skaitļiem – mērķa failu skaits, kopējais apjoms, paredzamais meklēšanas biežums – nevis ar miglainām aplēsēm. Tas paātrina pieprasījuma apstrādi.

Izolē, rotē, uzraugi

Pirmā prakse attiecas uz atslēgām. Piešķir dažādas atslēgas katrai videi, lai izstrādes skripts nekad nevarētu aiztikt produkcijas bāzi. Nekad nedod Management atslēgu servisam, kam nepieciešama tikai meklēšana. Un regulāri rotē šīs atslēgas, it īpaši pēc tam, kad kāds līdzstrādnieks ar piekļuvi noslēpumiem ir aizgājis.

Otrā attiecas uz struktūru. Vienas kolekcijas vietā, kur līdzās pastāv publiska dokumentācija un līgumi, nodali savas bāzes pēc konfidencialitātes līmeņa: „publiska” bāze atklātai dokumentācijai, „iekšēja” bāze uzņēmuma dokumentiem un „konfidenciāla” bāze sensitīviem datiem. Katrs serviss tad saņem tikai tam nepieciešamo piekļuvi, un jautājums „vai šis čatbots var citēt līgumu?” tiek atrisināts jau projektēšanas stadijā.

Trešā ir uzraudzība. Pārbaudi savu patēriņu xAI konsolē, iestatī brīdinājumu par jebkuru negaidītu meklēšanas apjoma pieaugumu – bieži vien tā ir pirmā pazīme, ka kaut kas ir izgājis no kontroles – un uzturi rakstisku uzskaiti par to, kuri servisi piekļūst kurām kolekcijām.

Viens fails, vairākas kolekcijas

Šī izolācija neprasa dokumentu dublēšanu, jo viens un tas pats fails var piederēt vairākām kolekcijām. Tehniskais ziņojums tādējādi parādās „product-documentation” tehniskajai komandai, „quarterly-reports” vadībai un „support-base” klientu apkalpošanai. Tas tiek glabāts tikai vienreiz, tiek ieskaitīts kvotās tikai vienreiz un paliek meklējams visos trīs kontekstos – tematiski skati pēc auditorijas, bez atšķirīgām kopijām.

Galvenās atziņas

  • Divas atšķirīgas API atslēgas: standarta lietojumam, Management administrācijai
  • Atļauja AddFileToCollection ir būtiska, lai papildinātu kolekcijas
  • Ierobežojumi ir 100 000 failu, 100 GB un 100 MB vienam failam
  • Nodali savas kolekcijas pēc konfidencialitātes līmeņa
  • Fails var piederēt vairākām kolekcijām bez dublēšanas