Behörigheter och begränsningar för samlingar
På denna sida
Den specifika risken med kunskapsbaser
En företagsintern kunskapsbas är aldrig bagatellartad: interna anteckningar, konfidentiella rapporter och avtal under förhandling. Om åtkomstkontrollen brister läcker du inte bara en enskild fil – du exponerar hela basen, komplett med en sökmotor för att hitta det som är viktigt. xAI:s behörighetssystem minskar denna risk genom att separera rättigheter, medan kvoter styr användning och fakturering.
Två nycklar, två roller
xAI-ekosystemet förlitar sig på två autentiseringsuppgifter för distinkta omfång:
| Nyckel | Användning | Omfång |
|---|---|---|
XAI_API_KEY | Filuppladdning och sökning | Läs- och användningsoperationer |
XAI_MANAGEMENT_API_KEY | Hantering av samlingar | Administrativa operationer |
Denna separation tillämpar principen om minsta privilegium konkret. En utvecklare som kopplar en supportchatbot till din bas behöver fråga samlingen, aldrig radera den. Genom att bara ge dem standardnyckeln kan ett skriptfel eller en komprometterad nyckel inte förstöra ett index som byggts upp under månader.
Behörigheten AddFileToCollection
En Management API-nyckel är inte allsmäktig som standard. Dess rättigheter är explicita, och den viktigaste för samlingar är AddFileToCollection. Utan den kan du skapa och lista samlingar men inte lägga till ett enda dokument – en förvirrande situation där allt verkar fungera fram till själva inmatningen. Att generera en korrekt nyckel innebär fyra steg:
- Logga in på xAI-konsolen
- Skapa en ny Management API-nyckel
- Aktivera behörigheten
AddFileToCollection - Lagra nyckeln säkert: i en miljövariabel eller en hemlighetshanterare
När behörigheten saknas är API:t tydligt och returnerar en 403:
{
"error": {
"message": "Insufficient permissions",
"type": "permission_error",
"code": 403
}
}
Ditt första steg bör vara att kontrollera nyckelns rättigheter i konsolen snarare än att misstänka begäran, vars syntax inte har något med avvisningen att göra.
Kvoter och deras kostnader
Tre tak styr lagringen per konto: totalt 100 000 filer, 100 GB samlad kapacitet och 100 MB per enskild fil i samlingar – mer än dubbelt så mycket som de 48 MB som tillåts av Files API ensam, vilket låter dig inkludera dokument du inte kunde skicka som direkta bilagor.
På faktureringssidan sticker två poster ut: Sökning i samlingar debiteras med 2,50 USD per 1 000 sökanrop, medan filbilagor kostar 10 USD per 1 000 anrop. Skillnaden är betydande och väger tungt i arkitektoniska val. Vid hög belastning kostar det betydligt mindre att fråga en indexerad samling än att bifoga samma dokument vid varje fråga.
Om dina behov överskrider dessa kvoter kan xAI-supporten bevilja en ökning. Förbered din begäran med siffror – målat antal filer, total volym och förväntad sökfrekvens – snarare än en vag uppskattning. Detta påskyndar handläggningen av ärendet.
Isolera, rotera, övervaka
Den första praxisen gäller nycklar. Tilldela olika nycklar till varje miljö, så att ett utvecklingsskript aldrig kan röra produktionsbasen. Ge aldrig en Management-nyckel till en tjänst vars enda behov är sökning. Rotera dessutom dessa nycklar regelbundet, särskilt efter att en medarbetare med tillgång till hemligheter har slutat.
Den andra gäller strukturen. Istället för en enda samling där offentlig dokumentation och avtal samexisterar, bör du separera dina baser efter konfidentialitetsnivå: en “offentlig” bas för öppen dokumentation, en “intern” bas för företagsdokument och en “konfidentiell” bas för känslig data. Varje tjänst får då endast den åtkomst den behöver, och frågan “kan denna chatbot citera ett avtal?” besvaras redan i designen.
Den tredje är övervakning. Kontrollera din förbrukning i xAI-konsolen, ställ in en avisering vid oväntade ökningar av sökvolymer – ofta det första tecknet på en okontrollerad loop – och för en skriftlig förteckning över vilka tjänster som får åtkomst till vilka samlingar.
En fil, flera samlingar
Denna isolering kräver inte att du duplicerar dina dokument, eftersom samma fil kan tillhöra flera samlingar. En teknisk rapport kan således förekomma i “product-documentation” för det tekniska teamet, i “quarterly-reports” för ledningen och i “support-base” för kundtjänsten. Den lagras bara en gång, räknas bara en gång mot dina kvoter och förblir sökbar i alla tre kontexter – tematiska vyer per målgrupp utan divergerande kopior.
Viktiga punkter
- Två distinkta API-nycklar: standard för användning, Management för administration
- Behörigheten
AddFileToCollectionär avgörande för att fylla samlingar - Gränserna är 100 000 filer, 100 GB och 100 MB per fil
- Separera dina samlingar efter konfidentialitetsnivå
- En fil kan tillhöra flera samlingar utan duplicering