Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Behörigheter och begränsningar för samlingar

Lektion 8 av 16 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Den specifika risken med kunskapsbaser
  2. Två nycklar, två roller
  3. Behörigheten AddFileToCollection
  4. Kvoter och deras kostnader
  5. Isolera, rotera, övervaka
  6. En fil, flera samlingar
  7. Viktiga punkter

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:

NyckelAnvändningOmfång
XAI_API_KEYFiluppladdning och sökningLäs- och användningsoperationer
XAI_MANAGEMENT_API_KEYHantering av samlingarAdministrativa 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:

  1. Logga in på xAI-konsolen
  2. Skapa en ny Management API-nyckel
  3. Aktivera behörigheten AddFileToCollection
  4. 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