Sie können mehrere Versionen Ihrer Agent-Abläufe und Playbooks (auch als Vertex AI-Agents bezeichnet) erstellen und in separaten Bereitstellungsumgebungen bereitstellen.
Wenn Sie einen Ablauf oder ein Playbook bearbeiten, Sie bearbeiten den Entwurf. Sie können den Entwurf jederzeit als Version speichern. Eine Version ist ein unveränderlicher Snapshot Ihrer Ablauf- oder Playbook-Daten und der zugehörigen Kundenservicemitarbeiterdaten. Bei Abläufen sind das Intents, Entitäten, Webhooks, Seiten und Routengruppen. Bei Playbooks beinhaltet dies Folgendes: nur Beispiele.
Wenn Sie einen Entwurf speichern, wird er in der Standardumgebung bereitgestellt. Wenn Sie bestimmte Versionen erstellen, können Sie sie in benutzerdefinierten Umgebungen bereitstellen. Sie können verschiedene benutzerdefinierte Umgebungen erstellen, z. B.:
- testen
- Entwicklung
- Produktion
Außerdem können Sie umgebungsspezifische Webhooks erstellen, um Ihre Produktionsumgebung von Entwicklungs- und Testumgebungen zu isolieren.
Best Practices für Produktionstraffic
Immer Versionen für Produktionstraffic verwenden
Ein Entwurf wird jedes Mal aktualisiert, wenn ein Entwickler in Ihrem Team eine Änderung vornimmt. Es ist möglich, dass ein Entwurf unbeabsichtigt zerstört wird, vor allem, wenn mehrere Personen Schreibzugriff auf den Agent haben. Ein kürzlich bearbeiteter Entwurf können mit dem trainierten Modell nicht übereinstimmen, da das Training verzögert ist oder manuell ausgeführt werden muss.
Für Ihren Produktionstraffic sollten Sie immer Versionen verwenden. Entwurfsressourcen sollten getestet werden, bevor sie zu Produktionsversionen hochgestuft werden. und Sie können ein Rollback zu einer vorherigen Version durchführen, falls Probleme auftreten.
Immer umgebungsspezifische Webhooks verwenden
Wenn Sie Ihren Agent aktualisieren, oft voneinander abhängig sind. Bei der Entwicklung und dem Testen dieser Änderungen sollten Sie Folgendes beachten:
- Zum Testen der Agent-Updates mit den Webhook-Code-Updates.
- Sie sollten Ihren Webhook-Code erst dann in der Produktionsumgebung bereitstellen, wenn Sie die Tests abgeschlossen haben.
Mit umgebungsspezifischen Webhooks lassen sich beide Ziele erreichen.
Mögliche Fehler beim Ändern der Versionen
Wenn Sie eine Version in der Produktionsumgebung ändern während die Sitzungen aktiv sind, kann es bei einigen aktiven Sitzungen zu Kundenservice-Fehlern kommen. Diese Fehler können auftreten, wenn die vorherige und die neue Version nicht miteinander übereinstimmen und dadurch der Sitzungsstatus gestört wird. Daher sollten Sie die Versionen während der Ruhezeit oder außerhalb der Stoßzeiten ä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. Dieses Feature ist noch nicht für Playbooks verfügbar.
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.
Versionen verwalten
So verwalten Sie Ihre Versionen:
Console
So listen Sie die aktuellen Versionen für einen Ablauf auf:
- Öffnen Sie die Dialogflow CX-Konsole.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Klicken Sie auf den Tab Gemeinsam genutzte Ressourcen.
- 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.
So listen Sie die aktuellen Versionen für ein Playbook auf:
- Öffnen Sie die Dialogflow CX-Konsole.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Playbook auswählen
- Klicken Sie auf Versionsverlauf.
- Klicken Sie auf Versionsverlauf ansehen.
- Die Versionen für das ausgewählte Playbook werden aufgelistet.
Für jede Ressource 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 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:
- Halten Sie den Mauszeiger über eine Versionszeile.
- Klicken Sie auf die Option. Schaltflä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 Option. Schaltflä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 |
| 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
- Halten Sie den Mauszeiger über eine Versionszeile.
- Klicken Sie auf die Option. Schaltflä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 |
| 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 Gemeinsam genutzte Ressourcen.
- 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.
Um Ablauf- und Playbook-Versionen auszuwählen und eine Umgebung zu konfigurieren, auf eine Umgebung klicken und Informationen angeben.
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 | 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
Mit dem Console-Simulator oder der API können Sie beim Aufrufen von Laufzeitsitzungen eine Umgebung angeben. 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
Wenn Sie eine Umgebung für REST-Aufrufe von detectIntent, streamingDetectIntent, matchIntent und Sitzungsentitäten angeben möchten, ändern Sie die URL, indem Sie environments/environment-id zwischen den Pfadparametern agent und sessions einfügen.
In der folgenden URL wird beispielsweise 6db409d7-57ac-41d7-83bd-89b8768e2745 verwendet.
Umgebungs-ID:
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 Console-Simulator oder der API können Sie beim Aufrufen von Laufzeitsitzungen eine Reihe von Ablaufversionen angeben. Die ausgewählten Ablaufversionen müssen nicht unbedingt in einer beliebigen Umgebung referenziert wird.
Console
Wenn Sie den Konsolensimulator verwenden, die Option Agent mit bestimmten Ablaufversionen testen aus. Wählen Sie dann Ablaufversionen aus.
API
Zum Angeben von Ablaufversionen für detectIntent, streamingDetectIntent,
matchIntent und Sitzungsentität REST-Aufrufe;
stellen Sie die ausgewählten Ablaufversionen in query_parameters.flow_versions bereit
der Anfrage.