Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Sündmused session.created ja session.updated

Õppetund 4 / 16 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Serveri sessiooni sündmused
  2. session.created
  3. session.updated
  4. conversation.created
  5. Täielik käivitamise jada
  6. Peamised punktid

Uuendatud 3. novembril 2026, tuginedes xAI Speech to Speech lehele ja Voice API referentsdokumentatsioonile. Referents ei kirjelda üksikasjalikult nende sündmuste session objekti sisu; ID, mida tuleb säilitada, on vestluse oma, conversation.id, millele sessiooni taastamine tugineb. Allikad: Speech to Speech · Voice API.

Serveri sessiooni sündmused

Kui töötad Voice Agent API-ga, hoiab server sind JSON-sündmuste kaudu kursis sessiooni olekuga. Esimesed sündmused, mida saad, on session.created ühenduse avamisel ja conversation.created. Seejärel saabub session.updated pärast iga saadetud konfiguratsiooni.

session.created

Server saadab selle sündmuse automaatselt niipea, kui WebSocketi ühendus avaneb. Referentsi kohaselt sisaldab see sessiooni konfiguratsiooni, kuid selle välju pole üksikasjalikult kirjeldatud. Vaikimisi väärtuste eeldamise asemel logi see kord, et näha, mida server tagastab, ja seejärel saada oma konfiguratsioon.

Mida teha, kui session.created saabub

Sinu rakendus peaks:

  1. Sündmuse logima silumiseks
  2. Kohe saatma oma session.update soovitud konfiguratsiooniga
  3. Tühjendama helipuhvri, mille täitsid ühenduse ootamise ajal

Kolmas punkt tuleneb xAI soovitusest vähendada tajutavat latentsust: hakka mikrofoni salvestama niipea, kui ekraan avaneb, ootamata ühendust, hoia proove mälus ja saada need edasi niipea, kui ühendus on valmis ja konfiguratsioon saadetud.

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

  switch (event.type) {
    case "session.created":
      console.log("Session created:", event.session);
      // Saada konfiguratsioon
      ws.send(JSON.stringify({
        type: "session.update",
        session: {
          instructions: "You are a voice assistant.",
          voice: "rex",
          turn_detection: { type: "server_vad" }
        }
      }));
      // Seejärel saada ühenduse ooteajal salvestatud heli
      flushMicBuffer(ws);
      break;
  }
});

session.updated

See sündmus kinnitab sinu session.update-i: sessioon on konfigureeritud. Mõne seadistuse puhul märgib dokumentatsioon, et siin saadetakse tagasi rakendatud väärtus, nagu häälduse asendamise tabeli (replace) puhul. Vigane konfiguratsioon lükatakse aga tagasi error sündmusega, mis kirjeldab probleemi; sessioon jääb avatuks ja säilitab eelmise konfiguratsiooni.

Konfiguratsiooni kontrollimine

Võrdle tagastatud väärtusi nendega, mida saatsid: nii püüad kinni seadistuse, mida eirati.

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

Server saadab ka conversation.created sündmuse, mis kannab endas vestluse ID-d:

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

Säilita see ID: just see võimaldab sessiooni taastamist. Vaikimisi kaotab ühendus vestluse ajaloo, kui WebSocket sulgub. Kui saadad session.update sees "resumption": {"enabled": true}, vahemällu server iga pöörde. Uuesti ühendudes ava WebSocket parameetriga ?conversation_id=<id> ja luba taastamine uuesti: eelmised pöörded esitatakse enne sinu esimest uut pööret. Ajalugu kustutatakse pärast 30-minutilist tegevusetust.

Täielik käivitamise jada

Kokkuvõtvalt on siin sündmuste järjekord häälsessiooni käivitamisel, nagu referents seda kirjeldab:

  1. WebSocket avaneb
  2. Saad session.created (server → klient)
  3. Saad conversation.created (server → klient)
  4. Saadad session.update (klient → server)
  5. Saad session.updated (server → klient)

Peamised punktid

  • session.created saabub ühenduse avamisel ja sisaldab sessiooni konfiguratsiooni, mille välju referents üksikasjalikult ei kirjelda
  • session.updated kinnitab sinu konfiguratsiooni; vigane konfiguratsioon tagastab error sündmuse
  • Salvesta mikrofoni enne ühenduse loomist ja tühjenda puhver niipea, kui see on valmis
  • conversation.created kannab conversation.id, mida säilitad sessiooni taastamiseks
  • Taastamine nõuab igal ühendusel resumption.enabled lubamist ja ajalugu aegub pärast 30-minutilist tegevusetust