Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

De gebeurtenissen session.created en session.updated

Les 4 van 16 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Server-sessiegebeurtenissen
  2. session.created
  3. session.updated
  4. conversation.created
  5. De volledige opstartsequentie
  6. Belangrijkste punten

Bijgewerkt op 3 november 2026, gebaseerd op de xAI-pagina Speech to Speech en de Voice API-referentie. De referentie specificeert niet de inhoud van het session-object in deze gebeurtenissen; het te bewaren ID is dat van de conversatie, conversation.id, waarop het hervatten van sessies berust. Bronnen: Speech to Speech · Voice API.

Server-sessiegebeurtenissen

Tijdens uw werk met de Voice Agent API houdt de server u via JSON-gebeurtenissen op de hoogte van de status van de sessie. De eerste gebeurtenissen die u ontvangt zijn session.created, zodra de verbinding tot stand komt, en conversation.created. Daarna volgt session.updated, na elke configuratie die u verzendt.

session.created

De server verzendt deze gebeurtenis automatisch zodra de WebSocket-verbinding opent. Volgens de referentie bevat deze de sessieconfiguratie, maar de velden worden niet gedetailleerd beschreven. In plaats van uit te gaan van standaardwaarden, logt u de gebeurtenis eenmaal om te zien wat de server retourneert, en verzendt u vervolgens uw eigen configuratie.

Wat te doen bij ontvangst van session.created

Uw applicatie moet:

  1. De gebeurtenis loggen, voor foutopsporing
  2. Onmiddellijk uw session.update verzenden met de gewenste configuratie
  3. De audiobuffer leegmaken die u hebt gevuld terwijl u op de verbinding wachtte

Het derde punt volgt uit het advies van xAI om de waargenomen latentie te verminderen: begin met het opnemen van de microfoon zodra het scherm opent, zonder te wachten op de verbinding, bewaar de samples in het geheugen en verzend ze zodra de verbinding gereed is en de configuratie is verzonden.

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

Deze gebeurtenis bevestigt uw session.update: de sessie is geconfigureerd. Voor sommige instellingen vermeldt de documentatie dat de toegepaste waarde hier wordt teruggestuurd, zoals bij de tabel voor uitspraakvervanging (replace). Een ongeldige configuratie wordt daarentegen geweigerd met een error-gebeurtenis die het probleem beschrijft; de sessie blijft open en behoudt zijn vorige configuratie.

De configuratie controleren

Vergelijk de geretourneerde waarden met de verzonden waarden: zo ontdekt u een instelling die is genegeerd.

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

De server verzendt ook een conversation.created-gebeurtenis, die het conversatie-ID bevat:

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

Bewaar dit ID: dit maakt het hervatten van sessies mogelijk. Standaard verliest een verbinding de conversatiegeschiedenis wanneer de WebSocket sluit. Als u "resumption": {"enabled": true} in session.update verzendt, cacheert de server elke beurt. Wanneer u opnieuw verbindt, opent u de WebSocket opnieuw met ?conversation_id=<id> en schakelt u hervatten opnieuw in: de vorige beurten worden afgespeeld voordat uw eerste nieuwe beurt plaatsvindt. De geschiedenis wordt verwijderd na 30 minuten inactiviteit.

De volledige opstartsequentie

Samenvattend is dit de volgorde van gebeurtenissen bij het starten van een voicesessie, zoals beschreven in de referentie:

  1. De WebSocket opent
  2. U ontvangt session.created (server → client)
  3. U ontvangt conversation.created (server → client)
  4. U verzendt session.update (client → server)
  5. U ontvangt session.updated (server → client)

Belangrijkste punten

  • session.created arriveert wanneer de verbinding opent en bevat de sessieconfiguratie, waarvan de velden niet gedetailleerd worden beschreven in de referentie
  • session.updated bevestigt uw configuratie; een ongeldige configuratie resulteert in een error-gebeurtenis
  • Neem audio op via de microfoon voordat de verbinding tot stand komt en maak de buffer leeg zodra deze gereed is
  • conversation.created bevat het conversation.id, dat u bewaart voor het hervatten van sessies
  • Hervatten vereist resumption.enabled bij elke verbinding en de geschiedenis verloopt na 30 minuten inactiviteit