Udalosti session.created a session.updated
Na tejto strane
Aktualizované 3. novembra 2026 na základe stránky xAI Speech to Speech a referencie Voice API. Referencia podrobne nešpecifikuje obsah objektu
sessionv 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:
- Zaznamenať udalosť do logu (pre účely ladenia)
- Okamžite odoslať svoju požiadavku
session.updates požadovanou konfiguráciou - 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:
- Otvorí sa WebSocket
- Prijmeš
session.created(server → klient) - Prijmeš
conversation.created(server → klient) - Odošleš
session.update(klient → server) - Prijmeš
session.updated(server → klient)
Kľúčové poznatky
session.createdpríde po otvorení pripojenia a obsahuje konfiguráciu relácie, ktorej polia referencia podrobne nešpecifikujesession.updatedpotvrdzuje 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.creatednesieconversation.id, ktoré si uschováš pre obnovenie relácie- Obnovenie vyžaduje nastavenie
resumption.enabledpri každom pripojení a história expiruje po 30 minútach nečinnosti