Collecties maken en beheren
Op deze pagina
Van geïsoleerde bestanden naar een kennisbank
Tot nu toe stond elk document op zichzelf: u uploadde het, verwees ernaar, en de index die voor de gelegenheid werd opgebouwd, verdween samen met de query. Collecties veranderen de schaal: ze groeperen uw bestanden in gestructureerde kennisbanken, die eenmalig worden geïndexeerd en onbeperkt doorzoekbaar zijn. Dit is de basis van RAG (Retrieval-Augmented Generation) met Grok, en het verschil wordt direct zichtbaar zodra een supportteam tweehonderd productfiches doorzoekt in plaats van één enkele PDF.
Beschouw een collectie als een slimme map. U plaatst er documenten in, xAI indexeert ze voor semantisch zoeken, en Grok doorzoekt deze basis om nauwkeurig te antwoorden door de drie meest relevante fragmenten uit duizenden te halen.
Een aparte API, en waarom
U beheert collecties niet via de API die u sinds het begin van de cursus hebt gebruikt. Ze vallen onder de Management API, gehost op management-api.x.ai, met als basis-URL:
https://management-api.x.ai/v1
Deze scheiding is geen architectonische gril. Het aanmaken, wijzigen of verwijderen van een collectie zijn administratieve handelingen met ingrijpende gevolgen, en xAI vereist daarvoor een specifieke sleutel: een Management API Key met de machtiging AddFileToCollection. Het voordeel voor teams is direct: de service die de basis vanuit uw publieke applicatie bevraagt, ontvangt de standaardsleutel en kan niets vernietigen; alleen uw ingestiepijplijn beschikt over de beheersleutel.
Uw eerste collectie maken
Het aanmaken komt neer op één enkele aanroep met een naam:
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"}'
Het antwoord retourneert de identifier die u moet bewaren:
{
"collection_id": "col_xyz789",
"collection_name": "technical-docs",
"created_at": "2026-04-01T10:00:00Z"
}
Kies deze naam zorgvuldig: deze verschijnt in al uw lijsten en is over zes maanden de enige aanwijzing om twee naast elkaar staande bases van elkaar te onderscheiden. technical-docs vervult deze rol; test2 niet. Voer vanaf de eerste collectie een conventie in, want het hernoemen van een basis waarnaar al drie applicaties verwijzen, kost meer dan deze vanaf het begin goed benoemen.
De vijf beschikbare bewerkingen
De Management API biedt een volledige CRUD-set voor collecties:
| Bewerking | Methode | Endpoint |
|---|---|---|
| Aanmaken | POST | /v1/collections |
| Lijst ophalen | GET | /v1/collections |
| Details | GET | /v1/collections/{collection_id} |
| Bijwerken | PUT | /v1/collections/{collection_id} |
| Verwijderen | DELETE | /v1/collections/{collection_id} |
Het opvragen van uw collectielijst gebeurt zonder parameters en geeft een nuttig overzicht voorafgaand aan elke onderhoudsbewerking:
curl https://management-api.x.ai/v1/collections \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Verwijderen volgt dezelfde logica, waarbij de bij het aanmaken verkregen identifier wordt aangeduid:
curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Eén ding moet u geruststellen wanneer u dit commando uitvoert: het verwijderen van een collectie verwijdert de indexering, niet de bestanden. Uw documenten blijven toegankelijk via de Files API en kunnen elders opnieuw worden geïndexeerd. U verliest de zoekstructuur, niet de grondstof—waardoor het herbouwen van een slecht georganiseerde basis veel minder riskant is dan het lijkt.
Belangrijkste punten
- Collecties groeperen uw bestanden in geïndexeerde kennisbanken voor RAG
- Beheer verloopt via de Management API (
management-api.x.ai), niet de standaard-API - Een Management API Key met de machtiging
AddFileToCollectionis vereist - De limieten zijn 100.000 bestanden en 100 GB per account
- De vijf CRUD-bewerkingen dekken aanmaken, lezen, bijwerken en verwijderen