Događaji session.created i session.updated
Na ovoj stranici
Ažurirano 3. studenoga 2026., na temelju xAI stranice Speech to Speech i referencije Voice API-ja. Referenca ne detaljizira sadržaj objekta
sessionu 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:
- Zapisati događaj u log, radi otklanjanja pogrešaka
- Odmah poslati svoj
session.updates konfiguracijom koju želiš - 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:
- WebSocket se otvara
- Primaš
session.created(poslužitelj → klijent) - Primaš
conversation.created(poslužitelj → klijent) - Šalješ
session.update(klijent → poslužitelj) - Primaš
session.updated(poslužitelj → klijent)
Ključne točke
session.createdstiže kada se veza otvori i sadrži konfiguraciju sesije, čija polja referenca ne detaljizirasession.updatedpotvrđuje tvoju konfiguraciju; neispravna konfiguracija vraća događajerror- Hvataj zvuk s mikrofona prije uspostave veze i isprazni međuspremnik čim bude spremna
conversation.creatednosiconversation.id, koji zadržavaš za nastavak sesije- Nastavak zahtijeva
resumption.enabledna svakoj vezi, a povijest istječe nakon 30 minuta neaktivnosti