Einige Produkte und Funktionen werden derzeit umbenannt. Auch die Funktionen für generative Playbooks und Abläufe werden zu einer einzigen konsolidierten Console migriert. Weitere Informationen

Diese Seite wurde von der Cloud Translation API übersetzt.

Git-Export/-Wiederherstellung

Konversations-Agents (Dialogflow CX) können mit mehreren Git-Anbietern (z. B. GitHub, GitLab und Bitbucket) integriert werden. Mit dieser Integration können Sie Ihren Bot ganz einfach in JSON exportieren, um ihn bei einem Git-Anbieter bereitzustellen, und ihn von einem Git-Anbieter abrufen, um ihn wiederherzustellen. Das JSON-Exportformat, das an einen Git-Anbieter gepusht wird, ist der entpackte Inhalt der ZIP-Datei des exportierten Agents.

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

Überprüfung von Änderungen an Kundenservicemitarbeitern mithilfe von Code-Review-Tools
Mit Differenztools Agenten-Differenzen prüfen
Zusammenführungen

Beschränkungen

Es gelten folgende Einschränkungen:

[Nur alte Integrationsversion] Die GitHub APIs haben eine Beschränkung für die Anzahl der Dateien, die in einem einzelnen Commit aktualisiert werden können. Wenn die Anzahl der Dateien 500 übersteigt, können Sie möglicherweise nicht von Conversational Agents (Dialogflow CX) aus auf GitHub pushen. In solchen Fällen können Sie den Agenten als ZIP-Datei exportieren und die Agentendateien mit der Git-Befehlszeile auf Ihrem Computer auf GitHub pushen. Diese Einschränkung wird in einer späteren Version für Konversations-Agenten (Dialogflow CX) behoben.
Selbst gehostete Repositories mit privatem Zugriff auf GitHub werden nicht unterstützt, da Conversational Agents (Dialogflow CX) nicht auf diese Repositories zugreifen können.
Das Git-Repository darf keine anderen Dateien als die vom Agentenexport exportierten Agentendateien enthalten. 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 Conversational Agents (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: Nur-Lesen (sollte automatisch ausgewählt werden, nachdem die Berechtigung „Inhalte“ ausgewählt wurde)

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:

Konfiguration von Conversational Agents (Dialogflow CX)

So konfigurieren Sie diese Integration für Conversational Agents (Dialogflow CX):

Gewähren Sie dem Dialogflow-Dienst-Agent Zugriff auf Secret Manager. Weisen Sie dem Dienstkonto gcp-sa-dialogflow.iam.gserviceaccount.com in Ihrem Kundenservicemitarbeiterprojekt die Rolle Secret Manager Secret Accessor zu. Weitere Informationen finden Sie unter IAM-Rolle erteilen.
Öffnen Sie die Konfiguration der Git-Integration:
- Konversations-Agenten-Konsole
  1. Öffnen Sie die Einstellungen, indem Sie rechts oben 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 Abschnitt Testing & Deployment (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-Branches hinzu, mit denen Ihr Kundenservicemitarbeiter interagieren wird. Sie können einen Branch als Standard-Branch festlegen, indem Sie neben ihm auf das Sternsymbol klicken.
  - Das Secret für das Zugriffstoken, also die Secret-Version, die Sie im Format projects/*/secrets/*/versions/* für eine bestimmte Version oder projects/*/secrets/*/versions/latest für die neueste Version erstellt haben.
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 zu/von Git pushen/pullen.

Über die Schaltfläche Push können Sie Ihren Agenten exportieren und einen Commit für den im Drop-down-Menü „Git-Branch“ ausgewählten Git-Branch ausführen. Dieser Commit besteht aus dem gesamten Agenten und nicht aus bestimmten Änderungen. Außerdem werden alle vorhandenen Dateien im Repository gelöscht.

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

Über die Schaltfläche Wiederherstellen können Sie die Agent-Daten aus dem im Drop-down-Menü „Git-Branch“ ausgewählten Git-Branch abrufen und Ihren Conversational Agent (Dialogflow CX) anhand dieser Daten wiederherstellen. Dadurch wird Ihr Agent auf die gleiche Weise überschrieben wie bei jeder Agentwiederherstellung.

Anwendungsbeispiel

Im folgenden Beispiel wird gezeigt, wie diese Funktion von mehreren Personen verwendet werden kann, um einem Produktionsmitarbeiter verschiedene Änderungen vorzuschlagen.

Angenommen, Ihr Agent verwendet die folgenden Git-Zweigstellen:

Prod: Branch für deinen Produktions-Agenten
Dev1: Branch für die Entwicklung von Kundenservicemitarbeitern
Dev2: ein weiterer Branch für die Entwicklung von Kundenservicemitarbeitern

Nutzer 1 möchte Änderungen an einem Kundenservicemitarbeiter vorschlagen und führt dazu die folgenden Schritte aus:

Exportieren Sie den Produktions-Agenten in einen neuen Agenten.
Nehmen Sie die gewünschten Änderungen an diesem Kundenservicemitarbeiter-Text vor.
Testen Sie die Änderungen.
Übertragen Sie den geänderten Agenten auf den Dev1-Zweig.
Erstellen Sie einen Zusammenführungsantrag für den Prod-Zweig.

Nutzer 2 möchte Änderungen an einem Kundenservicemitarbeiter vorschlagen und führt dazu die folgenden Schritte aus:

Exportieren Sie den Produktions-Agenten in einen neuen Agenten.
Nehmen Sie die gewünschten Änderungen an diesem Kundenservicemitarbeiter-Text vor.
Testen Sie die Änderungen.
Übertragen Sie den geänderten Agenten per Push auf den Dev2-Zweig.
Erstellen Sie einen Zusammenführungsantrag für den Prod-Zweig.

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

Konflikte beheben.
Genehmigte Änderungen werden übernommen.
Der Produktions-Git-Branch wird im Produktions-Konversations-Agenten (Dialogflow CX) wiederhergestellt.