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

Notikumi session.created un session.updated

Nodarbība 4 no 16 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Servera sesijas notikumi
  2. session.created
  3. session.updated
  4. conversation.created
  5. Pilna startēšanas secība
  6. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI Speech to Speech lapu un Voice API atsauces dokumentāciju. Atsauce nesniedz detalizētu informāciju par session objekta saturu šajos notikumos; saglabājamais identifikators ir sarunas ID jeb conversation.id, uz kuru balstās sesijas atsākšana. Avoti: Speech to Speech · Voice API.

Servera sesijas notikumi

Strādājot ar Voice Agent API, servers tevi informē par sesijas stāvokli, izmantojot JSON notikumus. Pirmie saņemtie notikumi ir session.created, kas tiek ģenerēts, atverot savienojumu, un conversation.created. Tam seko session.updated, kas nāk pēc katras nosūtītās konfigurācijas.

session.created

Servers šo notikumu nosūta automātiski, tiklīdz tiek atvērts WebSocket savienojums. Saskaņā ar atsauces dokumentāciju tas satur sesijas konfigurāciju, taču tās lauki nav detalizēti aprakstīti. Tā vietā, lai pieņemtu noklusējuma vērtības, vienreiz reģistrē (log) notikumu, lai redzētu, ko servers atgriež, un tikai tad nosūti savu konfigurāciju.

Ko darīt, kad tiek saņemts session.created

Tava lietotnei vajadzētu:

  1. Reģistrēt notikumu atkļūdošanas nolūkos.
  2. Nekavējoties nosūtīt savu session.update ar vēlamo konfigurāciju.
  3. Iztukšot audio buferi, ko aizpildīji, gaidot savienojuma izveidi.

Trešais punkts izriet no xAI ieteikumiem par uztvertās latentces samazināšanu: sāc mikrofonu fiksēt uzreiz, kad tiek atvērta ekrāna skats, negaidot savienojumu, saglabā paraugus atmiņā un nosūti tos tiklīdz savienojums ir gatavs un konfigurācija ir nosūtīta.

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 notikums apstiprina tavu session.update: sesija ir konfigurēta. Dažiem iestatījumiem dokumentācija norāda, ka šeit tiek atgriezta piemērotā vērtība, piemēram, izrunas aizstāšanas tabulai (replace). Savukārt nederīga konfigurācija tiek noraidīta ar error notikumu, kas apraksta problēmu; sesija paliek atvērta un saglabā iepriekšējo konfigurāciju.

Konfigurācijas pārbaude

Salīdzini atgrieztās vērtības ar tām, ko nosūtīji: tā tu pamanīsi iestatījumu, kas tika ignorēts.

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

Servers nosūta arī conversation.created notikumu, kas satur sarunas identifikatoru:

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

Saglabā šo ID: tieši tas ļauj veikt sesijas atsākšanu. Pēc noklusējuma savienojums zaudē sarunas vēsturi, kad WebSocket tiek aizvērts. Ja session.update nosūti "resumption": {"enabled": true}, servers kešatmiņā saglabā katru maiņu. Atkārtoti pieslēdzoties, atver WebSocket ar ?conversation_id=<id> un atkārtoti aktivizē atsākšanu: iepriekšējās maiņas tiks atskaņotas pirms tava pirmā jaunā teiciena. Vēsture tiek dzēsta pēc 30 minūtēm neaktivitātes.

Pilna startēšanas secība

Apkopojot, lūk, notikumu secība, sākoties balss sesijai, kā to apraksta atsauces dokumentācija:

  1. Tiek atvērts WebSocket.
  2. Tu saņem session.created (servers → klients).
  3. Tu saņem conversation.created (servers → klients).
  4. Tu nosūti session.update (klients → servers).
  5. Tu saņem session.updated (servers → klients).

Galvenās atziņas

  • session.created tiek saņemts, atverot savienojumu, un tas satur sesijas konfigurāciju, kuras lauki atsauces dokumentācijā nav detalizēti.
  • session.updated apstiprina tavu konfigurāciju; nederīga konfigurācija atgriež error notikumu.
  • Fiksē mikrofonu pirms savienojuma izveides un iztukšo buferi, tiklīdz tas ir gatavs.
  • conversation.created satur conversation.id, ko saglabā sesijas atsākšanai.
  • Atsākšanai katrā savienojumā ir nepieciešams resumption.enabled, un vēsture tiek dzēsta pēc 30 minūtēm neaktivitātes.