Anwendungsserver bereitstellen

In dieser Anleitung werden die Schritte beschrieben, die zum Einrichten eines Anwendungsservers erforderlich sind, 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 Agent-Arbeitsbereich finden Sie auf der Hauptseite der LivePerson-Anleitung. Sowohl ein Anwendungsserver als auch ein Proxyserver sind erforderlich, bevor 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 leer, wenn Sie den Anwendungsserver zum ersten Mal erstellen. LivePerson stellt diese Variablen bereit, wenn Sie eine Conversational Cloud-Anwendung erstellen. Sie müssen sie dann aktualisieren. APPLICATION_SERVER_URL und DF_PROXY_SERVER_URL werden anfangs ebenfalls übersprungen. Jede dieser beiden Variablen wird festgelegt, nachdem die Anwendungs- und Proxyserver bereitgestellt wurden und die erforderlichen URL-Werte zurückgegeben haben.

  • LP_ACCOUNT_ID: LivePerson-Konto-ID.
  • LP_CLIENT_ID: Ihre LivePerson-Client-ID. Diese wird von LivePerson bereitgestellt, sobald die Conversational Cloud-Anwendung installiert wurde. Überspringen Sie diese Variable vorerst. Sie wird aktualisiert, sobald die Informationen bereitgestellt wurden.
  • 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 wird aktualisiert, sobald die Informationen bereitgestellt wurden.
  • LP_SENTINEL_DOMAIN: Rufen Sie https://developers.liveperson.com/domain-api.html auf. Geben Sie Ihre Kontonummer ein und suchen Sie nach der Domain für „sentinel“.
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: Rufen Sie https://developers.liveperson.com/domain-api.html auf. Geben Sie Ihre Kontonummer ein und suchen Sie nach der Domain für „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 von Google App Engine oder Cloud Run. In den folgenden Schritten wird Cloud Run als Beispiel verwendet.

gcloud CLI einrichten

Bei den in dieser Anleitung beschriebenen Bereitstellungsprozessen 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 zur gcloud CLI Ihr Betriebssystem aus und folgen Sie der Installationsanleitung.
  2. Führen Sie gcloud config get-value project aus, um die Konfiguration des Google Cloud-Projekts zu prüfen.
  3. Rufen Sie die Einstellungen Ihres Dialogflow-Agents auf und prüfen Sie die Projekt-ID, die dem Agent zugeordnet ist. Das in der gcloud CLI konfigurierte Google Cloud-Projekt muss mit der Projekt-ID des Agents ü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 Console auf das Navigationsmenü, bewegen Sie den Mauszeiger auf IAM und Verwaltung und klicken Sie auf Dienstkonten.
  3. Klicken Sie auf + DIENSTKONTO ERSTELLEN, geben Sie die Details ein und weisen Sie dem Konto die Rolle Dialogflow Client API zu.

Erforderliche APIs aktivieren

  1. Rufen Sie das gewünschte Google Cloud-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

Wechseln Sie in Ihrem lokalen Terminal in das Stammverzeichnis des Repositorys.

Führen Sie den folgenden Befehl aus, um den Status Ihres Repository 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-Projekt-ID Ihres Agents und SERVICE-ACCOUNT-EMAIL durch die Client-E-Mail-Adresse Ihres Dienstkontos.

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
  • Wenn Sie zur Eingabe einer Region aufgefordert werden, wählen Sie eine Region aus, z. B. us-central1.
  • Wenn Sie zur Eingabe eines Dienstnamens aufgefordert werden, drücken Sie die Eingabetaste, um den Standardwert zu übernehmen.
  • Wenn Sie aufgefordert werden, nicht authentifizierte Aufrufe zuzulassen, drücken Sie y.

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 Cloud Run-Anleitung, um die erforderlichen Umgebungsvariablen festzulegen.

Nachdem der Dienst bereitgestellt wurde, gibt die CLI die URL aus, unter der die Anwendung bereitgestellt wurde (target_url). Gehen Sie zurück und legen Sie die Umgebungsvariable APPLICATION_SERVER_URL mit diesem Wert fest.

Anwendungsserver herunterfahren

Um den Anwendungsserver herunterzufahren, 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