Sitzungen

Eine Sitzung ist eine Unterhaltung zwischen einem Conversational Agents (Dialogflow CX)-Agent und einem Endnutzer. Zu Beginn einer Unterhaltung erstellen Sie eine Sitzung und verwenden diese für jede Unterhaltungsrunde. Sobald die Unterhaltung zu Ende ist, beenden Sie die Sitzung.

Für gleichzeitige Unterhaltungen mit verschiedenen Endnutzern sollten Sie nicht dieselbe Sitzung verwenden. Eine Sitzung bleibt aktiv und ihre Daten werden 30 Minuten nach dem Senden der letzten Anfrage für die Sitzung gespeichert.

Jeder Sitzung wird von Ihrem System eine eindeutige Sitzungs-ID zugewiesen. Sie erstellen eine neue Sitzung, indem Sie in einer Anfrage zur Intent-Erkennung und anderen Sitzungsmethoden eine neue Sitzungs-ID bereitstellen. Eine Sitzungs-ID besteht aus einem String mit höchstens 36 Byte. Die Verantwortung für das Erzeugen eindeutiger Sitzungs-IDs liegt bei Ihrem System. Dabei kann es sich um Zufallszahlen, um gehashte Endnutzer-IDs oder um alle erdenklichen anderen Werte handeln, die Sie bequem generieren können.

In der Dokumentation zur Regionalisierung finden Sie Informationen zum Standort-ID-Wert des Sitzungsnamens.

Lang andauernde Sitzungen

Standardmäßig speichert Conversational Agents (Dialogflow CX) die Sitzungsdaten 30 Minuten lang. Es gibt zwei Möglichkeiten, die Lebensdauer von Sitzungen zu verlängern:

  • (Bevorzugt) Legen Sie die Sitzungs-TTL mit QueryParameters.session_ttl fest. Der maximal zulässige Wert beträgt 24 Stunden.
  • Sie können den vorherigen Sitzungsstatus jedoch wiederherstellen, indem Sie QueryParameters.current_page und QueryParameters.parameters in DetectIntentRequest festlegen.

    Beispiel für einen Workflow:

    1. Der Endnutzer kommuniziert mit dem Agent unter Sitzung A.
    2. Der Code zeichnet den mit Sitzung A verknüpften Status auf, der in der API-Antwort zurückgegeben wurde, nämlich QueryResult.current_page und QueryResult.parameters.
    3. Der Endnutzer beendet die Interaktion mit dem Agent nach 50 Minuten.
    4. Der Endnutzer kommuniziert noch einmal mit dem Agent.
    5. Ihr Code sendet die Endnutzereingabe zusammen mit den zuvor aufgezeichneten QueryParameters.current_page und QueryParameters.parameters in der Anfrage, um einen Intent mit dem vorherigen Sitzungsstatus zu erkennen. Sie müssen nicht dieselbe Sitzungs-ID wie für Sitzung A verwenden.

Verweise

Informationen zu Preisen für Sitzungen finden Sie auf der Seite „Preise“.

Weitere Informationen zu Sitzungen finden Sie in der .

Wählen Sie ein Protokoll und eine Version für die Sitzungsreferenz aus:

Protokoll V3 V3beta1
REST Sitzungsressource Sitzungsressource
RPC Sitzungsschnittstelle Sitzungsschnittstelle
C++ SessionsClient Nicht verfügbar
C# SessionsClient Nicht verfügbar
Go SessionsClient Nicht verfügbar
Java SessionsClient SessionsClient
Node.js SessionsClient SessionsClient
PHP Nicht verfügbar Nicht verfügbar
Python SessionsClient SessionsClient
Ruby Nicht verfügbar Nicht verfügbar