Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Opret og administrer samlinger

Lektion 5 af 16 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Fra isolerede filer til en vidensbase
  2. En separat API, og hvorfor
  3. Opret din første samling
  4. De fem tilgængelige operationer
  5. Vigtige pointer

Fra isolerede filer til en vidensbase

Indtil nu har hvert dokument stået alene: du har uploadet det, refereret til det, og indekset bygget til lejligheden er forsvundet sammen med forespørgslen. Samlinger ændrer skalaen: de grupperer dine filer i strukturerede vidensbaser, der indekseres én gang og kan forespørges på ubestemt tid. Dette er fundamentet for RAG – Retrieval-Augmented Generation – med Grok, og forskellen viser sig, så snart et supportteam forespørger to hundrede produktblade i stedet for en enkelt PDF.

Tænk på en samling som en smart mappe. Du deponerer dokumenter, xAI indekserer dem til semantisk søgning, og Grok gennemsøger denne base for at svare præcist ved at trække de tre nyttige passager frem blandt tusindvis.

100k
Filer per konto
100 GB
Samlet kapacitet
CRUD
Fuld funktionalitet
$2.50
Per 1.000 søgninger

En separat API, og hvorfor

Du administrerer ikke samlinger via den API, du har brugt siden kursets start. De hører under Management API, som hostes på management-api.x.ai, med følgende base-URL:

https://management-api.x.ai/v1

Denne opdeling er ikke et arkitektonisk lune. Oprettelse, ændring eller sletning af en samling er administrative operationer med store konsekvenser, og xAI kræver derfor en dedikeret nøgle til dem: en Management API Key med tilladelsen AddFileToCollection. Fordelen er umiddelbar for teams: den tjeneste, der forespørger basen fra din offentlige applikation, modtager standardnøglen og kan ikke ødelægge noget; kun din ingestion-pipeline besidder administrationsnøglen.

Opret din første samling

Oprettelsen koges ned til et enkelt kald med et navn:

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"}'

Svaret returnerer det identifikator, du skal gemme:

{
  "collection_id": "col_xyz789",
  "collection_name": "technical-docs",
  "created_at": "2026-04-01T10:00:00Z"
}

Vælg dette navn omhyggeligt: det vil dukke op i alle dine lister, og om seks måneder vil det være det eneste spor, der lader dig skelne to nabobaser. technical-docs udfylder denne rolle; test2 gør ikke. Indfør en konvention fra den første samling, for det koster mere at omdøbe en base, der allerede refereres af tre applikationer, end at navngive den korrekt fra starten.

De fem tilgængelige operationer

Management API eksponerer et komplet CRUD-sæt for samlinger:

OperationMetodeEndpoint
OpretPOST/v1/collections
ListGET/v1/collections
DetaljerGET/v1/collections/{collection_id}
OpdaterPUT/v1/collections/{collection_id}
SletDELETE/v1/collections/{collection_id}

Listning af dine samlinger sker uden parametre og giver et nyttigt overblik før enhver vedligeholdelsesoperation:

curl https://management-api.x.ai/v1/collections \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"

Sletning følger samme logik ved at angive det identifikator, der blev opnået ved oprettelsen:

curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"

Én ting bør berolige dig, når du kører denne kommando: at slette en samling fjerner indekseringen, ikke filerne. Dine dokumenter forbliver tilgængelige via Files API og kan genindekseres andre steder. Du mister søgestrukturen, ikke råmaterialet – hvilket gør genopbygning af en dårligt organiseret base langt mindre risikabel, end det umiddelbart ser ud.

Vigtige pointer

  • Samlinger grupperer dine filer i indekserede vidensbaser til RAG
  • Administration foregår via Management API (management-api.x.ai), ikke standard-API’en
  • En Management API Key med tilladelsen AddFileToCollection er påkrævet
  • Grænserne er 100.000 filer og 100 GB per konto
  • De fem CRUD-operationer dækker oprettelse, læsning, opdatering og sletning