Atļaujas un ierobežojumi kolekcijām
Šajā lapā
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ēga | Lietojums | Darbības joma |
|---|---|---|
XAI_API_KEY | Failu augšupielāde un meklēšana | Lasīšanas un lietojuma operācijas |
XAI_MANAGEMENT_API_KEY | Kolekciju pārvaldība | Administrā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:
- Pieraksties xAI konsolē
- Izveido jaunu Management API atslēgu
- Aktivizē atļauju
AddFileToCollection - 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
AddFileToCollectionir 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