Einige Produkte und Funktionen werden umbenannt. Außerdem werden die Funktionen für generative Playbooks und Flows zu einer einzigen konsolidierten Konsole migriert.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Git-Export/-Wiederherstellung

Dialogflow CX lässt sich in mehrere Git-Anbieter (GitHub, Gitlab, Bitbucket usw.) einbinden. Durch diese Einbindung können Sie Ihren Agenten ganz einfach im JSON-Format exportieren, um ihn an einen Git-Anbieter zu übertragen, und von einem Git-Anbieter abrufen, um den Agenten wiederherzustellen. Das JSON-Exportformat, das an einen Git-Anbieter übertragen wird, ist der Inhalt der erweiterten ZIP-Datei des exportierten Agenten.

Mit dieser Funktion können Sie die Quellcodeverwaltungsfunktionen eines Git-Anbieters nutzen, z. B.:

Überprüfung von Agent-Änderungen mit Code Review-Tools
Agentenunterschiede mit Diff-Tools untersuchen
Zusammenführungen

Beschränkungen

Es gelten folgende Einschränkungen:

[Nur alte Integrationsversion] Bei GitHub-APIs ist die Anzahl der Dateien, die in einem einzelnen Commit aktualisiert werden können, begrenzt. Wenn die Anzahl der Dateien 500 überschreitet, können Sie möglicherweise nicht von Dialogflow CX zu GitHub übertragen. In solchen Fällen können Sie den Agenten als ZIP-Datei exportieren und die Git-CLI auf Ihrem Computer verwenden, um die Agentendateien an GitHub zu übertragen. Diese Einschränkung wird in einer späteren Dialogflow CX-Version behoben.
Private GitHub-Repositories mit selbst gehostetem Zugriff werden nicht unterstützt, da Dialogflow CX nicht auf diese Repositories zugreifen kann.
Das Git-Repository darf keine anderen Dateien als die Agent-Dateien enthalten, die durch den Agent-Export exportiert wurden. Alle anderen Dateien im Repository werden bei jedem Push entfernt.

Konfiguration

Wenn Sie diese Funktion konfigurieren möchten, müssen Sie ein Zugriffstoken von Ihrem Git-Anbieter abrufen, es in Secret Manager speichern und die Secret-Ressource für Dialogflow CX bereitstellen:

Zugriffstoken

So rufen Sie ein Zugriffstoken von Ihrem Git-Anbieter ab:

GitHub

Sie benötigen ein persönliches GitHub-Token. Wenn Sie ein detailliertes persönliches Zugriffstoken verwenden, benötigen Sie die folgenden Berechtigungen:

Repository-Berechtigungen > Inhalte: Lesen und Schreiben
Repository-Berechtigungen > Metadaten: Schreibgeschützt (sollte nach Auswahl der Berechtigung „Inhalte“ automatisch ausgewählt werden)

GitLab

Sie benötigen ein persönliches GitLab-Zugriffstoken.

Bitbucket

Sie benötigen ein Bitbucket-Zugriffstoken.

Secret Manager

Nachdem Sie ein Zugriffstoken haben, müssen Sie ein Secret für Ihr Token erstellen:

Dialogflow CX-Konfiguration

So konfigurieren Sie diese Integration für Dialogflow CX:

Gewähren Sie dem Dialogflow-Dienst-Agent die Berechtigung, auf das Zugriffstoken-Secret in Secret Manager zuzugreifen. Weisen Sie dem Dienstkonto gcp-sa-dialogflow.iam.gserviceaccount.com in Ihrem Agent-Projekt die Rolle Secret Manager Secret Accessor zu. Weitere Informationen finden Sie unter Zugriff auf Secret Manager-Secret gewähren.
Öffnen Sie die Konfiguration der Git-Integration:
- Conversational Agents-Konsole
  1. Öffnen Sie die Einstellungen, indem Sie oben rechts auf das Einstellungssymbol klicken.
  2. Scrollen Sie nach unten und klicken Sie auf Git-Integration hinzufügen.
- Dialogflow CX-Konsole
  1. Klicke auf den Tab Verwalten.
  2. Klicken Sie im Bereich Testen und Bereitstellen auf Git.
  3. Klicken Sie auf Neu erstellen.
Geben Sie die Konfigurationsdetails an:
1. Geben Sie Folgendes ein:
  - Anzeigename für die GitHub-Verbindung.
  - Git-Repository-URL (z. B. https://github.com/<path-to-repo>.git).
  - Fügen Sie Git-Zweige hinzu, mit denen Ihr Agent interagieren soll. Sie können einen Zweig als Standardzweig festlegen, indem Sie auf das Sternsymbol daneben klicken.
  - Secret des Zugriffstokens, d. h. die von Ihnen erstellte Secret-Version im Format projects/*/secrets/*/versions/* für eine bestimmte Version oder projects/*/secrets/*/versions/latest für die aktuelle Version.
2. Klicken Sie auf Verbinden.
3. Es kann eine Minute dauern, bis der Git-Dienst bereit ist. In der Console werden Benachrichtigungen angezeigt.

Push und Wiederherstellung

Nach der Konfiguration können Sie Ihren Agenten per Push/Pull an/von Git übertragen.

Mit dem Button Push können Sie Ihren Agenten exportieren und einen Commit für den Git-Zweig durchführen, der im Drop-down-Menü für Git-Zweige ausgewählt ist. Dieser Commit besteht aus dem gesamten Agenten und nicht aus bestimmten Änderungen. Alle vorhandenen Dateien im Repository werden gelöscht.

Nutzer mit der Rolle Dialogflow-Leser können Push-Vorgänge in Git-Repositories ausführen. Um unerwünschte Push-Vorgänge zu verhindern, konfigurieren Sie diese Agents mit schreibgeschützten persönlichen Zugriffstokens.

Mit der Schaltfläche Wiederherstellen werden Ihre Agentendaten aus dem Git-Zweig abgerufen, der im Drop-down-Menü „Git-Zweig“ ausgewählt ist, und Ihr Dialogflow CX-Agent wird aus diesen Daten wiederhergestellt. Dadurch wird Ihr Agent auf dieselbe Weise überschrieben wie bei jeder Agent-Wiederherstellung.

Anwendungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie diese Funktion von mehreren Personen verwendet werden kann, um einem Produktions-Agenten verschiedene Agentenänderungen vorzuschlagen.

Angenommen, Ihr Agent verwendet die folgenden Git-Zweige:

Prod: Zweig für Ihren Produktions-Agenten
Dev1: Zweig für die Agentenentwicklung
Dev2: ein weiterer Zweig für die Agentenentwicklung

Nutzer 1 möchte Änderungen am KI-Agenten vorschlagen und geht so vor:

Exportieren Sie den Produktions-Agenten in einen neuen Agenten.
Nehmen Sie die gewünschten Änderungen an dieser Kopie des KI-Agenten vor.
Änderungen testen
Übertragen Sie den geänderten KI-Agenten per Push in den Zweig Dev1.
Erstellen Sie eine Zusammenführungsanfrage für den Zweig Prod.

Nutzer 2 möchte Änderungen am Agenten vorschlagen und geht so vor:

Exportieren Sie den Produktions-Agenten in einen neuen Agenten.
Nehmen Sie die gewünschten Änderungen an dieser Kopie des KI-Agenten vor.
Änderungen testen
Übertragen Sie den geänderten Agenten per Push in den Zweig Dev2.
Erstellen Sie eine Zusammenführungsanfrage für den Zweig Prod.

Nutzer 3 prüft die Zusammenführungsanfragen beider Nutzer und führt die folgenden Schritte aus:

Konflikte lösen
Übernimmt genehmigte Änderungen.
Stellt den Git-Produktionszweig im Dialogflow CX-Produktions-Agenten wieder her.