Notikumi session.created un session.updated
Šajā lapā
Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI Speech to Speech lapu un Voice API atsauces dokumentāciju. Atsauce nesniedz detalizētu informāciju par
sessionobjekta saturu šajos notikumos; saglabājamais identifikators ir sarunas ID jebconversation.id, uz kuru balstās sesijas atsākšana. Avoti: Speech to Speech · Voice API.
Servera sesijas notikumi
Strādājot ar Voice Agent API, servers tevi informē par sesijas stāvokli, izmantojot JSON notikumus. Pirmie saņemtie notikumi ir session.created, kas tiek ģenerēts, atverot savienojumu, un conversation.created. Tam seko session.updated, kas nāk pēc katras nosūtītās konfigurācijas.
session.created
Servers šo notikumu nosūta automātiski, tiklīdz tiek atvērts WebSocket savienojums. Saskaņā ar atsauces dokumentāciju tas satur sesijas konfigurāciju, taču tās lauki nav detalizēti aprakstīti. Tā vietā, lai pieņemtu noklusējuma vērtības, vienreiz reģistrē (log) notikumu, lai redzētu, ko servers atgriež, un tikai tad nosūti savu konfigurāciju.
Ko darīt, kad tiek saņemts session.created
Tava lietotnei vajadzētu:
- Reģistrēt notikumu atkļūdošanas nolūkos.
- Nekavējoties nosūtīt savu
session.updatear vēlamo konfigurāciju. - Iztukšot audio buferi, ko aizpildīji, gaidot savienojuma izveidi.
Trešais punkts izriet no xAI ieteikumiem par uztvertās latentces samazināšanu: sāc mikrofonu fiksēt uzreiz, kad tiek atvērta ekrāna skats, negaidot savienojumu, saglabā paraugus atmiņā un nosūti tos tiklīdz savienojums ir gatavs un konfigurācija ir nosūtīta.
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 notikums apstiprina tavu session.update: sesija ir konfigurēta. Dažiem iestatījumiem dokumentācija norāda, ka šeit tiek atgriezta piemērotā vērtība, piemēram, izrunas aizstāšanas tabulai (replace). Savukārt nederīga konfigurācija tiek noraidīta ar error notikumu, kas apraksta problēmu; sesija paliek atvērta un saglabā iepriekšējo konfigurāciju.
Konfigurācijas pārbaude
Salīdzini atgrieztās vērtības ar tām, ko nosūtīji: tā tu pamanīsi iestatījumu, kas tika ignorēts.
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
Servers nosūta arī conversation.created notikumu, kas satur sarunas identifikatoru:
{
"type": "conversation.created",
"conversation": {
"id": "conv_xyz789"
}
}
Saglabā šo ID: tieši tas ļauj veikt sesijas atsākšanu. Pēc noklusējuma savienojums zaudē sarunas vēsturi, kad WebSocket tiek aizvērts. Ja session.update nosūti "resumption": {"enabled": true}, servers kešatmiņā saglabā katru maiņu. Atkārtoti pieslēdzoties, atver WebSocket ar ?conversation_id=<id> un atkārtoti aktivizē atsākšanu: iepriekšējās maiņas tiks atskaņotas pirms tava pirmā jaunā teiciena. Vēsture tiek dzēsta pēc 30 minūtēm neaktivitātes.
Pilna startēšanas secība
Apkopojot, lūk, notikumu secība, sākoties balss sesijai, kā to apraksta atsauces dokumentācija:
- Tiek atvērts WebSocket.
- Tu saņem
session.created(servers → klients). - Tu saņem
conversation.created(servers → klients). - Tu nosūti
session.update(klients → servers). - Tu saņem
session.updated(servers → klients).
Galvenās atziņas
session.createdtiek saņemts, atverot savienojumu, un tas satur sesijas konfigurāciju, kuras lauki atsauces dokumentācijā nav detalizēti.session.updatedapstiprina tavu konfigurāciju; nederīga konfigurācija atgriežerrornotikumu.- Fiksē mikrofonu pirms savienojuma izveides un iztukšo buferi, tiklīdz tas ir gatavs.
conversation.createdsaturconversation.id, ko saglabā sesijas atsākšanai.- Atsākšanai katrā savienojumā ir nepieciešams
resumption.enabled, un vēsture tiek dzēsta pēc 30 minūtēm neaktivitātes.