Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Gyűjtemények létrehozása és kezelése

5. lecke 16 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Elszigetelt fájloktól a tudásbázisig
  2. Egy külön API, és miért
  3. Hozd létre az első gyűjteményedet
  4. Az öt elérhető művelet
  5. Főbb megállapítások

Elszigetelt fájloktól a tudásbázisig

Eddig minden dokumentum önmagában állt: feltöltötted, hivatkoztál rá, és az alkalomra épített index a lekérdezéssel együtt eltűnt. A gyűjtemények megváltoztatják a léptéket: strukturált tudásbázisokba rendezik a fájljaidat, amelyeket egyszer indexelnek, és korlátlan ideig lekérdezhetők. Ez a RAG (Retrieval-Augmented Generation – Lekérdezés-bővített generálás) alapja a Grok segítségével, és a különbség azonnal megmutatkozik, amikor egy ügyfélszolgálati csapat kétszáz terméklapot kérdez le egyetlen PDF helyett.

Tekints a gyűjteményre úgy, mint egy intelligens mappára. Dokumentumokat helyezel el benne, az xAI szemantikai keresésre indexeli őket, a Grok pedig ezt az adatbázist keresi át, hogy precíz válaszokat adjon, kiszűrve a három hasznos részletet ezrek közül.

100k
Fájl fiókonként
100 GB
Teljes kapacitás
CRUD
Teljes műveletek
$2.50
1000 keresésenként

Egy külön API, és miért

A gyűjteményeket nem azzal az API-val kezeled, amelyet a tanfolyam kezdete óta használtál. Ezek a Management API hatáskörébe tartoznak, amely a management-api.x.ai címen érhető el, a következő alap URL-lel:

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

Ez a szétválasztás nem építészeti szeszély. A gyűjtemények létrehozása, módosítása vagy törlése súlyos következményekkel járó adminisztratív műveletek, és az xAI ezekhez külön kulcsot igényel: egy Management API Key-t, amely rendelkezik az AddFileToCollection engedéllyel. A csapatok számára az előny azonnali: a nyilvános alkalmazásodból az adatbázist lekérdező szolgáltatás a szabványos kulcsot kapja meg, és nem tud semmit sem megsemmisíteni; csak a betáplálási folyamataid (ingestion pipeline) birtokolják a kezelési kulcsot.

Hozd létre az első gyűjteményedet

A létrehozás egyetlen, nevet tartalmazó hívásra redukálódik:

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

A válasz visszaadja a megőrizendő azonosítót:

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

Válaszd meg gondosan ezt a nevet: minden listádban megjelenik majd, és hat hónap múlva ez lesz az egyetlen támpont, amely alapján megkülönböztetsz két szomszédos adatbázist. A technical-docs megfelel ennek a szerepnek; a test2 nem. Fogadj el egy konvenciót már az első gyűjteménytől kezdve, mert egy már három alkalmazás által hivatkozott adatbázis átnevezése többe kerül, mint ha eleve jól nevezed el.

Az öt elérhető művelet

A Management API teljes CRUD készletet tesz közzé a gyűjteményeken:

MűveletMetódusVégpont
LétrehozásPOST/v1/collections
ListázásGET/v1/collections
RészletekGET/v1/collections/{collection_id}
FrissítésPUT/v1/collections/{collection_id}
TörlésDELETE/v1/collections/{collection_id}

A gyűjtemények listázása paraméterek nélkül történik, és hasznos áttekintést nyújt bármilyen karbantartási művelet előtt:

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

A törlés ugyanerre a logikára épül, a létrehozáskor kapott azonosító megadásával:

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

Egy dolognak nyugalmat kell adnia, amikor futtatod ezt a parancsot: egy gyűjtemény törlése az indexelést távolítja el, nem pedig a fájlokat. A dokumentumaid továbbra is elérhetők maradnak a Files API-n keresztül, és máshol is újraindexelhetők. A keresési struktúrát veszíted el, nem a nyersanyagot – ami miatt egy rosszul szervezett adatbázis újjáépítése sokkal kevésbé kockázatos, mint elsőre tűnik.

Főbb megállapítások

  • A gyűjtemények indexelt tudásbázisokba rendezik a fájljaidat a RAG számára
  • A kezelés a Management API-n (management-api.x.ai) keresztül történik, nem a szabványos API-n
  • AddFileToCollection engedéllyel rendelkező Management API Key szükséges
  • A korlátok fiókonként 100 000 fájl és 100 GB
  • Az öt CRUD művelet lefedi a létrehozást, olvasást, frissítést és törlést