Der Begriff Sitzung steht für eine Unterhaltung zwischen einem Dialogflow-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 Dialogflow die Sitzungsdaten 30 Minuten lang. Es gibt zwei Möglichkeiten, die Lebensdauer von Sitzungen zu verlängern:
- (Bevorzugt) Legen Sie die TTL der Sitzung mit
QueryParameters.session_ttlfest. Der maximal zulässige Wert beträgt 24 Stunden. Sie können den vorherigen Sitzungsstatus wiederherstellen, indem Sie
QueryParameters.current_pageundQueryParameters.parametersinDetectIntentRequestfestlegen.Beispiel für einen Workflow:
- Der Endnutzer kommuniziert mit dem Agent unter Sitzung A.
- Der Code zeichnet den mit Sitzung A verknüpften Status auf, der in der API-Antwort zurückgegeben wurde, nämlich
QueryResult.current_pageundQueryResult.parameters. - Der Endnutzer beendet die Interaktion mit dem Agent nach 50 Minuten.
- Der Endnutzer kommuniziert noch einmal mit dem Agent.
- Ihr Code sendet die Endnutzereingabe zusammen mit den zuvor aufgezeichneten
QueryParameters.current_pageundQueryParameters.parametersin 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 | Sitzungsoberfläche | Sitzungsoberfläche |
| C++ | SessionsClient | Nicht verfügbar |
| C# | SessionsClient | Nicht verfügbar |
| Einfach loslegen (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 |