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, bearbeiten Sie 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 sind dies nur Beispiele.
Wenn Sie einen Entwurf speichern, wird er in der Standardumgebung bereitgestellt. Wenn Sie spezifische Versionen erstellen, können Sie diese in benutzerdefinierten Umgebungen bereitstellen. Sie können eine Vielzahl von benutzerdefinierten 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
Verwenden Sie immer Versionen für Produktions-Traffic
Ein Entwurf 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 Entwurf 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 Versionen für Ihren Produktions-Traffic verwenden. Ressourcenentwürfe sollten getestet werden, bevor sie zu Produktionsversionen hochgestuft werden. Sie können ein Rollback zu einer vorherigen Version durchführen, falls Probleme auftreten.
Umgebungsspezifische Webhooks immer verwenden
Wenn Sie Änderungen an Ihrem Kundenservicemitarbeiter vornehmen, sind häufig abhängige Änderungen an Ihrem Webhook-Code erforderlich. Bei der Entwicklung und dem Testen dieser Änderungen sollten Sie Folgendes beachten:
- So testen Sie die Agent-Updates anhand der 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 Ihrer Produktionsumgebung ändern, während Sitzungen aktiv sind, kann das zu Kundenservicemitarbeiterfehlern bei einigen aktiven Sitzungen führen. 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.
Version in den Entwurf laden
Sie können eine Version 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.
Wenn Sie eine Playbook-Version im Entwurf wiederherstellen, wird das vorhandene Playbook im Entwurf und seine Beispiele überschrieben.
Versionen verwalten
So verwalten Sie Ihre Versionen:
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 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 Console.
- 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 auf 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 auf 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 |
| 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 auf 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 |
| 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.
Zum Auswählen von Ablauf- und Playbookversionen 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 | 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 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 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 Umgebung referenziert werden.
Console
Wenn Sie den Konsolensimulator verwenden, wählen Sie die Option Agent mit bestimmten Ablaufversionen testen und dann die Ablaufversionen aus.
API
Wenn Sie Workflowversionen für detectIntent, streamingDetectIntent, matchIntent und REST-Aufrufe von Sitzungsentitäten angeben möchten, geben Sie die ausgewählten Workflowversionen im Feld query_parameters.flow_versions der Anfrage an.