Versionen und Umgebungen

Sie können mehrere Versionen von Agent-Abläufen erstellen und in separaten Bereitstellungsumgebungen bereitstellen.

Wenn Sie einen Ablauf bearbeiten, bearbeiten Sie einen Ablaufentwurf. Sie können Ablaufentwürfe jederzeit als Ablaufversion speichern. Eine Ablaufversion ist ein unveränderlicher Snapshot Ihrer Ablaufdaten und der zugehörigen Agent-Daten wie Intents, Entitäten, Webhooks, Seiten, Routengruppen usw.

Wenn Sie einen Ablaufentwurf speichern, wird er in der Standardumgebung bereitgestellt. Wenn Sie spezifische Ablaufversionen erstellen, können Sie diese in benutzerdefinierten Umgebungen bereitstellen. Sie können eine Vielzahl von benutzerdefinierten Umgebungen für folgende Zwecke erstellen:

  • Test
  • Entwicklung
  • Produktion
  • usw.

Darüber hinaus können Sie umgebungsspezifische Webhooks erstellen, sodass Sie Ihre Produktionsumgebung einfach von Entwicklungs- und Testumgebungen isolieren können.

Best Practices für den Produktionstraffic

Für Produktionstraffic immer Ablaufversionen verwenden

Ein Ablaufentwurf wird jedes Mal aktualisiert, wenn ein Entwickler in Ihrem Team eine Änderung vornimmt. Es kann leicht passieren, dass ein Ablaufentwurf aus Versehen unterbrochen wird, insbesondere wenn mehrere Personen Schreibzugriff auf den Agent haben. Darüber hinaus kann ein kürzlich bearbeiteter Ablaufentwurf möglicherweise nicht mit dem trainierten Modell übereinstimmen, da das Training verzögert sein kann oder eine manuelle Ausführung erfordert.

Sie sollten daher immer Ablaufversionen für Ihren Produktions-Traffic verwenden. Ablaufentwürfe sollten getestet werden, bevor sie zu Produktionsversionen hochgestuft werden. Sie können ein Rollback zu einer vorherigen Version durchführen, falls Probleme auftreten.

Immer umgebungsspezifische Webhooks verwenden

Wenn Sie den Agent aktualisieren, gibt es oft voneinander abhängige Updates am Webhook-Code. Wenn Sie diese Änderungen entwickeln und testen, möchten Sie:

  • Um die Agent-Updates mit den Webhook-Code-Updates zu testen.
  • Damit Sie den Webhook-Code erst in der Produktion bereitstellen, nachdem Sie die Tests abgeschlossen haben.

Mit umgebungsspezifischen Webhooks werden beide Ziele erreicht.

Mögliche Agent-Fehler beim Ändern der Versionen berücksichtigen

Wenn Sie eine Ablaufversion in Ihrer Produktionsumgebung ändern, während Sitzungen aktiv sind, können für einige aktive Sitzungen Agent-Fehler auftreten. Diese Fehler können auftreten, wenn die vorherige und die neue Version in einer Weise inkonsistent sind, dass der Sitzungsstatus unterbrochen wird. Aus diesem Grund sollten Sie Versionen zu Zeiten mit Ausfallzeiten oder außerhalb der Spitzenzeiten planen.

Eine Ablaufversion für einen Entwurf laden

Sie können eine Ablaufversion jederzeit als Entwurf laden, damit sie bearbeitet und von der Standardumgebung verwendet werden kann.

Durch das Laden einer Ablaufversion als Entwurf können mehrere Ressourcen in einem Agent aktualisiert werden, einschließlich Ressourcen auf Agent-Ebene wie Intents und Entitäten. Wenn Sie eine Version mit der Konsole oder der API als Entwurf laden, können Sie wählen, ob Ressourcen auf Agent-Ebene überschrieben werden sollen.

Ablaufversionen verwalten

So verwalten Sie Ablaufversionen:

Console

So listen Sie die aktuellen Versionen für einen Ablauf auf:

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr GCP-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Klicken Sie auf den Tab Verwalten.
  5. Klicken Sie auf Versionen.
  6. Die Agent-Abläufe werden aufgeführt. Wählen Sie eine Antwort aus.
  7. Die Versionen für den ausgewählten Ablauf werden aufgelistet.

Für jeden Ablauf werden folgende Informationen angezeigt:

  • Anzeigename: Der Anzeigename der Version.
  • Versions-ID: Die ID der Version.
  • NLU-Typ: Der NLU-Typ der Ablaufversion.
  • Zeitstempel der Erstellung: Datum und Uhrzeit der Erstellung der Version.
  • Status: Der Trainingsstatus. Eine Ablaufversion kann erst verwendet werden, wenn dafür der Status Bereit gilt.

Klicken Sie zum Erstellen einer neuen Ablaufversion auf die Schaltfläche Erstellen und geben Sie den Anzeigenamen und die Beschreibung für die Version an.

So laden Sie eine bestimmte Ablaufversion als Entwurf:

  1. Bewegen Sie den Mauszeiger auf eine Versionszeile.
  2. Klicken Sie auf die Schaltfläche .
  3. Klicken Sie auf die Option In Entwurf laden.
  4. Dabei ist eine Option zum Überschreiben der Daten auf Agent-Ebene beim Laden verfügbar.

So löschen Sie eine bestimmte Ablaufversion:

  1. Bewegen Sie den Mauszeiger auf eine Versionszeile.
  2. Klicken Sie auf die Schaltfläche .
  3. Klicken Sie auf die Option Version löschen.

API

Siehe die Methoden für den Typ Version.

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

Protokoll V3 V3beta1
REST Versionsressource Versionsressource
RPC Versionsoberfläche Versionsoberfläche
C++ VersionsClient Nicht verfügbar
C# VersionsClient Nicht verfügbar
Go VersionsClient Nicht verfügbar
Java VersionsClient VersionsClient
Node.js VersionsClient VersionsClient
PHP Nicht verfügbar Nicht verfügbar
Python VersionsClient VersionsClient
Ruby Nicht verfügbar Nicht verfügbar

Ablaufversionen vergleichen

Nachdem Sie Ablaufversionen erstellt haben, können Sie mit dem Tool Versionen vergleichen einen direkten Vergleich zwischen den Ablaufversionen oder der Entwurfsversion abrufen. So vergleichen Sie Versionen:

Console

  1. Bewegen Sie den Mauszeiger auf eine Versionszeile.
  2. Klicken Sie auf die Schaltfläche .
  3. Klicken Sie auf die Option Versionen vergleichen.
  4. Wählen Sie eine andere Ablaufversion oder einen Ablaufentwurf zum Vergleich aus.
  5. Ein direkter Vergleich wird angezeigt.

API

Siehe die Methode compareVersions für den Typ Version.

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

Protokoll V3 V3beta1
REST Versionsressource Versionsressource
RPC Versionsoberfläche Versionsoberfläche
C++ VersionsClient Nicht verfügbar
C# VersionsClient Nicht verfügbar
Go VersionsClient Nicht verfügbar
Java VersionsClient VersionsClient
Node.js VersionsClient VersionsClient
PHP Nicht verfügbar Nicht verfügbar
Python VersionsClient VersionsClient
Ruby Nicht verfügbar Nicht verfügbar

Umgebungen verwalten

So verwalten Sie Agent-Umgebungen:

Console

So listen Sie die aktuellen Umgebungen für einen Agent auf:

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr GCP-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Klicken Sie auf den Tab Verwalten.
  5. Klicken Sie auf Umgebungen.
  6. Die Agent-Umgebungen werden aufgelistet.

Klicken Sie zum Erstellen einer neuen Umgebung auf die Schaltfläche Erstellen und geben Sie die erforderlichen Informationen an.

Zum Auswählen von Ablaufversionen und zum Konfigurieren einer Umgebung klicken Sie auf eine Umgebung und geben dort Informationen ein.

Klicken Sie rechts neben einer Umgebung in der Liste auf die Schaltfläche "Verlauf", um den Änderungsverlauf der Umgebung anzuzeigen.

Klicken Sie zum Kopieren des Namens der Umgebungsressource, die die Umgebungs-ID enthält, auf die Schaltfläche "Kopieren" rechts neben der relevanten Umgebung in der Liste.

Klicken Sie zum Löschen einer Umgebung in der Liste rechts neben der relevanten Umgebung auf die Schaltfläche "Löschen".

API

Siehe die Methoden für den Typ Environment.

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

Protokoll V3 V3beta1
REST Umgebungsressource Umgebungsressource
RPC Umgebungsoberfläche Umgebungsoberfläche
C++ EnvironmentsClient Nicht verfügbar
C# EnvironmentsClient Nicht verfügbar
Go EnvironmentsClient Nicht verfügbar
Java EnvironmentsClient EnvironmentsClient
Node.js EnvironmentsClient EnvironmentsClient
PHP Nicht verfügbar Nicht verfügbar
Python EnvironmentsClient EnvironmentsClient
Ruby Nicht verfügbar Nicht verfügbar

Umgebung für Sitzungsaufrufe festlegen

Mit dem Konsolensimulator oder der API können Sie beim Ausführen von Laufzeitsitzungsaufrufen eine Umgebung angeben. Ist keine Umgebung angegeben, wird die Standardumgebung verwendet.

Console

Wählen Sie bei Verwendung des Konsolensimulators die Option Test-Agent in Umgebung und dann eine Umgebung aus.

API

Zum Festlegen einer Umgebung für REST-Aufrufe der Typen detectIntent, streamingDetectIntent, matchIntent und Sitzungsentität; ändern Sie die URL, indem Sie environments/environment-id zwischen den Pfadparametern agent und sessions einfügen.

Die folgende URL verwendet beispielsweise die Umgebungs-ID 6db409d7-57ac-41d7-83bd-89b8768e2745:

https://dialogflow.googleapis.com/v3/projects/my-project-id/locations/us/agents/my-agent-id/environments/6db409d7-57ac-41d7-83bd-89b8768e2745/sessions/my-session-id:detectIntent

Ablaufversionen für Sitzungsaufrufe angeben

Sie können entweder mit dem Konsolensimulator oder der API eine Reihe von Ablaufversionen beim Ausführen von Laufzeitsitzungsaufrufen angeben. Auf die ausgewählten Ablaufversionen muss in keiner Umgebung verwiesen werden.

Console

Wählen Sie bei Verwendung des Konsolensimulators die Option Test-Agent mit bestimmten Ablaufversionen und dann Ablaufversionen aus.

API

Geben Sie die Ablaufversionen für detectIntent-, streamingDetectIntent-, matchIntent- und Sitzungsentität-REST-Aufrufe an. Geben Sie im Feld query_parameters.flow_versions der Anfrage die gewünschten Ablaufversionen an.