Įvykiai session.created ir session.updated
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d., remiantis xAI Speech to Speech puslapiu ir Voice API nuoroda. Nuorodoje detaliai neaprašytas
sessionobjekto turinys šiuose įvykiuose; ID, kurį reikia išsaugoti, yra pokalbio ID (conversation.id), nuo kurio priklauso sesijos atnaujinimas. Šaltiniai: Speech to Speech · Voice API.
Serverio sesijos įvykiai
Dirbdamas su Voice Agent API, serveris informuoja tave apie sesijos būseną per JSON įvykius. Pirmieji gaunami įvykiai yra session.created (atidarius ryšį) ir conversation.created. Tada, po kiekvienos išsiųstos konfigūracijos, gaunamas session.updated.
session.created
Serveris šį įvykį siunčia automatiškai, kai tik užmezgamas WebSocket ryšys. Pagal dokumentaciją jame pateikiama sesijos konfigūracija, tačiau jos laukai nėra detaliai aprašyti. Užuot spėliojęs numatytąsias reikšmes, vieną kartą užregistruok įvykį žurnale, kad pamatytum, ką grąžina serveris, o tada siųsk savo konfigūraciją.
Ką daryti gavus session.created
Tavo programa turėtų:
- Užregistruoti įvykį derinimo tikslais.
- Nedelsiant išsiųsti
session.updatesu norima konfigūracija. - Išvalyti garso buferį, kurį užpildei laukdamas ryšio.
Trečiasis punktas pagrįstas xAI rekomendacija mažinti juntamą delsą: pradėk fiksuoti mikrofono signalą iškart atidarius langą, nelaukdamas ryšio, laikyk mėginius atmintyje ir išsiųsk juos tik tada, kai ryšys paruoštas ir konfigūracija išsiųsta.
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
Šis įvykis patvirtina tavo session.update: sesija sukonfigūruota. Kai kuriems nustatymams dokumentacijoje nurodoma, kad čia grąžinama taikoma reikšmė, pavyzdžiui, tarimo pakeitimo lentelės (replace) atveju. Tuo tarpu neteisinga konfigūracija atmetama gaunant error įvykį, kuriame aprašoma problema; sesija lieka atvira ir išlaiko ankstesnę konfigūraciją.
Konfigūracijos tikrinimas
Palygink grąžintas reikšmes su išsiųstomis: taip pastebėsi nustatymus, kurie buvo ignoruoti.
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
Serveris taip pat siunčia conversation.created įvykį, kuriame pateikiamas pokalbio ID:
{
"type": "conversation.created",
"conversation": {
"id": "conv_xyz789"
}
}
Išsaugok šį ID: būtent jis leidžia vykdyti sesijos atnaujinimą. Pagal nutylėjimą, uždarus WebSocket ryšį, pokalbio istorija prarandama. Jei session.update išsiųsi "resumption": {"enabled": true}, serveris talpins kiekvieną ėjimą į podėlį. Prisijungus iš naujo, atidaryk WebSocket su parametru ?conversation_id=<id> ir vėl įjunk atnaujinimą: ankstesni ėjimai bus atkurti prieš tavo pirmąjį naują ėjimą. Istorija ištrinama po 30 minučių neveiklos.
Pilna paleidimo seka
Apibendrinant, štai įvykių eiliškumas pradedant garso sesiją, kaip aprašyta nuorodoje:
- Atidaromas WebSocket ryšys
- Gaunamas
session.created(serveris → klientas) - Gaunamas
conversation.created(serveris → klientas) - Išsiunčiamas
session.update(klientas → serveris) - Gaunamas
session.updated(serveris → klientas)
Svarbiausi punktai
session.createdgaunamas atidarius ryšį ir jame pateikiama sesijos konfigūracija, kurios laukai nuorodoje nėra detaliai aprašytisession.updatedpatvirtina tavo konfigūraciją; neteisinga konfigūracija grąžinaerrorįvykį- Fiksuok mikrofoną prieš užmezgant ryšį ir išvalyk buferį, kai tik jis paruoštas
conversation.createdperduodaconversation.id, kurį išsaugai sesijos atnaujinimui- Atnaujinimui reikia
resumption.enabledkiekviename ryšyje, o istorija galioja 30 minučių po neveiklos