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, um Ihre Produktionsumgebung von Entwicklungs- und Testumgebungen zu isolieren.

Best Practices für Produktionstraffic

Immer Ablaufversionen für Produktionstraffic 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

Bei der Aktualisierung eines Agents müssen Sie häufig voneinander unabhängige Aktualisierungen des Webhook-Codes vornehmen. Während der Entwicklung und des Testens dieser Änderungen benötigen Sie Folgendes:

• Testen der Agent-Aktualisierungen anhand der Webhook-Codeaktualisierungen.
• So vermeiden Sie, dass Webhook-Code für die Produktion bereitgestellt wird, bis Sie die Tests abgeschlossen haben.

Mit umgebungsspezifischen Webhooks können beide Ziele erreicht werden.

Mögliche Agent-Fehler beim Versionswechsel berücksichtigen

Wenn Sie eine Ablaufversion 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 so uneinheitlich sind, dass der Sitzungsstatus unterbrochen wird. Aus diesem Grund sollten Sie Versionen während oder außerhalb der Spitzenzeiten ändern.

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 Google Cloud-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. Halten Sie den Mauszeiger über eine Versionszeile.
2. Klicken Sie auf die Optionsschaltflä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. Halten Sie den Mauszeiger über eine Versionszeile.
2. Klicken Sie auf die Optionsschaltfläche .
3. Klicken Sie auf die Option Version löschen.

API

Siehe die Methoden für den Typ Version. Referenz zur Version API-Referenz aufrufen

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
Einfach loslegen (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

Schließen

Hinweis: Die Methode load hat das Feld allowOverrideAgentResources, mit dem gesteuert werden kann, ob Ressourcen auf Agent-Ebene überschrieben werden, wenn ein Ablauf als Ablaufentwurf wiederhergestellt wird.

Hinweis: Wenn Sie zum Löschen einer Version die Methode delete aufrufen, müssen Sie zuerst alle Verweise auf die Version in Umgebungsdaten entfernen.

Ablaufversionen vergleichen

Hinweis: Die Antwortgröße für Versionen vergleichen ist auf 2 MB begrenzt. Verwenden Sie die REST API-Methode, um diese Einschränkung zu umgehen.

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. Halten Sie den Mauszeiger über eine Versionszeile.
2. Klicken Sie auf die Optionsschaltflä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. Version API-Referenz aufrufen

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
Einfach loslegen (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

Schließen

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 Google Cloud-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. Rufen Sie die Umgebung zur API-Referenz auf

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
Einfach loslegen (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

Schließen

Hinweis: Verwenden Sie 0 als Versions-ID des Ablaufs, um auf einen Ablaufentwurf zu verweisen.

Umgebung für Sitzungsaufrufe angeben

Sie können entweder mit dem Konsolensimulator oder der API eine Umgebung angeben, wenn Sie Laufzeitsitzungsaufrufe ausführen. Ist keine Umgebung angegeben, wird die Standardumgebung verwendet.

Console

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

API

Wenn Sie eine Umgebung für detectIntent, streamingDetectIntent, matchIntent und REST-Aufrufe von Sitzungsentitäten angeben möchten, ändern Sie die URL. Fügen Sie dazu environments/environment-id zwischen den Pfadparametern agent und sessions ein.

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

Mit dem Konsolensimulator oder der API können Sie eine Reihe von Ablaufversionen angeben, wenn Sie Laufzeitsitzungsaufrufe ausführen. Auf die ausgewählten Ablaufversionen muss nicht unbedingt in einer Umgebung verwiesen werden.

Console

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

API

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