Na himeachtaí session.created agus session.updated
Ar an leathanach seo
Nuashonraithe an 3 Samhain 2026, bunaithe ar leathanach Speech to Speech xAI agus ar thagairt an Voice API. Ní dhéanann an tagairt cur síos ar ábhar an oibiachta
sessionsna himeachtaí seo; is é an t-aithneoir le coimeáil ná aithneoir an chomhrá,conversation.id, ar a mbraitheann aththosaigh seisiúin. Foinse: Speech to Speech · Voice API.
Imeachtaí seisiúin freastalaí
Agus tú ag obair leis an Voice Agent API, coinneoidh an freastalaí ar an eolas tú faoi staid an tseisiúin trí imeachtaí JSON. Is iad session.created, nuair a osclaítear an nasc, agus conversation.created na chéad chinn a gheobhaidh tú. Ansin, tagann session.updated tar éis gach cumraíocht a sheolann tú.
session.created
Seolann an freastalaí an t-imeacht seo go huathoibríoch chomh luath agus a osclaítear an nasc WebSocket. De réir na tagartha, tá cumraíocht an tseisiúin ann, ach níl a réimsí sonraithe. In ionad luachanna réamhshocraithe a ghlacadh leis, déan logáil air uair amháin chun a fheiceáil cad a thugann an freastalaí ar ais, agus ansin seol do chumraíocht féin.
Cad le déanamh nuair a thagann session.created
Ba chóir do d’fheidhmchlár:
- Logáil an t-imeacht, chun dífhabhtaithe
- Seol láithreach do
session.updateleis an gcumraíocht atá uait - Folmhaigh an maolán fuaime a líon tú agus tú ag fanacht leis an nasc
Tagann an tríú pointe ó chomhairle xAI chun moill mhothaithe a laghdú: tosaigh ag gabháil na micreafóine chomh luath agus a osclaítear an scáileán, gan fanacht leis an nasc, coinnigh na samplaí sa chuimhne, agus ansin seol iad chomh luath agus atá an nasc réidh agus an chumraíocht seolta.
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
Aithníonn an t-imeacht seo do session.update: tá an seisiún cumraithe. I gcás roinnt socruithe, deir an doiciméadú go seoltar an luach curtha i bhfeidhm ar ais anseo, mar atá leis an tábla athsholáthair fuaimniúcháin (replace). Ar an láimh eile, diúltaítear cumraíocht neamhbhailí le himeacht error a dhéanann cur síos ar an bhfadhb; fanann an seisiún oscailte agus coinníonn sé a chumraíocht roimhe seo.
Seiceáil an chumraíochta
Déan comparáid idir na luachanna a filltear agus na cinn a sheol tú: sin an bealach chun socruithe a rinneadh neamhaird orthu a bhrath.
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
Seolann an freastalaí imeacht conversation.created freisin, a iompraíonn aithneoir an chomhrá:
{
"type": "conversation.created",
"conversation": {
"id": "conv_xyz789"
}
}
Coinnigh an t-aithneoir seo: is é seo a dhéanann aththosaigh seisiúin indéanta. Go réamhshocraithe, cailleann nasc stair an chomhrá nuair a dhúntar an WebSocket. Má sheolann tú "resumption": {"enabled": true} in session.update, déanfaidh an freastalaí stóráil ar gach casadh. Nuair a athnascann tú, athoscail an WebSocket le ?conversation_id=<id> agus cumasaigh aththosaigh arís: déanfar na casaidh roimhe seo a athsheinm roimh do chéad chasadh nua. Scriostar an stair tar éis 30 nóiméad neamhghníomhaíochta.
An seicheamh tosaithe iomlán
Chun achoimre a dhéanamh, seo ord na n-imeachtaí nuair a thosaíonn seisiún gutha, mar a thuairiscíonn an tagairt é:
- Osclaítear an WebSocket
- Faigheann tú
session.created(freastalaí → cliant) - Faigheann tú
conversation.created(freastalaí → cliant) - Seolann tú
session.update(cliant → freastalaí) - Faigheann tú
session.updated(freastalaí → cliant)
Príomhphointí
- Tagann
session.creatednuair a osclaítear an nasc agus tá cumraíocht an tseisiúin ann, cé nach ndéanann an tagairt cur síos ar a réimsí - Aithníonn
session.updateddo chumraíocht; filleann cumraíocht neamhbhailí imeachterror - Gabh an mhicreafón roimh an nasc agus folmhaigh an maolán chomh luath agus atá sé réidh
- Iompraíonn
conversation.createdanconversation.id, a choimeádann tú le haghaidh aththosaithe seisiúin - Éilíonn aththosaigh
resumption.enabledar gach nasc, agus téann an stair in éag tar éis 30 nóiméad neamhghníomhaíochta