Berechtigungen und Limits für Sammlungen
Auf dieser Seite
Das spezifische Risiko von Wissensdatenbanken
Eine unternehmensinterne Wissensdatenbank ist niemals trivial: interne Notizen, vertrauliche Berichte, verhandelte Verträge. Wenn die Zugriffskontrollen versagen, geht es nicht nur um das Leaken einer einzelnen Datei – Sie exponieren die gesamte Datenbank, komplett mit einer Suchmaschine, die das Wesentliche findet. Das xAI-Berechtigungssystem mindert dieses Risiko, indem es Rechte trennt, während Quotas Nutzung und Abrechnung regeln.
Zwei Schlüssel, zwei Rollen
Das xAI-Ökosystem stützt sich auf zwei Credentials für unterschiedliche Bereiche:
| Schlüssel | Verwendung | Bereich |
|---|---|---|
XAI_API_KEY | Datei-Upload und Suche | Lese- und Nutzungsoperationen |
XAI_MANAGEMENT_API_KEY | Verwaltung von Sammlungen | Administrationsoperationen |
Diese Trennung wendet das Prinzip der geringsten Rechte konkret an. Ein Entwickler, der einen Support-Chatbot mit Ihrer Datenbank verbindet, muss die Sammlung abfragen, niemals löschen. Indem Sie ihm nur den Standard-Schlüssel geben, kann ein Skriptfehler oder ein kompromittierter Schlüssel einen Index, der über Monate aufgebaut wurde, nicht zerstören.
Die Berechtigung AddFileToCollection
Ein Management-API-Schlüssel ist nicht von Haus aus allmächtig. Seine Rechte sind explizit, und das wichtigste für Sammlungen ist AddFileToCollection. Ohne diese Berechtigung können Sie Sammlungen erstellen und auflisten, aber Sie können kein einzelnes Dokument hinzufügen – eine verwirrende Situation, da alles scheinbar funktioniert, bis die Ingestion beginnt. Die Generierung eines korrekten Schlüssels umfasst vier Schritte:
- Anmelden im xAI-Konsole
- Erstellen eines neuen Management-API-Schlüssels
- Aktivieren der Berechtigung
AddFileToCollection - Sicheren Aufbewahrung des Schlüssels: Umgebungsvariable oder Secrets Manager
Wenn die Berechtigung fehlt, ist die API explizit und gibt einen 403 zurück:
{
"error": {
"message": "Insufficient permissions",
"type": "permission_error",
"code": 403
}
}
Ihr erster Schritt sollte sein, die Rechte des Schlüssels in der Konsole zu prüfen, anstatt die Syntax des Requests zu bezweifeln, die nichts mit der Ablehnung zu tun hat.
Quotas und deren Kosten
Drei Obergrenzen regeln die Speicherung pro Konto: 100.000 Dateien insgesamt, 100 GB kumulative Kapazität und 100 MB pro einzelne Datei in Sammlungen – mehr als das Doppelte der 48 MB, die die Files API allein erlaubt, sodass Sie Dokumente einschließen können, die Sie nicht als direkte Anhänge senden könnten.
Auf der Abrechnungssseite fallen zwei Zeilen besonders auf: Die Suche in Sammlungen wird mit 2,50 USD pro 1.000 Suchaufrufen berechnet, während Datei-Anhänge 10 USD pro 1.000 Aufrufe kosten. Der Unterschied ist signifikant und wiegt auf architektonischen Entscheidungen. Unter hohem Nutzungsaufkommen kostet das Abfragen eines indizierten Sammlungsindex erheblich weniger als das erneute Anhängen desselben Dokuments bei jeder Frage.
Wenn Ihre Bedürfnisse diese Quotas überschreiten, kann der xAI-Support eine Erhöhung gewähren. Bereiten Sie Ihre Anfrage mit Zahlen vor – Ziel-Dateianzahl, Gesamtvolumen, erwartete Suchfrequenz – statt einer vagen Schätzung. Dies beschleunigt die Bearbeitung der Anfrage.
Isolieren, rotieren, überwachen
Die erste Praxis betrifft Schlüssel. Weisen Sie verschiedenen Umgebungen unterschiedliche Schlüssel zu, sodass ein Entwicklungsskript die Produktionsdatenbank niemals berühren kann. Geben Sie einem Management-Schlüssel niemals einem Service, dessen einziger Bedarf die Suche ist. Und rotieren Sie diese Schlüssel regelmäßig, insbesondere nachdem ein Mitarbeiter mit Zugriff auf Geheimnisse den Dienst verlassen hat.
Die zweite Praxis betrifft die Struktur. Statt einer einzigen Sammlung, in der öffentliche Dokumentation und Verträge koexistieren, trennen Sie Ihre Datenbanken nach Vertraulichkeitsstufen: eine „public”-Sammlung für offene Dokumentation, eine „internal”-Sammlung für Firmendokumente und eine „confidential”-Sammlung für sensible Daten. Jeder Service erhält dann nur den Zugriff, den er benötigt, und die Frage „kann dieser Chatbot einen Vertrag zitieren?” wird durch Design beantwortet.
Die dritte Praxis ist die Überwachung. Prüfen Sie Ihren Verbrauch in der xAI-Konsole, stellen Sie eine Warnung bei unerwarteten Anstiegen der Suchvolumina ein – oft das erste Anzeichen eines ausufernden Loops – und führen Sie ein schriftliches Protokoll darüber, welche Dienste auf welche Sammlungen zugreifen.
Eine Datei, mehrere Sammlungen
Diese Isolation erfordert nicht, dass Sie Ihre Dokumente duplizieren, da dieselbe Datei mehreren Sammlungen angehören kann. Ein technischer Bericht erscheint so in „product-documentation” für das technische Team, in „quarterly-reports” für das Management und in „support-base” für den Kundenservice. Er wird nur einmal gespeichert, zählt nur einmal zu Ihren Quotas und bleibt in allen drei Kontexten durchsuchbar – thematische Ansichten nach Zielgruppe, ohne divergierende Kopien.
Kernaussagen
- Zwei distincte API-Schlüssel: Standard für Nutzung, Management für Administration
- Die Berechtigung
AddFileToCollectionist unerlässlich, um Sammlungen zu befüllen - Limits betragen 100.000 Dateien, 100 GB und 100 MB pro Datei
- Trennen Sie Ihre Sammlungen nach Vertraulichkeitsstufen
- Eine Datei kann mehreren Sammlungen angehören, ohne dupliziert zu werden