Versionen und Umgebungen

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

Wenn Sie einen Ablauf, ein Playbook oder ein Tool bearbeiten, bearbeiten Sie den Entwurf. Sie können den Entwurf jederzeit als Version speichern. Eine Version ist ein unveränderlicher Snapshot Ihrer Ablauf-, Playbook- oder Tool-Daten und der zugehörigen Agent-Daten. Bei Abläufen umfasst dies Intents, Entitäten, Webhooks, Seiten und Routengruppen. Bei Playbooks sind nur Beispiele enthalten.

Wenn Sie einen Entwurf speichern, wird er in der Standardumgebung bereitgestellt. Wenn Sie spezifische Versionen erstellen, können Sie diese in benutzerdefinierten Umgebungen bereitstellen. Sie können eine Vielzahl von benutzerdefinierten Umgebungen erstellen, z. B.:

  • testen
  • Entwicklung
  • Produktion

Außerdem können Sie umgebungsspezifische Webhooks erstellen, um Ihre Produktionsumgebung von Entwicklungs- und Testumgebungen zu trennen.

Best Practices für Produktionstraffic

Immer Versionen für Produktions-Traffic verwenden

Ein Entwurf wird jedes Mal aktualisiert, wenn ein Entwickler in Ihrem Team eine Änderung vornimmt. Es kann leicht passieren, dass ein Entwurf aus Versehen unterbrochen wird, insbesondere wenn mehrere Personen Schreibzugriff auf den Agent haben. Darüber hinaus kann ein kürzlich bearbeiteter Entwurf 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 Versionen für Ihren Produktions-Traffic verwenden. Ressourcenentwü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 Ihren Agent aktualisieren, müssen Sie häufig auch Ihren Webhook-Code aktualisieren. Während der Entwicklung und des Testens dieser Änderungen sollten Sie Folgendes beachten:

  • So testen Sie die Agent-Updates anhand der Webhook-Code-Updates.
  • So vermeiden Sie, dass Ihr Webhook-Code in der Produktionsumgebung bereitgestellt wird, bevor Sie die Tests abgeschlossen haben.

Mit umgebungsspezifischen Webhooks können Sie beide Ziele erreichen.

Mögliche Agent-Fehler beim Ändern von Versionen

Wenn Sie eine Version in Ihrer Produktionsumgebung ändern, während Sitzungen aktiv sind, kann dies bei einigen aktiven Sitzungen zu Agent-Fehlern führen. Diese Fehler können auftreten, wenn die vorherige und die neue Version in einer Weise voneinander abweichen, die den Sitzungsstatus beeinträchtigt. Daher sollten Sie Versionsänderungen während Ausfallzeiten oder außerhalb von Spitzenzeiten planen.

Version in Entwurf laden

Sie können eine Version 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.

Wenn Sie eine Playbook-Version in den Entwurf zurücksetzen, wird das vorhandene Playbook im Entwurf mit seinen Beispielen überschrieben. Wenn Sie ein Tool wiederherstellen, wird das vorhandene Tool im Entwurf überschrieben.

Versionen verwalten

So verwalten Sie Ihre Versionen:

Console

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

  1. Öffnen Sie die Dialogflow CX-Konsole.
  2. Wählen Sie Ihr Google Cloud Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Klicken Sie auf den Tab Geteilte Ressourcen.
  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.

So listen Sie die aktuellen Versionen für ein Playbook auf:

  1. Öffnen Sie die Dialogflow CX-Konsole.
  2. Wählen Sie Ihr Google Cloud Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Playbook auswählen
  5. Klicken Sie auf Versionsverlauf.
  6. Klicken Sie auf Versionsverlauf ansehen.
  7. Die Versionen für das ausgewählte Playbook werden aufgelistet.

So listen Sie die aktuellen Versionen für ein Tool auf:

  1. Öffnen Sie die Dialogflow CX-Konsole.
  2. Wählen Sie Ihr Google Cloud Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Tool auswählen
  5. Klicken Sie auf Versionsverlauf.
  6. Klicken Sie auf Versionsverlauf ansehen.
  7. Die Versionen für das ausgewählte Tool werden aufgelistet.

Für jede Ressource werden die folgenden 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 Version 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 Option .
  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 Option .
  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. Diese Funktion ist für Playbooks nicht verfügbar. So vergleichen Sie Versionen:

Console

  1. Bewegen Sie den Mauszeiger auf eine Versionszeile.
  2. Klicken Sie auf die Option .
  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-Konsole.
  2. Wählen Sie Ihr Google Cloud Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Klicken Sie auf den Tab Geteilte Ressourcen.
  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 Ablauf-, Playbook- und Toolversionen 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 Umgebungsschnittstelle Umgebungsschnittstelle
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 angeben

Sie können entweder den Konsolensimulator oder die API verwenden, um bei Laufzeitsitzungsaufrufen eine Umgebung anzugeben. Ist keine Umgebung angegeben, wird die Standardumgebung verwendet.

Console

Wenn Sie den Konsolensimulator verwenden, wählen Sie die Option Agent in Umgebung testen und dann eine Umgebung aus.

API

Um eine Umgebung für detectIntent-, streamingDetectIntent-, matchIntent- und Sitzungsentitäts-REST-Aufrufe anzugeben, ändern Sie die URL, indem Sie environments/environment-id zwischen den Pfadparametern agent und sessions einfügen.

In der folgenden URL wird beispielsweise die Umgebungs-ID 6db409d7-57ac-41d7-83bd-89b8768e2745 verwendet:

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 den Konsolensimulator oder die API verwenden, um bei Laufzeitsitzungsaufrufen eine Reihe von Flow-Versionen anzugeben. Die ausgewählten Ablaufversionen müssen nicht unbedingt in einer Umgebung referenziert werden.

Console

Wenn Sie den Konsolensimulator verwenden, wählen Sie die Option Test agent with specific flow versions (Agent mit bestimmten Flow-Versionen testen) aus und wählen Sie dann die Flow-Versionen aus.

API

Wenn Sie Flow-Versionen für detectIntent-, streamingDetectIntent-, matchIntent- und Sitzungsentitäts-REST-Aufrufe angeben möchten, geben Sie die ausgewählten Flow-Versionen im Feld query_parameters.flow_versionsdetectIntentstreamingDetectIntentmatchIntentquery_parameters.flow_versions der Anfrage an.

Zurück
Mehrere Projekte verwenden
Weiter
Ebenen der Datenanwendung