Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Udalosti session.created a session.updated

Lekcia 4 z 16 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Udalosti relácie na strane servera
  2. session.created
  3. session.updated
  4. conversation.created
  5. Úplná sekvencia spustenia
  6. Kľúčové poznatky

Aktualizované 3. novembra 2026 na základe stránky xAI Speech to Speech a referencie Voice API. Referencia podrobne nešpecifikuje obsah objektu session v týchto udalostiach; identifikátor, ktorý si musíš zapamätať, je ID konverzácie, conversation.id, na ktorom závisí obnovenie relácie. Zdroje: Speech to Speech · Voice API.

Udalosti relácie na strane servera

Pri práci s Voice Agent API ťa server priebežne informuje o stave relácie prostredníctvom JSON udalostí. Prvé udalosti, ktoré dostaneš, sú session.created (po otvorení pripojenia) a conversation.created. Následne prichádza udalosť session.updated po každej konfigurácii, ktorú odošleš.

session.created

Server túto udalosť odošle automaticky hneď po otvorení WebSocket pripojenia. Podľa referencie obsahuje konfiguráciu relácie, ale jej polia nie sú podrobne popísané. Namiesto toho, aby si predpokladal predvolené hodnoty, si túto udalosť raz zaznamenaj do logu, aby si videl, čo server vráti, a až potom odošli svoju vlastnú konfiguráciu.

Čo robiť po prijatí session.created

Tvoja aplikácia by mala:

  1. Zaznamenať udalosť do logu (pre účely ladenia)
  2. Okamžite odoslať svoju požiadavku session.update s požadovanou konfiguráciou
  3. Vyprázdniť audio buffer, ktorý si naplnil počas čakania na pripojenie

Tretí bod vychádza z odporúčania xAI na zníženie vnímanej latencie: začni zachytávať zvuk z mikrofónu hneď po otvorení obrazovky, nečakaj na pripojenie, uchovávaj vzorky v pamäti a odošli ich hneď, ako je pripojenie pripravené a konfigurácia odoslaná.

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

Táto udalosť potvrdzuje tvoju požiadavku session.update: relácia je nakonfigurovaná. Pri niektorých nastaveniach dokumentácia uvádza, že sa tu vracia aplikovaná hodnota, ako je to napríklad pri tabuľke náhrady výslovnosti (replace). Neplatná konfigurácia sa naopak zamietne udalosťou error, ktorá popisuje problém; relácia zostane otvorená a zachová si svoju predchádzajúcu konfiguráciu.

Kontrola konfigurácie

Porovnaj vrátené hodnoty s tými, ktoré si odoslal: práve tak zachytíš nastavenie, ktoré bolo ignorované.

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 tiež odosiela udalosť conversation.created, ktorá nesie ID konverzácie:

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

Toto ID si uschovaj: umožňuje totiž obnovenie relácie. Predvolene sa pri uzavretí WebSocket pripojenia stratí história konverzácie. Ak do session.update odošleš "resumption": {"enabled": true}, server cacheuje každý krok konverzácie. Keď sa znovu pripojíš, otvor WebSocket s parametrom ?conversation_id=<id> a znova povoľ obnovenie: predchádzajúce kroky sa prehrajú pred tvojím prvým novým krokom. História sa zahodí po 30 minútach nečinnosti.

Úplná sekvencia spustenia

Ak to zhrnieme, toto je poradie udalostí pri štarte hlasovej relácie podľa referencie:

  1. Otvorí sa WebSocket
  2. Prijmeš session.created (server → klient)
  3. Prijmeš conversation.created (server → klient)
  4. Odošleš session.update (klient → server)
  5. Prijmeš session.updated (server → klient)

Kľúčové poznatky

  • session.created príde po otvorení pripojenia a obsahuje konfiguráciu relácie, ktorej polia referencia podrobne nešpecifikuje
  • session.updated potvrdzuje tvoju konfiguráciu; neplatná konfigurácia vráti udalosť error
  • Zachytávaj zvuk z mikrofónu ešte pred vytvorením pripojenia a vyprázdni buffer hneď, ako je pripravený
  • conversation.created nesie conversation.id, ktoré si uschováš pre obnovenie relácie
  • Obnovenie vyžaduje nastavenie resumption.enabled pri každom pripojení a história expiruje po 30 minútach nečinnosti