Tilladelser og grænser for samlinger
På denne side
Den specifikke risiko ved vidensbaser
En virksomheds vidensbase er aldrig bagatel: interne noter, fortrolige rapporter, kontrakter under forhandling. Hvis adgangskontrollen svigter, lækker du ikke blot én enkelt fil – du blotters hele basen, komplet med en søgemaskine til at finde det væsentlige. xAIs tilladelsessystem mindsker denne risiko ved at adskille rettigheder, mens kvoter styrer brug og fakturering.
To nøgler, to roller
xAI-økosystemet bruger to legimitationsoplysninger til forskellige områder:
| Nøgle | Anvendelse | Omfang |
|---|---|---|
XAI_API_KEY | Filupload og søgning | Læse- og brugsoperationer |
XAI_MANAGEMENT_API_KEY | Samlingsstyring | Administrative operationer |
Denne adskillelse anvender princippet om mindst privilegium konkret. En udvikler, der forbinder en support-chatbot til din base, skal kunne forespørge samlingen, aldrig slette den. Ved kun at give dem standardnøglen, kan en scriptfejl eller en kompromitteret nøgle ikke ødelægge et indeks, der er opbygget over måneder.
Tilladelsen AddFileToCollection
En Management API-nøgle er ikke som standard almægtig. Dens rettigheder er eksplicitte, og den mest kritiske for samlinger er AddFileToCollection. Uden den kan du oprette og liste samlinger, men ikke tilføje ét eneste dokument – en forvirrende situation, da alt ser ud til at virke indtil indlæsningen. Generering af en korrekt nøgle indebærer fire trin:
- Log ind på xAI-konsollen
- Opret en ny Management API-nøgle
- Aktiver tilladelsen
AddFileToCollection - Gem nøglen sikkert: som miljøvariabel eller i en hemmelighedsadministrator
Når tilladelsen mangler, er API’en eksplicit og returnerer en 403-fejl:
{
"error": {
"message": "Insufficient permissions",
"type": "permission_error",
"code": 403
}
}
Dit første skridt bør være at tjekke nøglens rettigheder i konsollen frem for at mistænke forespørgslen, hvis syntaks intet har med afvisningen at gøre.
Kvoter og deres omkostninger
Tre lofter styrer lagringen pr. konto: 100.000 filer i alt, 100 GB samlet kapacitet og 100 MB pr. individuel fil i samlinger – mere end det dobbelte af de 48 MB, som Files API alene tillader, så du kan inkludere dokumenter, du ikke kunne sende som direkte vedhæftninger.
På faktureringssiden skiller to poster sig ud: Collections Search faktureres til $2,50 pr. 1.000 søgeopkald, mens File Attachments koster $10 pr. 1.000 opkald. Forskellen er betydelig og vejer tungt i arkitektoniske valg. Ved høj belastning koster det væsentligt mindre at forespørge et indekseret samling end at genvedhæfte det samme dokument ved hvert spørgsmål.
Hvis dine behov overstiger disse kvoter, kan xAI-supporten give en forhøjelse. Forbered din anmodning med tal – målt antal filer, samlet volumen, forventet søgefrekvens – frem for et vagt estimat. Det fremskynder behandlingen af anmodningen.
Isolér, rotér, overvåg
Den første praksis vedrører nøgler. Tildel forskellige nøgler til hvert miljø, så et udviklingsscript aldrig kan røre produktionsbasen. Giv aldrig en Management-nøgle til en tjeneste, hvis eneste behov er søgning. Og rotér disse nøgler regelmæssigt, især efter en medarbejder med adgang til hemmeligheder forlader virksomheden.
Den anden vedrører struktur. I stedet for én enkelt samling, hvor offentlig dokumentation og kontrakter sameksisterer, bør du adskille dine baser efter fortrolighedsniveau: en „offentlig” base for åben dokumentation, en „intern” base for virksomhedsdokumenter og en „fortrolig” base for følsomme data. Hver tjeneste modtager derefter kun den adgang, den har brug for, og spørgsmålet „kan denne chatbot citere en kontrakt?” besvares allerede ved designet.
Den tredje er overvågning. Tjek dit forbrug i xAI-konsollen, opsæt en alarm ved enhver uventet stigning i søgevolumen – ofte det første tegn på en løbsk løkke – og før en skriftlig oversigt over, hvilke tjenester der får adgang til hvilke samlinger.
Én fil, flere samlinger
Denne isolering kræver ikke, at du duplicerer dine dokumenter, da den samme fil kan tilhøre flere samlinger. En teknisk rapport kan således optræde i „product-documentation” til det tekniske team, i „quarterly-reports” til ledelsen og i „support-base” til kundeservice. Den gemmes kun én gang, tæller kun én gang mod dine kvoter og forbliver søgbar i alle tre sammenhænge – tematiske visninger efter målgruppe uden divergerende kopier.
Vigtige pointer
- To forskellige API-nøgler: standard til brug, Management til administration
- Tilladelsen
AddFileToCollectioner essentiel for at befolke samlinger - Grænserne er 100.000 filer, 100 GB og 100 MB pr. fil
- Adskil dine samlinger efter fortrolighedsniveau
- En fil kan tilhøre flere samlinger uden duplikering