Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-avvenimenti session.created u session.updated

Lezzjoni 4 / 16 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Avvenimenti tas-sessjoni tas-server
  2. session.created
  3. session.updated
  4. conversation.created
  5. Is-sekwenza sħiħa tal-bidu
  6. Punti Ewlenin

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 session f’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:

  1. Tirreġistra l-avveniment, għad-diagnostika
  2. Tibgħat immedjatament is-session.update tiegħek bil-konfigurazzjoni li trid
  3. 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:

  1. Tiftaħ il-WebSocket
  2. Tirċievi session.created (server → client)
  3. Tirċievi conversation.created (server → client)
  4. Tibgħat session.update (client → server)
  5. Tirċievi session.updated (server → client)

Punti Ewlenin

  • session.created jasal meta tiftaħ il-konnessjoni u fih il-konfigurazzjoni tas-sessjoni, li l-oqsma tagħha r-referenza ma tiddettaljax
  • session.updated jikkonferma l-konfigurazzjoni tiegħek; konfigurazzjoni mhux valida tirritorna avveniment error
  • Aqbad il-mikrofonu qabel il-konnessjoni u neħħi l-buffer hekk kif tkun lesta
  • conversation.created iġorr il-conversation.id, li għandek iżżomm għar-ripristina tas-sessjoni
  • Ir-ripristina teħtieġ resumption.enabled fuq kull konnessjoni, u l-istorja tiskadi wara 30 minuta ta’ inattività