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. 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#	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

Schließen

Hinweis: Die Methode load enthält ein allowOverrideAgentResources-Feld, mit dem sich steuern lässt, ob Ressourcen auf Agent-Ebene beim Wiederherstellen eines Ablaufs als Ablaufentwurf überschrieben werden.

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

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. 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	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

Schließen

Hinweis: Verwenden Sie 0 als Ablaufversions-ID, um auf einen Entwurfsablauf zu verweisen.

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.