Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Hændelserne session.created og session.updated

Lektion 4 af 16 Opdateret 3. november 2026 Udvikler
På denne side
  1. Server-sessionhændelser
  2. session.created
  3. session.updated
  4. conversation.created
  5. Den fulde opstartssekvens
  6. Vigtige pointer

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:

  1. Logge hændelsen til fejlfinding
  2. Straks sende din session.update med den ønskede konfiguration
  3. 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:

  1. WebSocket åbnes
  2. Du modtager session.created (server → klient)
  3. Du modtager conversation.created (server → klient)
  4. Du sender session.update (klient → server)
  5. Du modtager session.updated (server → klient)

Vigtige pointer

  • session.created ankommer, når forbindelsen åbnes, og indeholder sessionskonfigurationen, hvis felter referencen ikke detaljerer
  • session.updated bekræfter din konfiguration; en ugyldig konfiguration returnerer en error-hændelse
  • Optag fra mikrofonen før forbindelsen og tøm bufferen, så snart den er klar
  • conversation.created indeholder conversation.id, som du gemmer til genoptagelse af sessionen
  • Genoptagelse kræver resumption.enabled ved hver forbindelse, og historikken udløber efter 30 minutters inaktivitet