Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Machtigingen en limieten voor collecties

Les 8 van 16 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Het specifieke risico van kennisbanken
  2. Twee sleutels, twee rollen
  3. De machtiging AddFileToCollection
  4. Quota’s en hun kosten
  5. Isoleren, roteren, monitoren
  6. Eén bestand, meerdere collecties
  7. Belangrijkste punten

Het specifieke risico van kennisbanken

Een zakelijke kennisbank is nooit triviaal: interne notities, vertrouwelijke rapporten, contracten in onderhandeling. Als de toegangscontroles falen, lekt u niet slechts één bestand; u stelt de volledige basis bloot, compleet met een zoekmachine om het relevante te vinden. Het machtigingssysteem van xAI beperkt dit risico door rechten te scheiden, terwijl quota’s het gebruik en de facturering regelen.

Twee sleutels, twee rollen

Het xAI-ecosysteem vertrouwt op twee inloggegevens voor verschillende reikwijdtes:

SleutelGebruikReikwijdte
XAI_API_KEYBestandsupload en zoekenLees- en gebruiksoperaties
XAI_MANAGEMENT_API_KEYCollectiebeheerAdministratieve operaties

Deze scheiding past het principe van de minste bevoegdheid concreet toe. Een ontwikkelaar die een supportchatbot op uw basis aansluit, moet de collectie kunnen bevragen, maar nooit verwijderen. Door hen alleen de standaardsleutel te geven, kan een scriptfout of een gecompromitteerde sleutel geen index vernietigen die over maanden is opgebouwd.

De machtiging AddFileToCollection

Een Management API-sleutel is niet standaard almachtig. De rechten zijn expliciet, en de meest kritieke voor collecties is AddFileToCollection. Zonder deze machtiging kunt u collecties aanmaken en oplijsten, maar geen enkel document toevoegen. Dit is een verwarrende situatie, omdat alles lijkt te werken tot aan de ingestie. Het genereren van een correcte sleutel omvat vier stappen:

  1. Log in op de xAI-console
  2. Maak een nieuwe Management API-sleutel aan
  3. Schakel de machtiging AddFileToCollection in
  4. Bewaar de sleutel veilig: als omgevingsvariabele of in een secrets manager

Wanneer de machtiging ontbreekt, is de API expliciet en retourneert deze een 403:

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

Uw eerste stap moet zijn om de rechten van de sleutel in de console te controleren, in plaats van het verzoek te wantrouwen, waarvan de syntaxis niets te maken heeft met de weigering.

Quota’s en hun kosten

Drie plafonds regelen de opslag per account: in totaal 100.000 bestanden, 100 GB aan cumulatieve capaciteit en 100 MB per individueel bestand in collecties. Dit is meer dan het dubbele van de 48 MB die alleen door de Files-API wordt toegestaan, waardoor u documenten kunt opnemen die u niet als directe bijlagen kon verzenden.

Aan de kant van de facturering springen twee posten in het oog: Collections Search wordt gefactureerd tegen $2,50 per 1.000 zoekopdrachten, terwijl File Attachments $10 per 1.000 oproepen kosten. Het verschil is aanzienlijk en weegt zwaar op architecturale keuzes. Bij intensief gebruik kost het bevragen van een geïndexeerde collectie aanzienlijk minder dan het bij elke vraag opnieuw bijvoegen van hetzelfde document.

Als uw behoeften deze quota’s overschrijden, kan de ondersteuning van xAI een verhoging toestaan. Bereid uw verzoek voor met cijfers—doelaantal bestanden, totaalvolume, verwachte zoekfrequentie—in plaats van met een vage schatting. Dit versnelt de verwerking van het verzoek.

Isoleren, roteren, monitoren

De eerste praktijk betreft sleutels. Wijs verschillende sleutels toe aan elke omgeving, zodat een ontwikkelingsscript nooit de productiebasis kan aanraken. Geef nooit een Management-sleutel aan een service waarvan de enige behoefte zoeken is. En roteer deze sleutels regelmatig, vooral nadat een medewerker met toegang tot geheimen vertrekt.

De tweede betreft de structuur. In plaats van één enkele collectie waarin openbare documentatie en contracten naast elkaar bestaan, scheidt u uw bases op vertrouwelijkheidsniveau: een “openbare” base voor open documentatie, een “interne” base voor bedrijfsdocumenten en een “vertrouwelijke” base voor gevoelige gegevens. Elke service ontvangt dan alleen de toegang die nodig is, en de vraag “kan deze chatbot een contract citeren?” wordt door het ontwerp beantwoord.

De derde is monitoring. Controleer uw verbruik in de xAI-console, stel een alert in bij elke onverwachte stijging van het zoekvolume—vaak het eerste teken van een vastgelopen lus—en houd schriftelijk bij welke services welke collecties openen.

Eén bestand, meerdere collecties

Deze isolatie vereist geen duplicatie van uw documenten, aangezien hetzelfde bestand tot meerdere collecties kan behoren. Een technisch rapport verschijnt zo in “product-documentatie” voor het technische team, in “kwartaalrapporten” voor het management en in “support-base” voor de klantenservice. Het wordt slechts één keer opgeslagen, telt slechts één keer mee voor uw quota’s en blijft doorzoekbaar in alle drie de contexten—thematische weergaven per doelgroep, zonder afwijkende kopieën.

Belangrijkste punten

  • Twee verschillende API-sleutels: standaard voor gebruik, Management voor administratie
  • De machtiging AddFileToCollection is essentieel om collecties te vullen
  • Limieten zijn 100.000 bestanden, 100 GB en 100 MB per bestand
  • Scheid uw collecties op vertrouwelijkheidsniveau
  • Een bestand kan tot meerdere collecties behoren zonder duplicatie