Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Dogodka session.created in session.updated

Lekcija 4 od 16 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Dogodki seje na strežniku
  2. session.created
  3. session.updated
  4. conversation.created
  5. Celotno zaporedje zagona
  6. Ključne ugotovitve

Posodobljeno 3. novembra 2026 na podlagi strani xAI Speech to Speech in referenčne dokumentacije za Voice API. Referenca ne podrobno opisuje vsebine predmeta session v teh dogodkih; ID, ki ga moraš ohraniti, je ID pogovora, conversation.id, od katerega je odvisna nadaljevanje seje. Viri: Speech to Speech · Voice API.

Dogodki seje na strežniku

Ko delaš z Voice Agent API, te strežnik prek dogodkov JSON obvešča o stanju seje. Prva, ki ju prejmeš, sta session.created, ko se povezava odpre, in conversation.created. Sledi session.updated, ki pride po vsaki konfiguraciji, ki jo pošlješ.

session.created

Strežnik ta dogodek samodejno pošlje takoj, ko se povezava WebSocket odpre. Glede na referenco vsebuje konfiguracijo seje, vendar njena polja niso podrobno opisana. Namesto da bi predpostavljal privzete vrednosti, dogodek enkrat zabeleži, da vidiš, kaj strežnik vrne, nato pa pošlji svojo konfiguracijo.

Kaj storiti, ko prispe session.created

Tvoja aplikacija mora:

  1. Zabeležiti dogodek za namene razhroščevanja
  2. Takoj poslati svoj session.update z želeno konfiguracijo
  3. Izprazniti medpomnilnik zvoka, ki si ga napolnil med čakanjem na povezavo

Tretja točka izhaja iz nasveta xAI za zmanjšanje zaznane zakasnitve: začni zajemati mikrofon takoj, ko se odpre zaslon, ne da bi čakal na povezavo, vzorce hrani v pomnilniku in jih pošlji takoj, ko je povezava vzpostavljena in konfiguracija poslana.

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

Ta dogodek potrjuje tvoj session.update: seja je konfigurirana. Za nekatere nastavitve dokumentacija navaja, da se tu vrne uporabljena vrednost, kot je to pri tabeli za zamenjavo izgovorjave (replace). Neveljavna konfiguracija pa je zavrnjena z dogodkom error, ki opisuje težavo; seja ostane odprta in ohrani svojo prejšnjo konfiguracijo.

Preveri konfiguracijo

Primerjaj vrnjene vrednosti s tistimi, ki si jih poslal: tako boš odkril nastavitev, ki je bila prezrta.

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

Strežnik pošlje tudi dogodek conversation.created, ki nosi ID pogovora:

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

Ta ID ohrani: omogoča namreč nadaljevanje seje. Privzeto povezava ob zaprtju WebSocket izgubi zgodovino pogovora. Če v session.update pošlješ "resumption": {"enabled": true}, strežnik predpomni vsak obrat. Ko se ponovno povežeš, ponovno odpri WebSocket z ?conversation_id=<id> in znova omogoči nadaljevanje: prejšnji obrati se predvajajo pred tvojim prvim novim obratom. Zgodovina se zavrže po 30 minutah nedejavnosti.

Celotno zaporedje zagona

Če povzamemo, tukaj je vrstni red dogodkov ob zagonu glasovne seje, kot ga opisuje referenca:

  1. WebSocket se odpre
  2. Prejmeš session.created (strežnik → odjemalec)
  3. Prejmeš conversation.created (strežnik → odjemalec)
  4. Pošlješ session.update (odjemalec → strežnik)
  5. Prejmeš session.updated (strežnik → odjemalec)

Ključne ugotovitve

  • session.created prispe ob odprtju povezave in vsebuje konfiguracijo seje, katere polja referenca ne podrobno opisuje
  • session.updated potrjuje tvojo konfiguracijo; neveljavna konfiguracija vrne dogodek error
  • Zajemi mikrofon pred vzpostavitvijo povezave in izprazni medpomnilnik takoj, ko je pripravljen
  • conversation.created nosi conversation.id, ki ga ohraniš za nadaljevanje seje
  • Nadaljevanje zahteva resumption.enabled pri vsaki povezavi, zgodovina pa poteče po 30 minutah nedejavnosti