Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Skapa och hantera samlingar

Lektion 5 av 16 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Från isolerade filer till en kunskapsbas
  2. Ett separat API, och varför
  3. Skapa din första samling
  4. De fem tillgängliga operationerna
  5. Viktiga punkter

Från isolerade filer till en kunskapsbas

Hittills har varje dokument stått ensamt: du har laddat upp det, refererat till det, och indexet som byggdes för tillfället försvann tillsammans med frågan. Samlingar ändrar skalan: de grupperar dina filer i strukturerade kunskapsbaser, indexerade en gång och sökbara på obestämd tid. Detta är grunden för RAG (Retrieval-Augmented Generation) med Grok, och skillnaden visar sig så fort ett supportteam söker i tvåhundra produktblad istället för en enda PDF.

Tänk på en samling som en smart mapp. Du lägger in dokument, xAI indexerar dem för semantisk sökning, och Grok söker i denna bas för att svara med precision genom att plocka ut de tre mest relevanta passagerna bland tusentals.

100k
Filer per konto
100 GB
Total kapacitet
CRUD
Fullständiga operationer
$2.50
Per 1 000 sökningar

Ett separat API, och varför

Du hanterar inte samlingar via det API du har använt sedan kursens början. De faller under Management API, som hostas på management-api.x.ai, med bas-URL:en:

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

Denna uppdelning är ingen arkitektonisk nyck. Att skapa, modifiera eller ta bort en samling är administrativa operationer med stora konsekvenser, och xAI kräver en dedikerad nyckel för dessa: en Management API Key med behörigheten AddFileToCollection. Fördelen är omedelbar för team: tjänsten som frågar basen från din publika applikation får standardnyckeln och kan inte förstöra något; endast din ingestions-pipeline innehar hanteringsnyckeln.

Skapa din första samling

Skapandet kokar ner till ett enda anrop med ett namn:

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 returnerar identifieraren du måste spara:

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

Välj detta namn noggrant: det kommer att dyka upp i alla dina listor och om sex månader vara den enda ledtråden som låter dig skilja två närliggande baser åt. technical-docs fyller denna roll; test2 gör det inte. Anta en konvention från den första samlingen, eftersom det kostar mer att byta namn på en bas som redan refereras av tre applikationer än att namnge den rätt från början.

De fem tillgängliga operationerna

Management API exponerar en fullständig CRUD-uppsättning för samlingar:

OperationMetodSlutpunkt
SkapaPOST/v1/collections
ListaGET/v1/collections
DetaljerGET/v1/collections/{collection_id}
UppdateraPUT/v1/collections/{collection_id}
Ta bortDELETE/v1/collections/{collection_id}

Att lista dina samlingar sker utan parametrar och ger en användbar överblick innan underhållsoperationer:

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

Borttagning följer samma logik genom att ange identifieraren som erhölls vid skapandet:

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

En sak bör lugna dig när du kör detta kommando: att ta bort en samling tar bort indexeringen, inte filerna. Dina dokument förblir tillgängliga via Files API och kan indexeras om någon annanstans. Du förlorar sökstrukturen, inte råmaterialet – vilket gör att återuppbyggnad av en dåligt organiserad bas är betydligt mindre riskabelt än det verkar.

Viktiga punkter

  • Samlingar grupperar dina filer i indexerade kunskapsbaser för RAG
  • Hantering sker via Management API (management-api.x.ai), inte standard-API:t
  • En Management API Key med behörigheten AddFileToCollection krävs
  • Gränserna är 100 000 filer och 100 GB per konto
  • De fem CRUD-operationerna täcker skapande, läsning, uppdatering och borttagning