Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Izveidot un pārvaldīt kolekcijas

Nodarbība 5 no 16 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. No atsevišķiem failiem uz zināšanu bāzi
  2. Atsevišķa API un tās nozīme
  3. Izveido savu pirmo kolekciju
  4. Piecas pieejamās operācijas
  5. Galvenās atziņas

No atsevišķiem failiem uz zināšanu bāzi

Līdz šim katrs dokuments pastāvēja atsevišķi: tu to augšupielādēji, atsauces uz to izmantoji, un šim nolūkam izveidotais indekss pazuda līdz ar vaicājumu. Kolekcijas maina mērogu: tās apvieno tavus failus strukturētās zināšanu bāzēs, kas tiek indeksētas vienreiz un ir pieejamas vaicājumiem beztermiņa. Tas ir RAG (Retrieval-Augmented Generation) pamats, izmantojot Grok, un atšķirība kļūst acīmredzama brīdī, kad atbalsta komanda vaicā divsimt produktu lapas, nevis vienu PDF failu.

Uztver kolekciju kā viedu mapi. Tu ievieto tajā dokumentus, xAI tos indeksē semantiskai meklēšanai, un Grok meklē šajā bāzē, lai sniegtu precīzas atbildes, izvelkot trīs noderīgus fragmentus no tūkstošiem.

100k
Faili vienā kontā
100 GB
Kopējā ietilpība
CRUD
Pilnas operācijas
$2.50
Par 1000 meklēšanām

Atsevišķa API un tās nozīme

Tu nepārvaldi kolekcijas, izmantojot API, ko esi lietojis kopš kursa sākuma. Tās ietilpst pārvaldības API (Management API), kas mitināta domēnā management-api.x.ai, ar bāzes URL:

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

Šī nodalīšana nav arhitektūras kaprīze. Kolekcijas izveide, modificēšana vai dzēšana ir administratīvas operācijas ar smagām sekām, tāpēc xAI tām pieprasa atsevišķu atslēgu: pārvaldības API atslēgu (Management API Key) ar tiesībām AddFileToCollection. Komandām tas dod tūlītēju labumu: serviss, kas vaicā bāzi no tavas publiskās lietotnes, saņem standarta atslēgu un neko nevar iznīcināt; tikai tavā datu ievades procesā (ingestion pipeline) glabājas pārvaldības atslēga.

Izveido savu pirmo kolekciju

Izveide reducējas uz vienu izsaukumu ar nosaukumu:

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

Atbilde atgriež saglabājamo identifikatoru:

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

Izvēlies šo nosaukumu rūpīgi: tas parādīsies visos tavos sarakstos, un pēc sešiem mēnešiem tas būs vienīgā norāde, kas ļaus atšķirt divas blakus esošas bāzes. technical-docs šo lomu pilda; test2 to nedarīs. Piekop konvenciju jau no pirmās kolekcijas, jo bāzes pārdēvēšana, uz kuru jau atsaucas trīs lietotnes, izmaksā dārgāk nekā tās pareiza nosaukšana pašā sākumā.

Piecas pieejamās operācijas

Pārvaldības API nodrošina pilnu CRUD kopu kolekcijām:

OperācijaMetodeGalapunkts
IzveidotPOST/v1/collections
SarakstsGET/v1/collections
DetaļasGET/v1/collections/{collection_id}
AtjauninātPUT/v1/collections/{collection_id}
DzēstDELETE/v1/collections/{collection_id}

Kolekciju saraksta iegūšana notiek bez parametriem un sniedz noderīgu pārskatu pirms jebkuras uzturēšanas operācijas:

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

Dzēšana seko tai pašai loģikai, norādot izveides brīdī iegūto identifikatoru:

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

Viena lieta tevi nomierinās, palaižot šo komandu: kolekcijas dzēšana noņem indeksāciju, nevis failus. Tavi dokumenti paliek pieejami, izmantojot Failu API, un tos var atkārtoti indeksēt citur. Tu zaudē meklēšanas struktūru, nevis izejvielu, kas padara slikti organizētas bāzes atjaunošanu daudz mazāk riskantu, nekā tas šķiet.

Galvenās atziņas

  • Kolekcijas apvieno tavus failus indeksētās zināšanu bāzēs priekš RAG
  • Pārvaldība notiek caur Pārvaldības API (management-api.x.ai), nevis standarta API
  • Nepieciešama Pārvaldības API atslēga ar tiesībām AddFileToCollection
  • Limiti ir 100 000 failu un 100 GB vienam kontam
  • Piecas CRUD operācijas aptver izveidi, lasīšanu, atjaunināšanu un dzēšanu