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 einen Entwurf eines Ablaufs 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 bestimmte 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.

Produktionstraffic

Ein Entwurf wird immer dann aktualisiert, wenn ein Entwickler in Ihrem Team Änderungen vornimmt. Es ist einfach, einen Entwurfsablauf unbeabsichtigt aufzuheben, insbesondere wenn mehrere Personen Schreibzugriff auf den Agent haben. Darüber hinaus kann ein kürzlich bearbeiteter Entwurfsablauf mit dem trainierten Modell uneinheitlich sein, da das Training verzögert sein kann oder eine manuelle Ausführung erforderlich ist.

Sie sollten immer Ablaufversionen für Ihren Produktionstraffic verwenden. Entwurfsabläufe sollten getestet werden, bevor sie zu Produktionsversionen hochgestuft werden. Sie können ein Rollback zu einer vorherigen Version durchführen, falls Probleme festgestellt werden.

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 angezeigte Name der Version.
  • Versions-ID: die ID der Version
  • NLU-Typ: Der NLU-Typ der Ablaufversion.
  • Erstellungszeitstempel: Datum und Uhrzeit der Erstellung der Version.
  • Status: Der Trainingsstatus. Eine Ablaufversion ist erst dann einsatzbereit, wenn der Status als Bereit gekennzeichnet ist.

Klicken Sie zum Erstellen einer neuen Ablaufversion auf die Schaltfläche Create und geben Sie für die Version den Display name und die Description an.

Wenn Sie eine bestimmte Ablaufversion als Entwurf laden möchten, klicken Sie auf die Ladeschaltfläche rechts neben einer Version in der Liste. Dabei ist eine Option zum Überschreiben der Daten auf Agent-Ebene beim Laden verfügbar.

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

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# Nicht verfügbar Nicht verfügbar
Go Nicht verfügbar 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 Create (Erstellen) und geben Sie 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 Umgebungsschnittstelle Umgebungsschnittstelle
C# Nicht verfügbar Nicht verfügbar
Go Nicht verfügbar 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

Die Umgebung für Laufzeitsitzungsaufrufe angeben

Sie können eine Umgebung für Laufzeitsitzungsaufrufe wie detectIntent, streamingDetectIntent, matchIntent, und für Sitzungsentitätsaufrufe angeben. Um eine Umgebung zu bestimmen, ändern Sie die Endpunkt-URL, indem Sie environments/environment-id zwischen den Pfadparametern agent und sessions einfügen.

Folgender Endpunkt verwendet beispielsweise die Umgebungs-ID 6db409d7-57ac-41d7-83bd-89b8768e2745:

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

Ist keine Umgebung angegeben, wird die Standardumgebung verwendet.