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

Mantojuma statuss un bezstāvokļa princips

Nodarbība 1 no 12 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Sarunu pabeigšanas (Chat Completions) galapunkts xAI ekosistēmā
  2. Bezstāvokļa galapunkts: nosūti visu ar katru pieprasījumu
  3. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI labākās prakses vadlīnijām: xAI tagad klasificē sarunu pabeigšanu (Chat Completions) kā novecojušu un Grok spriešanas modeļiem iesaka izmantot atbilžu API (Responses API). Konkrēts iemesls: sarunu pabeigšanā trūkst lauka modeļa šifrētajai spriešanai, tāpēc katrs daudzu soļu dialogs vai rīka izsaukums zaudē iepriekšējo soļu spriešanas datus. Jaunas funkcijas vispirms tiek ieviestas atbilžu API. Avoti: xAI Best Practices · Chat Completions (legacy).

Sarunu pabeigšanas (Chat Completions) galapunkts xAI ekosistēmā

xAI API piedāvā divus galvenos galapunktus darbam ar Grok modeļiem: atbilžu API (galvenais galapunkts) un sarunu pabeigšanas galapunktu. Pēdējais ir atzīmēts kā mantojums (legacy): tas joprojām ir pilnībā funkcionāls, taču jaunas funkcijas tagad prioritāri tiek izstrādātas atbilžu API.

Kāpēc tad par to interesēties? Tāpēc, ka sarunu pabeigšana joprojām ir visplašāk adoptētais galapunkts ekosistēmā. Visi esošie OpenAI SDK, ietvari, piemēram, LangChain vai LlamaIndex, un tūkstošiem apmācību materiālu izmanto šo formātu. Ja migrē no cita pakalpojumu sniedzēja vai strādā ar trešo pušu rīkiem, visticamāk, vispirms izmantosi tieši šo galapunktu.

Mantojums
Oficiālais statuss
Bezstāvokļa
Nav servera stāvokļa
OpenAI
Saderīgs formāts
3600s
Ieteicamais noilgums

Bezstāvokļa galapunkts: nosūti visu ar katru pieprasījumu

Sarunu pabeigšanas fundamentālais princips ir tas, ka tā ir bezstāvokļa: serveris neglabā sarunu vēsturi. Ar katru izsaukumu tev savā pieprasījumā jāiekļauj visa iepriekšējo ziņojumu vēsture.

Konkrēti tas nozīmē, ka sarunā ar 10 apmaiņām tavam 11. pieprasījumam jāsatur 10 iepriekšējie ziņojumi (lietotājs + asistents) plus jaunais ziņojums. Tava lietotne pārvalda šo vēsturi.

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello!"},
    {"role": "assistant", "content": "Hello! How can I help you?"},
    {"role": "user", "content": "Explain deep learning to me."}
  ]
}

Šajā piemērā pirmie trīs ziņojumi attēlo sarunu vēsturi. Tikai pēdējais ir jaunais lietotāja ziņojums. Modelim ir nepieciešams viss šis konteksts, lai ģenerētu sakarīgu atbildi.

Praktiskas sekas

Šai bezstāvokļa pieejai ir vairākas sekas:

  • Pilnīga kontrole: tu pats lemj, kuri tieši ziņojumi tiek nosūtīti modelim. Pirms katra izsaukuma vari filtrēt, apkopot vai modificēt vēsturi.
  • Proporcionālas izmaksas: par katru pieprasījumu tiek aprēķināta maksa par visiem nosūtītajiem tokeniem, ieskaitot vēsturi. Jo garāka saruna, jo dārgāka kļūst katra nākamā apmaiņa.
  • Nav servera pastāvīguma: starp pieprasījumiem xAI pusē netiek glabāti nekādi dati. Tas ir privātuma ziņā izdevīgi, taču tev pašam jānodrošina datu saglabāšana.

Salīdzinājums ar atbilžu API

Atbilžu API savukārt ir ar stāvokli: tā glabā vēsturi servera pusē, izmantojot previous_response_id. Tev nav jānosūta iepriekšējie ziņojumi atkārtoti – pietiek ar vienu identifikatoru. Atbildes var uzglabāt līdz 30 dienām, izmantojot store: true.

Izvēle starp abiem ir atkarīga no tava lietojuma gadījuma. Ja strādā ar esošu OpenAI SDK vai migrē no cita pakalpojumu sniedzēja, sarunu pabeigšana ir loģisks sākumpunkts. Jaunam projektam ieteicama atbilžu API.

Galvenās atziņas

  • Sarunu pabeigšana ir atzīmēta kā mantojums, taču tā joprojām ir pilnībā funkcionāla un saderīga ar OpenAI ekosistēmu
  • Galapunkts ir bezstāvokļa: ar katru pieprasījumu tev jānosūta pilna vēsture
  • Katra pieprasījuma izmaksas ietver visus vēstures tokenus
  • Atbilžu API piedāvā alternatīvu ar stāvokli un datu glabāšanu servera pusē
  • Spriešanas modeļiem ieteicams izmantot 3600 sekunžu noilgumu