Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Erstellen und Verwalten von Sammlungen

Lektion 5 von 16 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Von isolierten Dateien zur Wissensbasis
  2. Eine separate API und der Grund dafür
  3. Erstellen Sie Ihre erste Sammlung
  4. Die fünf verfügbaren Operationen
  5. Wichtige Erkenntnisse

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.

100k
Dateien pro Konto
100 GB
Gesamtkapazität
CRUD
Vollständige Operationen
$2,50
Pro 1.000 Suchen

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:

OperationMethodeEndpunkt
ErstellenPOST/v1/collections
AuflistenGET/v1/collections
DetailsGET/v1/collections/{collection_id}
AktualisierenPUT/v1/collections/{collection_id}
LöschenDELETE/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 AddFileToCollection ist erforderlich
  • Die Limits betragen 100.000 Dateien und 100 GB pro Konto
  • Die fünf CRUD-Operationen umfassen Erstellen, Lesen, Aktualisieren und Löschen