Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Događaji session.created i session.updated

Lekcija 4 od 16 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Događaji sesije na poslužitelju
  2. session.created
  3. session.updated
  4. conversation.created
  5. Puni slijed pokretanja
  6. Ključne točke

Ažurirano 3. studenoga 2026., na temelju xAI stranice Speech to Speech i referencije Voice API-ja. Referenca ne detaljizira sadržaj objekta session u ovim događajima; ID koji trebaš zadržati je ID razgovora, conversation.id, na kojem se oslanja nastavak sesije. Izvori: Speech to Speech · Voice API.

Događaji sesije na poslužitelju

Dok radiš s Voice Agent API-jem, poslužitelj te obavještava o stanju sesije putem JSON događaja. Prvi koje primaš su session.created, kada se veza otvori, i conversation.created. Zatim slijedi session.updated, nakon svake konfiguracije koju pošalješ.

session.created

Poslužitelj automatski šalje ovaj događaj čim se WebSocket veza otvori. Prema referenci, on sadrži konfiguraciju sesije, ali njezina polja nisu detaljno opisana. Umjesto da pretpostavljaš zadane vrijednosti, jednom zapiši događaj u log kako bi vidio što poslužitelj vraća, a zatim pošalji svoju konfiguraciju.

Što učiniti kada stigne session.created

Tvoja aplikacija treba:

  1. Zapisati događaj u log, radi otklanjanja pogrešaka
  2. Odmah poslati svoj session.update s konfiguracijom koju želiš
  3. Isprazniti audio međuspremnik koji si napunio dok si čekao vezu

Treća točka proizlazi iz xAI-jevog savjeta za smanjenje percipiranog kašnjenja: počni hvatati zvuk s mikrofona čim se zaslon otvori, bez čekanja na vezu, drži uzorke u memoriji, a zatim ih pošalji čim veza bude spremna i konfiguracija poslana.

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

Ovaj događaj potvrđuje tvoj session.update: sesija je konfigurirana. Za neke postavke dokumentacija navodi da se ovdje vraća primijenjena vrijednost, kao kod tablice zamjene izgovora (replace). S druge strane, neispravna konfiguracija odbija se događajem error koji opisuje problem; sesija ostaje otvorena i zadržava svoju prethodnu konfiguraciju.

Provjera konfiguracije

Usporedi vraćene vrijednosti s onima koje si poslao: tako ćeš uhvatiti postavku koja je ignorirana.

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

Poslužitelj također šalje događaj conversation.created, koji nosi ID razgovora:

{
  "type": "conversation.created",
  "conversation": {
    "id": "conv_xyz789"
  }
}

Zadrži ovaj ID: on omogućuje nastavak sesije. Zadano, veza gubi povijest razgovora kada se WebSocket zatvori. Ako u session.update pošalješ "resumption": {"enabled": true}, poslužitelj predmemorira svaki krug razgovora. Kada se ponovno povežeš, ponovno otvori WebSocket s ?conversation_id=<id> i ponovno omogući nastavak: prethodni krugovi razgovora reproduciraju se prije tvog prvog novog kruga. Povijest se briše nakon 30 minuta neaktivnosti.

Puni slijed pokretanja

Da sumiramo, evo redoslijeda događaja kada glasovna sesija započne, kako ga opisuje referenca:

  1. WebSocket se otvara
  2. Primaš session.created (poslužitelj → klijent)
  3. Primaš conversation.created (poslužitelj → klijent)
  4. Šalješ session.update (klijent → poslužitelj)
  5. Primaš session.updated (poslužitelj → klijent)

Ključne točke

  • session.created stiže kada se veza otvori i sadrži konfiguraciju sesije, čija polja referenca ne detaljizira
  • session.updated potvrđuje tvoju konfiguraciju; neispravna konfiguracija vraća događaj error
  • Hvataj zvuk s mikrofona prije uspostave veze i isprazni međuspremnik čim bude spremna
  • conversation.created nosi conversation.id, koji zadržavaš za nastavak sesije
  • Nastavak zahtijeva resumption.enabled na svakoj vezi, a povijest istječe nakon 30 minuta neaktivnosti