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:
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Klicken Sie auf den Tab Verwalten.
- Klicken Sie auf Versionen.
- Die Agent-Abläufe werden aufgeführt. Wählen Sie eine Antwort aus.
- 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:
- Halten Sie den Mauszeiger über eine Versionszeile.
- Klicken Sie auf die Optionsschaltfläche more_vert.
- Klicken Sie auf die Option In Entwurf laden.
- Dabei ist eine Option zum Überschreiben der Daten auf Agent-Ebene beim Laden verfügbar.
So löschen Sie eine bestimmte Ablaufversion:
- Halten Sie den Mauszeiger über eine Versionszeile.
- Klicken Sie auf die Optionsschaltfläche more_vert.
- 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 |
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 |
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
- Halten Sie den Mauszeiger über eine Versionszeile.
- Klicken Sie auf die Optionsschaltfläche more_vert.
- Klicken Sie auf die Option Versionen vergleichen.
- Wählen Sie eine andere Ablaufversion oder einen Ablaufentwurf zum Vergleich aus.
- 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 |
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 |
Umgebungen verwalten
So verwalten Sie Agent-Umgebungen:
Console
So listen Sie die aktuellen Umgebungen für einen Agent auf:
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Klicken Sie auf den Tab Verwalten.
- Klicken Sie auf Umgebungen.
- 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 history "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 content_copy "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 delete "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 |
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 |
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.