Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Įvykiai session.created ir session.updated

Paskaita 4 iš 16 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Serverio sesijos įvykiai
  2. session.created
  3. session.updated
  4. conversation.created
  5. Pilna paleidimo seka
  6. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d., remiantis xAI Speech to Speech puslapiu ir Voice API nuoroda. Nuorodoje detaliai neaprašytas session objekto turinys šiuose įvykiuose; ID, kurį reikia išsaugoti, yra pokalbio ID (conversation.id), nuo kurio priklauso sesijos atnaujinimas. Šaltiniai: Speech to Speech · Voice API.

Serverio sesijos įvykiai

Dirbdamas su Voice Agent API, serveris informuoja tave apie sesijos būseną per JSON įvykius. Pirmieji gaunami įvykiai yra session.created (atidarius ryšį) ir conversation.created. Tada, po kiekvienos išsiųstos konfigūracijos, gaunamas session.updated.

session.created

Serveris šį įvykį siunčia automatiškai, kai tik užmezgamas WebSocket ryšys. Pagal dokumentaciją jame pateikiama sesijos konfigūracija, tačiau jos laukai nėra detaliai aprašyti. Užuot spėliojęs numatytąsias reikšmes, vieną kartą užregistruok įvykį žurnale, kad pamatytum, ką grąžina serveris, o tada siųsk savo konfigūraciją.

Ką daryti gavus session.created

Tavo programa turėtų:

  1. Užregistruoti įvykį derinimo tikslais.
  2. Nedelsiant išsiųsti session.update su norima konfigūracija.
  3. Išvalyti garso buferį, kurį užpildei laukdamas ryšio.

Trečiasis punktas pagrįstas xAI rekomendacija mažinti juntamą delsą: pradėk fiksuoti mikrofono signalą iškart atidarius langą, nelaukdamas ryšio, laikyk mėginius atmintyje ir išsiųsk juos tik tada, kai ryšys paruoštas ir konfigūracija išsiųsta.

ws.on("message", (data) => {
  const event = JSON.parse(data);

  switch (event.type) {
    case "session.created":
      console.log("Session created:", event.session);
      // Send the configuration
      ws.send(JSON.stringify({
        type: "session.update",
        session: {
          instructions: "You are a voice assistant.",
          voice: "rex",
          turn_detection: { type: "server_vad" }
        }
      }));
      // Then send the audio captured while waiting for the connection
      flushMicBuffer(ws);
      break;
  }
});

session.updated

Šis įvykis patvirtina tavo session.update: sesija sukonfigūruota. Kai kuriems nustatymams dokumentacijoje nurodoma, kad čia grąžinama taikoma reikšmė, pavyzdžiui, tarimo pakeitimo lentelės (replace) atveju. Tuo tarpu neteisinga konfigūracija atmetama gaunant error įvykį, kuriame aprašoma problema; sesija lieka atvira ir išlaiko ankstesnę konfigūraciją.

Konfigūracijos tikrinimas

Palygink grąžintas reikšmes su išsiųstomis: taip pastebėsi nustatymus, kurie buvo ignoruoti.

case "session.updated":
  const s = event.session;
  console.log("Configured voice:", s.voice);
  console.log("Number of tools:", s.tools?.length ?? 0);
  break;

case "error":
  console.error("Configuration rejected:", event);
  break;

conversation.created

Serveris taip pat siunčia conversation.created įvykį, kuriame pateikiamas pokalbio ID:

{
  "type": "conversation.created",
  "conversation": {
    "id": "conv_xyz789"
  }
}

Išsaugok šį ID: būtent jis leidžia vykdyti sesijos atnaujinimą. Pagal nutylėjimą, uždarus WebSocket ryšį, pokalbio istorija prarandama. Jei session.update išsiųsi "resumption": {"enabled": true}, serveris talpins kiekvieną ėjimą į podėlį. Prisijungus iš naujo, atidaryk WebSocket su parametru ?conversation_id=<id> ir vėl įjunk atnaujinimą: ankstesni ėjimai bus atkurti prieš tavo pirmąjį naują ėjimą. Istorija ištrinama po 30 minučių neveiklos.

Pilna paleidimo seka

Apibendrinant, štai įvykių eiliškumas pradedant garso sesiją, kaip aprašyta nuorodoje:

  1. Atidaromas WebSocket ryšys
  2. Gaunamas session.created (serveris → klientas)
  3. Gaunamas conversation.created (serveris → klientas)
  4. Išsiunčiamas session.update (klientas → serveris)
  5. Gaunamas session.updated (serveris → klientas)

Svarbiausi punktai

  • session.created gaunamas atidarius ryšį ir jame pateikiama sesijos konfigūracija, kurios laukai nuorodoje nėra detaliai aprašyti
  • session.updated patvirtina tavo konfigūraciją; neteisinga konfigūracija grąžina error įvykį
  • Fiksuok mikrofoną prieš užmezgant ryšį ir išvalyk buferį, kai tik jis paruoštas
  • conversation.created perduoda conversation.id, kurį išsaugai sesijos atnaujinimui
  • Atnaujinimui reikia resumption.enabled kiekviename ryšyje, o istorija galioja 30 minučių po neveiklos