L-avvenimenti session.created u session.updated
F'din il-paġna
Aġġornat fit-3 ta’ Novembru 2026, ibbażat fuq il-paġna Speech to Speech ta’ xAI u r-referenza tal-API tal-Vuċi. Ir-referenza ma tiddettaljax il-kontenut tal-oġġett
sessionf’dawn l-avvenimenti; l-ID li għandek iżżomm huwa dak tal-konversazzjoni,conversation.id, li fuqu tiddependi r-ripristina tas-sessjoni. Sorsi: Speech to Speech · Voice API.
Avvenimenti tas-sessjoni tas-server
Meta taħdem mal-API tal-Aġent tal-Vuċi, is-server iżommok infurmat dwar l-istat tas-sessjoni permezz ta’ avvenimenti JSON. L-ewwel wieħed li tirċievi huwa session.created, meta tiftaħ il-konnessjoni, u conversation.created. Imbagħad jiġi session.updated, wara kull konfigurazzjoni li tibgħat.
session.created
Is-server jibgħat dan l-avveniment awtomatikament hekk kif tiftaħ il-konnessjoni WebSocket. Skont ir-referenza, dan fih il-konfigurazzjoni tas-sessjoni, iżda l-oqsma tiegħu mhumiex iddetaljati. Minflok ma tassumi valuri predefiniti, irreġistrah darba biex tara x’jirritorna s-server, imbagħad ibgħat il-konfigurazzjoni tiegħek stess.
X’għandek tagħmel meta jasal session.created
L-app tiegħek għandha:
- Tirreġistra l-avveniment, għad-diagnostika
- Tibgħat immedjatament is-
session.updatetiegħek bil-konfigurazzjoni li trid - Tneħħi l-buffer tal-awdjo li mlejtu waqt li kont tistenna l-konnessjoni
It-tielet punt ġej mill-parir ta’ xAI biex tnaqqas il-latenza percepita: ibda taqbad il-mikrofonu hekk kif tiftaħ l-iskrin, mingħajr ma tistenna l-konnessjoni, żomm il-kampjuni fil-memorja, imbagħad ibgħathom hekk kif tkun lesta l-konnessjoni u tkun intbagħtet il-konfigurazzjoni.
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
Dan l-avveniment jikkonferma s-session.update tiegħek: is-sessjoni hija kkonfigurata. Għal xi settings, id-dokumentazzjoni tgħid li l-valur applikat jintbagħat lura hawnhekk, bħal fil-każ tat-tabella ta’ sostituzzjoni tal-pronunzja (replace). Konfigurazzjoni mhux valida, min-naħa l-oħra, tiġi miċħuda b’avveniment error li jiddeskrivi l-problema; is-sessjoni tibqa’ miftuħa u żżomm il-konfigurazzjoni preċedenti tagħha.
Iċċekkja l-konfigurazzjoni
Qabbel il-valuri rritornati ma’ dawk li bgħatt: hekk taqbad setting li ġie injorat.
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
Is-server jibgħat ukoll avveniment conversation.created, li jġorr l-ID tal-konversazzjoni:
{
"type": "conversation.created",
"conversation": {
"id": "conv_xyz789"
}
}
Żomm dan l-ID: huwa dak li jagħmel possibbli r-ripristina tas-sessjoni. B’mod predefinit, konnessjoni titlef l-istorja tal-konversazzjoni meta tingħalaq il-WebSocket. Jekk tibgħat "resumption": {"enabled": true} f’session.update, is-server jaħżen kull dawra fil-cache. Meta terġa’ tikkonnettja, erġa’ ftħa l-WebSocket b’?conversation_id=<id> u attiva r-ripristina mill-ġdid: id-dawriet preċedenti jerġgħu jindaqqu qabel l-ewwel dawra ġdida tiegħek. L-istorja titneħħa wara 30 minuta ta’ inattività.
Is-sekwenza sħiħa tal-bidu
Biex nagħmlu sommarju, hawnhekk hemm l-ordni tal-avvenimenti meta tibda sessjoni tal-vuċi, kif tiddeskrivih ir-referenza:
- Tiftaħ il-WebSocket
- Tirċievi
session.created(server → client) - Tirċievi
conversation.created(server → client) - Tibgħat
session.update(client → server) - Tirċievi
session.updated(server → client)
Punti Ewlenin
session.createdjasal meta tiftaħ il-konnessjoni u fih il-konfigurazzjoni tas-sessjoni, li l-oqsma tagħha r-referenza ma tiddettaljaxsession.updatedjikkonferma l-konfigurazzjoni tiegħek; konfigurazzjoni mhux valida tirritorna avvenimenterror- Aqbad il-mikrofonu qabel il-konnessjoni u neħħi l-buffer hekk kif tkun lesta
conversation.creatediġorr il-conversation.id, li għandek iżżomm għar-ripristina tas-sessjoni- Ir-ripristina teħtieġ
resumption.enabledfuq kull konnessjoni, u l-istorja tiskadi wara 30 minuta ta’ inattività