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

Darba plūsma četros soļos

Nodarbība 2 no 12 Atjaunota 2026. gada 2. novembris Programmētājs
Šajā lapā
  1. Partijas dzīves cikls
  2. 1. solis: Partijas izveide
  3. 2. solis: Pieprasījumu pievienošana
  4. 3. solis: Progresa uzraudzība
  5. 4. solis: Rezultātu iegūšana
  6. Darba plūsma praksē
  7. Kļūdu apstrāde darba plūsmā
  8. Galvenās atziņas

Atjaunināts 2026. gada 2. novembrī, pamatojoties uz xAI dokumentāciju: atlaide par partijas apstrādi ir 20 % atbilstošajiem teksta modeļiem (nevis 50 %); piemēros izmantota REST API un oficiālais xai-sdk (client.batch.*; xAI partijas API neatbilst OpenAI formātam, tāpēc OpenAI SDK nav piemērojams); Responses API ir prioritāra pār Chat Completions, kas xAI vidē ir novecojis galapunkts. Avoti: Batch API · REST atsauce · Partijas cenu noteikšana.

Partijas dzīves cikls

Katra partija iziet vienu un to pašu ciklu: izveide, pieprasījumu pievienošana, apstrāde, rezultātu iegūšana. Pirms pāriet pie ieviešanas, ir būtiski saprast šo ciklu, jo katram solim ir savi ierobežojumi un labākā prakse.

1. solis: Partijas izveide

Viss sākas ar POST /v1/batches izsaukumu, kurā ir viens obligāts lauks: partijas nosaukums. API atgriež unikālu identifikatoru (batch_id), ko izmanto visām turpmākajām operācijām.

curl -X POST https://api.x.ai/v1/batches \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "customer_review_analysis"}'

Atbilde satur arī partijas izveides un derīguma termiņa beigu datumus (create_time, expire_time) un state objektu, kura skaitītāji vēl ir nulles vērtībā.

2. solis: Pieprasījumu pievienošana

Ir divas metodes:

Caur API: nosūti pieprasījumus, izmantojot POST /v1/batches/{batch_id}/requests. Katrs izsaukums satur pieprasījumu sarakstu, un tos vari pievienot tik ilgi, kamēr partija nav atcelta. Šis ir ceļš partijām, kas tiek veidotas pakāpeniski.

Caur JSONL failu: sagatavo failu, kas satur visus tavus pieprasījumus, augšupielādē to, izmantojot Files API, un pēc tam izveido partiju no šī faila. Tad partija tiek noslēgta: vairs nav iespējams neko pievienot. Šis ir ceļš lieliem apjomiem, kas sagatavoti iepriekš.

Katrs pieprasījums satur unikālu identifikatoru partijas ietvaros: batch_request_id API gadījumā vai custom_id JSONL failā. Ja API izsaukumā to izlaidīsi, xAI ģenerēs UUID; tā vietā norādi savu (piemēram, datubāzes ID): tas kalpo kā atslēga, lai saskaņotu tavus datus ar rezultātiem, un garantē, ka pieprasījums tiek apstrādāts tikai vienreiz.

3. solis: Progresa uzraudzība

Apstrāde sākas tiklīdz ierodas pieprasījumi; atsevišķs “sākšanas” solis nav nepieciešams. Tikmēr GET /v1/batches/{batch_id} atgriež state objektu un tā skaitītājus: num_requests (kopā), num_pending (gaida), num_success (veiksmīgi), num_error (neizdevās) un num_cancelled (atcelti).

curl https://api.x.ai/v1/batches/$BATCH_ID \
  -H "Authorization: Bearer $XAI_API_KEY"

Kad num_pending nokrītas līdz nullei, visi pieprasījumi ir apstrādāti – veiksmīgi vai nē. Pietiek ar periodisku aptauju: dažas sekundes nelielai testa partijai, dažas minūtes lielai partijai.

4. solis: Rezultātu iegūšana

Rezultātus nolasi ar GET /v1/batches/{batch_id}/results**, **negaidot**, kamēr partija būs pabeigta: katrs pieprasījums ir pieejams tiklīdz tas ir apstrādāts. Atbilde ir lapota: limitnosaka lapas lielumu (maksimums 1000), un atgrieztaispagination_token` tiek izmantots nākamās lapas pieprasīšanai; pēdējā lapā tas ir tukšs.

curl "https://api.x.ai/v1/batches/$BATCH_ID/results?limit=100" \
  -H "Authorization: Bearer $XAI_API_KEY"

Katrs rezultāts satur sava pieprasījuma batch_request_id: tas ļauj atjaunot atbilstību starp tavu ievades datiem un Grok atbildēm.

Darba plūsma praksē

Ražošanas vidē darba plūsma parasti tiek realizēta kā divi atsevišķi procesi:

  • Iesniegšanas process, kas izveido partiju, sagatavo un pievieno pieprasījumus, pēc tam saglabā batch_id
  • Iegūšanas process, kas periodiski pārbauda skaitītājus un lejupielādē rezultātus, tiklīdz tie kļūst pieejami

Šī nodalīšana ļauj integrēt Batch API notikumu virzītās arhitektūrās vai esošajās datu cauruļvados (cron uzdevumi, Apache Airflow, rindas).

Kļūdu apstrāde darba plūsmā

Partijai nav globāla “veiksmīga” vai “neizdevusies” stāvokļa: tu to nolasi caur tās skaitītājiem. Neizdevies pieprasījums palielina num_error un parādās rezultātos kopā ar kļūdas ziņojumu, nebloķējot pārējos. Tāpēc tev ir jāpārbauda katrs rezultāts un jāapstrādā kļūdas katrā gadījumā atsevišķi.

Divi notikumi ietekmē visu partiju. Pirmais ir atcelšana, ko veic tu vai xAI, kas tad to paskaidro laukā cancel_by_xai_message. Tas jo īpaši notiek, ja JSONL failā ir nederīga rinda. Otrs ir derīguma termiņa beigas (expire_time), pēc kurām rezultāti vairs nav pieejami: iegūsti tos laicīgi.

Galvenās atziņas

  • Darba plūsma seko secībai: izveide (ar nosaukumu), pievienošana, uzraudzība, iegūšana
  • Pieprasījuma identifikators (batch_request_id vai custom_id JSONL) ir tava saskaņošanas atslēga
  • Progress tiek nolasīts no state skaitītājiem; viss ir apstrādāts, kad num_pending ir nulle
  • Rezultāti ir lapoti (limit, pagination_token) un pieejami, tiklīdz tie ir apstrādāti
  • Kļūdas tiek apstrādātas pieprasījumu līmenī; atcelšana un derīguma termiņa beigas ietekmē visu partiju