Hændelserne session.created og session.updated
På denne side
Opdateret 3. november 2026 baseret på xAI’s side om Speech to Speech og Voice API-referencen. Referencen specificerer ikke indholdet af
session-objektet i disse hændelser; det ID, du skal gemme, er samtalens,conversation.id, som genoptagelse af sessionen afhænger af. Kilder: Speech to Speech · Voice API.
Server-sessionhændelser
Når du arbejder med Voice Agent API, holder serveren dig orienteret om sessionens tilstand via JSON-hændelser. De første, du modtager, er session.created, når forbindelsen åbnes, og conversation.created. Derefter følger session.updated efter hver konfiguration, du sender.
session.created
Serveren sender denne hændelse automatisk, så snart WebSocket-forbindelsen åbnes. Ifølge referencen indeholder den sessionskonfigurationen, men felterne er ikke detaljeret. I stedet for at antage standardværdier bør du logge hændelsen én gang for at se, hvad serveren returnerer, og derefter sende din egen konfiguration.
Hvad du skal gøre, når session.created ankommer
Din app bør:
- Logge hændelsen til fejlfinding
- Straks sende din
session.updatemed den ønskede konfiguration - Tømme lydbufferen, du fyldte, mens du ventede på forbindelsen
Det tredje punkt stammer fra xAI’s råd om at reducere den oplevede latency: Start optagelsen fra mikrofonen, så snart skærmen åbnes, uden at vente på forbindelsen, gem prøverne i hukommelsen, og send dem derefter, så snart forbindelsen er klar, og konfigurationen er sendt.
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
Denne hændelse bekræfter din session.update: sessionen er konfigureret. For nogle indstillinger angiver dokumentationen, at den anvendte værdi sendes tilbage her, som det er tilfældet med tabellen over udskiftning af udtale (replace). En ugyldig konfiguration bliver derimod afvist med en error-hændelse, der beskriver problemet; sessionen forbliver åben og beholder sin tidligere konfiguration.
Tjek konfigurationen
Sammenlign de returnerede værdier med dem, du sendte: Det er sådan, du fanger en indstilling, der blev ignoreret.
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
Serveren sender også en conversation.created-hændelse, som indeholder samtale-ID’et:
{
"type": "conversation.created",
"conversation": {
"id": "conv_xyz789"
}
}
Gem dette ID: Det er det, der muliggør genoptagelse af sessionen. Som standard mister en forbindelse samtalehistorikken, når WebSocket lukkes. Hvis du sender "resumption": {"enabled": true} i session.update, cacher serveren hver tur. Når du genopretter forbindelsen, skal du åbne WebSocket igen med ?conversation_id=<id> og genaktivere genoptagelse: De tidligere ture afspilles før din første nye tur. Historikken slettes efter 30 minutters inaktivitet.
Den fulde opstartssekvens
For at opsummere er her rækkefølgen af hændelser, når en talesession starter, som referencen beskriver det:
- WebSocket åbnes
- Du modtager
session.created(server → klient) - Du modtager
conversation.created(server → klient) - Du sender
session.update(klient → server) - Du modtager
session.updated(server → klient)
Vigtige pointer
session.createdankommer, når forbindelsen åbnes, og indeholder sessionskonfigurationen, hvis felter referencen ikke detaljerersession.updatedbekræfter din konfiguration; en ugyldig konfiguration returnerer enerror-hændelse- Optag fra mikrofonen før forbindelsen og tøm bufferen, så snart den er klar
conversation.createdindeholderconversation.id, som du gemmer til genoptagelse af sessionen- Genoptagelse kræver
resumption.enabledved hver forbindelse, og historikken udløber efter 30 minutters inaktivitet