Anwendungsserver bereitstellen

In dieser Anleitung werden die Schritte zum Einrichten eines Anwendungsservers beschrieben, mit dem Sie Agent Assist-Vorschläge in LivePerson rendern können. Der Anwendungsserver wird mit einem Proxyserver im selben Verzeichnis verwendet. Eine Anleitung zum Rendern der UI-Module im Kundenservicemitarbeiterbereich finden Sie auf der Hauptseite der LivePerson-Anleitung. Sowohl ein Anwendungsserver als auch ein Proxyserver sind erforderlich, damit Sie die Module in LivePerson rendern können.

Diese Integration kann auf jeder Hostingplattform eingerichtet werden. In dieser Anleitung wird jedoch Cloud Run von Google verwendet.

Konfiguration

Wenn Sie den Dienst bereitstellen, müssen Sie die folgenden Umgebungsvariablen definieren. Lassen Sie die Variablen LP_CLIENT_ID und LP_CLIENT_SECRET beim Erstellen des Anwendungsservers leer. Diese Variablen werden von LivePerson bereitgestellt, wenn Sie eine Conversational Cloud-Anwendung erstellen. Sie aktualisieren sie dann. Außerdem überspringen Sie APPLICATION_SERVER_URL und DF_PROXY_SERVER_URL. Beide Variablen werden festgelegt, nachdem die Anwendung und die Proxyserver bereitgestellt und die erforderlichen URL-Werte zurückgegeben wurden.

  • LP_ACCOUNT_ID: LivePerson-Konto-ID.
  • LP_CLIENT_ID: Ihre LivePerson-Kundennummer. Diese wird von LivePerson bereitgestellt, sobald die Conversational Cloud-Anwendung installiert wurde. (Überspringen Sie diese Variable vorerst. Sie aktualisieren sie, sobald die Informationen vorliegen.)
  • LP_CLIENT_SECRET: Ihr LivePerson-Clientschlüssel. Diese wird von LivePerson bereitgestellt, sobald die Conversational Cloud-Anwendung installiert wurde. (Überspringen Sie diese Variable vorerst. Sie aktualisieren sie, sobald die Informationen vorliegen.)
  • LP_SENTINEL_DOMAIN: Rufen Sie https://developers.liveperson.com/domain-api.html auf. Geben Sie Ihre Kontonummer ein und suchen Sie in der Domain nach „sentinel“.
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: Rufen Sie https://developers.liveperson.com/domain-api.html auf. Geben Sie Ihre Kontonummer ein und suchen Sie in der Domain nach „accountConfigReadOnly“.
  • APPLICATION_SERVER_URL: URL des UI-Anwendungsservers. (Überspringen Sie diesen Schritt vorerst und aktualisieren Sie ihn, nachdem der Anwendungsserver bereitgestellt wurde und Sie seine URL kennen.)
  • DF_PROXY_SERVER_URL: Die URL des Proxyservers. (Überspringen Sie diesen Schritt vorerst und aktualisieren Sie ihn, nachdem der Proxyserver bereitgestellt wurde und Sie seine URL kennen.)
  • PROJECT_ID: Ihre Google Cloud-Projekt-ID. Geben Sie nicht das Präfix projects/ an.

Beispieldatei .env:

    LP_ACCOUNT_ID = 12345678
    LP_CLIENT_ID = abc-123-f0f0
    LP_SENTINEL_DOMAIN = va.sentinel.liveperson.net
    LP_ACCOUNT_CONFIG_READONLY_DOMAIN = z1.acr.liveperson.net
    LP_CLIENT_SECRET = abc123abc123abc123abc123
    APPLICATION_SERVER_URL = https://my-project.wm.r.appspot.com
    DF_PROXY_SERVER_URL = https://proxy-server-dot-my-project.wm.r.appspot.com
    PROJECT_ID = my-project

Bereitstellen

Der UI-Anwendungsserver muss in einem Google Cloud-Hostingdienst bereitgestellt werden. Wir empfehlen die Verwendung der Google App Engine oder von Cloud Run. In den folgenden Schritten wird Cloud Run als Beispiel verwendet.

gcloud CLI einrichten

Für die in dieser Anleitung beschriebenen Bereitstellungsprozesse werden gcloud CLI-Befehle verwendet. Führen Sie die folgenden Schritte aus, um die gcloud CLI lokal für diese Bereitstellung einzurichten:

  1. Wählen Sie auf der Dokumentationsseite der gcloud CLI Ihr Betriebssystem aus und folgen Sie der Installationsanleitung.
  2. Führen Sie gcloud config get-value project aus, um die Google Cloud Platform-Projektkonfiguration zu prüfen.
  3. Rufen Sie die Einstellungen Ihres Dialogflow-Agents auf und prüfen Sie die Projekt-ID, die mit dem Agent verknüpft ist. Das in der gcloud-Befehlszeile konfigurierte Google Cloud-Projekt muss mit der Projekt-ID des Kundenservicemitarbeiters übereinstimmen.
  4. Wenn die Projekt-IDs nicht übereinstimmen, führen Sie gcloud config set project PROJECT-ID aus und ersetzen Sie PROJECT-ID durch die Projekt-ID aus Schritt 3.

Dienstkonto einrichten

Sie müssen ein Dienstkonto in Ihrem Google Cloud-Projekt erstellen, damit die Integration ordnungsgemäß funktioniert. Weitere Informationen finden Sie in der Dialogflow-Dokumentation.

So erstellen Sie ein Dienstkonto und richten die Integration ein:

  1. Wählen Sie das Google Cloud Platform-Projekt aus, das mit Ihren Agent Assist-Ressourcen verknüpft ist.
  2. Klicken Sie in der Google Cloud Platform Console auf das Navigationsmenü, bewegen Sie den Mauszeiger auf IAM und Verwaltung und klicken Sie auf Dienstkonten.
  3. Klicken Sie auf + DIENSTKONTO ERSTELLEN, füllen Sie die Details aus und weisen Sie ihm die Rolle Dialogflow Client API zu.

Erforderliche APIs aktivieren

  1. Rufen Sie das gewünschte Google Cloud Platform-Projekt auf.
  2. Klicken Sie in der Google Cloud Console auf das Navigationsmenü und wählen Sie Abrechnung aus. Die Abrechnung für Ihr Projekt muss aktiviert sein.
  3. Aktivieren Sie Cloud Build und die Cloud Run API für dieses Projekt.
  4. Klonen Sie das folgende Git-Repository auf Ihren lokalen Computer oder in Ihre Entwicklungsumgebung: git clone [repository url].
  5. Öffnen Sie das Stammverzeichnis des Repositorys auf Ihrem lokalen Computer oder in Ihrer Entwicklungsumgebung.

Mit der Befehlszeile bereitstellen

Ändern Sie im lokalen Terminal das aktive Verzeichnis in das Stammverzeichnis des Repositorys.

Führen Sie den folgenden Befehl aus, um den Status Ihres Repositorys in der Google Cloud Platform Container Registry zu speichern. Ersetzen Sie PROJECT-ID durch die ID Ihres Google Cloud-Projekts.

    gcloud builds submit --tag gcr.io/PROJECT-ID/agent-assist-modules-application-server

Stellen Sie Ihre Integration mit dem folgenden Befehl live bereit. Ersetzen Sie PROJECT-ID durch die Google Cloud Platform-Projekt-ID Ihres Kundenservicemitarbeiters und SERVICE-ACCOUNT-EMAIL durch die E-Mail-Adresse des Dienstkontos.

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
  • Wählen Sie auf Aufforderung eine Region aus, z. B. us-central1.
  • Wenn Sie nach einem Dienstnamen gefragt werden, drücken Sie die Eingabetaste, um den Standardnamen zu akzeptieren.
  • Drücken Sie y, wenn Sie nicht authentifizierte Aufrufe zulassen möchten.

Weitere Informationen finden Sie in der Cloud Run-Dokumentation. Eine Liste Ihrer aktiven Integrationsbereitstellungen finden Sie in der Google Cloud Console unter Cloud Run.

Umgebungsvariablen

Folgen Sie der Anleitung für Cloud Run, um die erforderlichen Umgebungsvariablen festzulegen.

Nach dem Bereitstellen des Dienstes gibt die Befehlszeile die URL aus, unter der die Anwendung bereitgestellt wurde (target_url). Kehren Sie zurück und legen Sie die Umgebungsvariable APPLICATION_SERVER_URL mit diesem Wert fest.

Anwendungsserver herunterfahren

Wenn Sie den Anwendungsserver herunterfahren möchten, müssen Sie den Cloud Run-Dienst löschen.

Führen Sie in Ihrem lokalen Terminal den folgenden Befehl aus und wählen Sie die zuvor ausgewählte Zielplattform aus, um aktive Bereitstellungen aufzulisten:

    gcloud beta run services list

Führen Sie als Nächstes den folgenden Befehl aus:

   gcloud beta run services delete agent-assist-modules-application-server