Anwendungsserver bereitstellen

In diesem Leitfaden 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.

Obwohl es möglich ist, diese Integrationsbereitstellung auf jeder Hosting-Plattform einzurichten, wird in dieser Anleitung 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. Außerdem überspringen Sie vorerst APPLICATION_SERVER_URL und DF_PROXY_SERVER_URL. Diese beiden Variablen werden 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 aktualisieren sie, 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 aktualisieren sie, 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 die URL, nachdem der Anwendungsserver bereitgestellt wurde und Sie die URL kennen.)
  • DF_PROXY_SERVER_URL: Die URL des Proxyservers. (Überspringen Sie diesen Schritt vorerst und aktualisieren Sie die URL, nachdem der Proxyserver bereitgestellt wurde und Sie die 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-Hosting-Dienst 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

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 zur 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-Agenten auf und prüfen Sie die mit dem Agenten verknüpfte Projekt-ID. Das in der gcloud CLI konfigurierte Google Cloud Platform-Projekt sollte 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

Damit die Integration ordnungsgemäß funktioniert, müssen Sie in Ihrem Google Cloud Platform-Projekt ein Dienstkonto erstellen. 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, geben Sie die Details ein 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 Platform 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.

Docker-Repository in Artifact Registry erstellen

Verwenden Sie den Befehl gcloud artifacts repositories create, um ein Docker-Repository zu erstellen, in dem Sie den Status Ihres Repositorys speichern:

gcloud artifacts repositories create REPOSITORY-NAME --repository-format=docker --location=LOCATION

Ersetzen Sie Folgendes:

  • REPOSITORY-NAME: der Name für Ihr Docker-Repository.
  • LOCATION: der Google Cloud -Standort, an dem Ihr Docker-Repository erstellt werden soll.

Mit Befehlszeile bereitstellen

Wechseln Sie im lokalen Terminal vom aktiven Verzeichnis in das Stammverzeichnis des Repositorys.

Verwenden Sie den Befehl gcloud builds submit, um den Status Ihres Repositorys in Google Cloud Artifact Registry zu speichern:

gcloud builds submit --tag=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-NAME/agent-assist-modules-application-server

Ersetzen Sie Folgendes:

  • LOCATION: der Google Cloud -Standort, an dem Sie Ihr Docker-Repository erstellt haben.
  • PROJECT-ID: die ID des Google Cloud -Projekts, in dem Sie Ihr Docker-Repository erstellt haben.
  • REPOSITORY-NAME: der Name für Ihr Docker-Repository.

Stellen Sie Ihre Integration mit dem Befehl gcloud run deploy live bereit:

gcloud run deploy --image=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-NAME/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory=1Gi

Ersetzen Sie Folgendes:

  • LOCATION: der Google Cloud -Standort, an dem Sie Ihr Docker-Repository erstellt haben.
  • PROJECT-ID: die ID des Google Cloud -Projekts, in dem Sie Ihr Docker-Repository erstellt haben.
  • REPOSITORY-NAME: der Name für Ihr Docker-Repository.
  • SERVICE-ACCOUNT-EMAIL: die Client-E-Mail-Adresse Ihres Dienstkontos.

Führen Sie während der Ausführung des Befehls die folgenden Schritte aus:

  1. Wenn Sie zur Eingabe einer Region aufgefordert werden, wählen Sie eine Region aus (z. B. us-central1).
  2. Wenn Sie zur Eingabe eines Dienstnamens aufgefordert werden, drücken Sie die Eingabetaste, um den Standardnamen zu akzeptieren.
  3. 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 Platform Console unter Cloud Run.

Umgebungsvariablen

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

Nachdem der Dienst bereitgestellt wurde, 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