Dogodka session.created in session.updated
Na tej strani
Posodobljeno 3. novembra 2026 na podlagi strani xAI Speech to Speech in referenčne dokumentacije za Voice API. Referenca ne podrobno opisuje vsebine predmeta
sessionv 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:
- Zabeležiti dogodek za namene razhroščevanja
- Takoj poslati svoj
session.updatez želeno konfiguracijo - 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:
- WebSocket se odpre
- Prejmeš
session.created(strežnik → odjemalec) - Prejmeš
conversation.created(strežnik → odjemalec) - Pošlješ
session.update(odjemalec → strežnik) - Prejmeš
session.updated(strežnik → odjemalec)
Ključne ugotovitve
session.createdprispe ob odprtju povezave in vsebuje konfiguracijo seje, katere polja referenca ne podrobno opisujesession.updatedpotrjuje tvojo konfiguracijo; neveljavna konfiguracija vrne dogodekerror- Zajemi mikrofon pred vzpostavitvijo povezave in izprazni medpomnilnik takoj, ko je pripravljen
conversation.creatednosiconversation.id, ki ga ohraniš za nadaljevanje seje- Nadaljevanje zahteva
resumption.enabledpri vsaki povezavi, zgodovina pa poteče po 30 minutah nedejavnosti