Creer et gerer des collections
Des fichiers isoles a une base de connaissances
La Files API vous permet d’uploader des fichiers individuels. Les Collections vont plus loin : elles regroupent vos fichiers en bases de connaissances structurees, indexees et interrogeables. C’est le fondement du RAG (Retrieval-Augmented Generation) avec Grok.
Une collection fonctionne comme un dossier intelligent. Vous y ajoutez des documents, xAI les indexe automatiquement pour la recherche semantique, et Grok peut ensuite fouiller dans cette base pour repondre a vos questions avec precision.
La Management API
Les collections sont gerees via une API separee : la Management API, hebergee sur management-api.x.ai. Cette separation est intentionnelle : les operations de gestion (creation, modification, suppression de collections) necessitent une cle dediee avec des permissions specifiques.
L’URL de base pour toutes les operations de collection est :
https://management-api.x.ai/v1Vous aurez besoin d’une Management API Key avec la permission AddFileToCollection.
Creer une collection
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": "documentation-technique"}'La reponse contient l’identifiant de la collection :
{
"collection_id": "col_xyz789",
"collection_name": "documentation-technique",
"created_at": "2026-04-01T10:00:00Z"
}Choisissez un nom descriptif : vous le verrez dans toutes vos listes et il vous aidera a identifier rapidement la collection concernee.
Operations CRUD
La Management API expose cinq operations sur les collections :
| Operation | Methode | Endpoint |
|---|---|---|
| Creer | POST | /v1/collections |
| Lister | GET | /v1/collections |
| Details | GET | /v1/collections/{collection_id} |
| Modifier | PUT | /v1/collections/{collection_id} |
| Supprimer | DELETE | /v1/collections/{collection_id} |
Lister les collections
curl https://management-api.x.ai/v1/collections \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"Supprimer une collection
curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"La suppression d’une collection retire l’indexation mais ne supprime pas les fichiers sous-jacents. Ceux-ci restent accessibles via la Files API.
Points cles a retenir
- Les collections regroupent vos fichiers en bases de connaissances indexees pour le RAG
- La gestion passe par la Management API (
management-api.x.ai), pas l’API standard - Une Management API Key avec permission
AddFileToCollectionest requise - Les limites sont de 100 000 fichiers et 100 GB par compte
- Les cinq operations CRUD couvrent la creation, la lecture, la modification et la suppression