Erstellen und Verwalten von Sammlungen
Auf dieser Seite
Von isolierten Dateien zur Wissensbasis
Bisher stand jedes Dokument für sich: Sie haben es hochgeladen, darauf verwiesen, und der für den jeweiligen Suchvorgang erstellte Index verschwand mit der Abfrage. Sammlungen ändern das Maßstab: Sie gruppieren Ihre Dateien in strukturierte Wissensbasen, die einmal indiziert werden und unbegrenzt abfragbar sind. Dies ist das Fundament von RAG—Retrieval-Augmented Generation—mit Grok, und der Unterschied zeigt sich sofort, wenn ein Support-Team zweihundert Produktdatenblätter statt eines einzelnen PDFs abfragt.
Stellen Sie sich eine Sammlung als einen intelligenten Ordner vor. Sie legen Dokumente ab, xAI indiziert sie für die semantische Suche, und Grok durchsucht diese Basis, um präzise zu antworten, indem er unter Tausenden die drei nützlichen Passagen zieht.
Eine separate API und der Grund dafür
Sie verwalten Sammlungen nicht über die API, die Sie seit dem Beginn des Kurses verwendet haben. Diese fallen unter die Management API, die auf management-api.x.ai gehostet wird, mit der Basis-URL:
https://management-api.x.ai/v1
Diese Trennung ist kein architektonischer Zufall. Das Erstellen, Ändern oder Löschen einer Sammlung sind administrative Vorgänge mit schwerwiegenden Konsequenzen, und xAI erfordert dafür einen dedizierten Schlüssel: einen Management API-Schlüssel mit der Berechtigung AddFileToCollection. Der Vorteil ist für Teams sofort spürbar: Der Dienst, der die Basis aus Ihrer öffentlichen Anwendung abfragt, erhält den Standard-Schlüssel und kann nichts zerstören; nur Ihre Ingestion-Pipeline hält den Management-Schlüssel.
Erstellen Sie Ihre erste Sammlung
Die Erstellung reduziert sich auf einen einzigen Aufruf mit einem Namen:
curl -X POST https://management-api.x.ai/v1/collections \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"collection_name": "technical-docs"}'
Die Antwort gibt die Kennung zurück, die Sie behalten müssen:
{
"collection_id": "col_xyz789",
"collection_name": "technical-docs",
"created_at": "2026-04-01T10:00:00Z"
}
Wählen Sie diesen Namen sorgfältig: Er wird in allen Ihren Listen angezeigt und wird in sechs Monaten der einzige Hinweis, der es Ihnen ermöglicht, zwei benachbarte Basen zu unterscheiden. technical-docs erfüllt diese Rolle; test2 nicht. Adoptieren Sie ab der ersten Sammlung eine Konvention, denn das Umbenennen einer Basis, die bereits von drei Anwendungen referenziert wird, kostet mehr als sie von Anfang an gut zu benennen.
Die fünf verfügbaren Operationen
Die Management API stellt eine vollständige CRUD-Sammlung für Sammlungen bereit:
| Operation | Methode | Endpunkt |
|---|---|---|
| Erstellen | POST | /v1/collections |
| Auflisten | GET | /v1/collections |
| Details | GET | /v1/collections/{collection_id} |
| Aktualisieren | PUT | /v1/collections/{collection_id} |
| Löschen | DELETE | /v1/collections/{collection_id} |
Das Auflisten Ihrer Sammlungen erfolgt ohne Parameter und bietet einen nützlichen Überblick vor jeder Wartungsoperation:
curl https://management-api.x.ai/v1/collections \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Das Löschen folgt derselben Logik und benennt die Kennung an, die bei der Erstellung erhalten wurde:
curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Eines sollte Sie beruhigen, wenn Sie diesen Befehl ausführen: Das Löschen einer Sammlung entfernt die Indizierung, nicht die Dateien. Ihre Dokumente bleiben über die Files API zugänglich und können an anderer Stelle neu indiziert werden. Sie verlieren die Suchstruktur, nicht das Rohmaterial—was das Wiederaufbauen einer schlecht organisierten Basis weitaus weniger riskant macht, als es scheint.
Wichtige Erkenntnisse
- Sammlungen gruppieren Ihre Dateien in indizierte Wissensbasen für RAG
- Die Verwaltung erfolgt über die Management API (
management-api.x.ai) und nicht über die Standard-API - Ein Management API-Schlüssel mit der Berechtigung
AddFileToCollectionist erforderlich - Die Limits betragen 100.000 Dateien und 100 GB pro Konto
- Die fünf CRUD-Operationen umfassen Erstellen, Lesen, Aktualisieren und Löschen