Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Na himeachtaí session.created agus session.updated

Ceacht 4 as 16 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Imeachtaí seisiúin freastalaí
  2. session.created
  3. session.updated
  4. conversation.created
  5. An seicheamh tosaithe iomlán
  6. Príomhphointí

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 session sna 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:

  1. Logáil an t-imeacht, chun dífhabhtaithe
  2. Seol láithreach do session.update leis an gcumraíocht atá uait
  3. 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 é:

  1. Osclaítear an WebSocket
  2. Faigheann tú session.created (freastalaí → cliant)
  3. Faigheann tú conversation.created (freastalaí → cliant)
  4. Seolann tú session.update (cliant → freastalaí)
  5. Faigheann tú session.updated (freastalaí → cliant)

Príomhphointí

  • Tagann session.created nuair 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.updated do chumraíocht; filleann cumraíocht neamhbhailí imeacht error
  • Gabh an mhicreafón roimh an nasc agus folmhaigh an maolán chomh luath agus atá sé réidh
  • Iompraíonn conversation.created an conversation.id, a choimeádann tú le haghaidh aththosaithe seisiúin
  • Éilíonn aththosaigh resumption.enabled ar gach nasc, agus téann an stair in éag tar éis 30 nóiméad neamhghníomhaíochta