Déployer le serveur d'applications

Ce guide décrit les étapes requises pour configurer un serveur d'applications que vous pouvez utiliser pour afficher les suggestions Agent Assist dans LivePerson. Le serveur d'application est utilisé avec un serveur proxy dans le même répertoire. Pour savoir comment afficher les modules d'interface utilisateur dans l'espace de travail de l'agent, consultez la page principale du tutoriel LivePerson. Un serveur d'applications et un serveur proxy sont nécessaires pour pouvoir afficher les modules dans LivePerson.

Bien qu'il soit possible de configurer ce déploiement d'intégration sur n'importe quelle plate-forme d'hébergement, ces instructions utilisent Cloud Run de Google.

Configuration

Lorsque vous déployez le service, vous devez définir les variables d'environnement suivantes. Veillez à laisser les variables LP_CLIENT_ID et LP_CLIENT_SECRET vides lorsque vous créez initialement le serveur d'application. LivePerson vous fournira ces variables lorsque vous créerez une application Conversational Cloud. Vous les mettrez à jour à ce moment-là. Vous ignorerez également initialement APPLICATION_SERVER_URL et DF_PROXY_SERVER_URL. Chacune de ces deux variables sera définie une fois que l'application et les serveurs proxy auront été déployés et renvoyé les valeurs d'URL requises.

  • LP_ACCOUNT_ID: ID de compte LivePerson.
  • LP_CLIENT_ID: votre ID client LivePerson. LivePerson vous fournira cette information une fois l'application Conversational Cloud installée. (Ignorez cette variable pour le moment, vous la mettrez à jour une fois que les informations auront été fournies).
  • LP_CLIENT_SECRET: votre code secret du client LivePerson. LivePerson vous fournira cette information une fois l'application Conversational Cloud installée. (Ignorez cette variable pour le moment, vous la mettrez à jour une fois les informations fournies).
  • LP_SENTINEL_DOMAIN: accédez à https://developers.liveperson.com/domain-api.html. Saisissez votre numéro de compte, puis recherchez le domaine "sentinel".
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: accédez à https://developers.liveperson.com/domain-api.html. Saisissez votre numéro de compte et recherchez le domaine pour "accountConfigReadOnly".
  • APPLICATION_SERVER_URL: URL du serveur d'application de l'UI. (Ignorez cette étape pour le moment et modifiez-la une fois que le serveur d'applications a été déployé et que vous connaissez son URL.)
  • DF_PROXY_SERVER_URL: URL du serveur proxy. (Ignorez cette étape pour le moment et modifiez-la une fois que le serveur proxy a été déployé et que vous connaissez son URL.)
  • PROJECT_ID : ID de votre projet Google Cloud. N'incluez pas le préfixe projects/.

Exemple de fichier .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

Déployer

Le serveur d'application de l'UI doit être déployé sur un service d'hébergement Google Cloud. Nous vous recommandons d'utiliser Google App Engine ou Cloud Run. Les étapes ci-dessous utilisent Cloud Run comme exemple.

Configurer gcloud CLI

Les processus de déploiement décrits dans ce tutoriel utilisent des commandes gcloud CLI. Suivez les étapes ci-dessous pour configurer la gcloud CLI localement pour ce déploiement:

  1. Sur la page de documentation de gcloud CLI, sélectionnez votre OS et suivez les instructions d'installation.
  2. Exécutez gcloud config get-value project pour vérifier la configuration du projet Google Cloud Platform.
  3. Accédez aux paramètres de votre agent Dialogflow et vérifiez l'ID de projet associé à l'agent. Le projet Google Cloud Platform configuré dans la CLI gcloud doit correspondre à l'ID de projet de l'agent.
  4. Si les ID de projet ne correspondent pas, exécutez gcloud config set project PROJECT-ID, en remplaçant PROJECT-ID par l'ID de projet de l'étape 3.

Configurer un compte de service

Vous devez créer un compte de service dans votre projet Google Cloud Platform pour que l'intégration fonctionne correctement. Pour en savoir plus, consultez la documentation Dialogflow.

Pour créer un compte de service et configurer l'intégration, procédez comme suit:

  1. Sélectionnez le projet Google Cloud Platform associé à vos ressources Agent Assist.
  2. Cliquez sur le menu de navigation de la console Google Cloud Platform, pointez sur IAM et administration, puis cliquez sur Comptes de service.
  3. Cliquez sur + CRÉER UN COMPTE DE SERVICE, renseignez les informations et attribuez-lui le rôle API client Dialogflow.

Activer les API requises

  1. Accédez au projet Google Cloud Platform de votre choix.
  2. Cliquez sur le menu de navigation de la console Google Cloud Platform, puis sélectionnez Facturation. Assurez-vous que la facturation est activée pour votre projet.
  3. Activez Cloud Build et l'API Cloud Run pour ce projet.
  4. Clonez le dépôt Git suivant sur votre machine locale ou votre environnement de développement: git clone [repository url].
  5. Ouvrez le répertoire racine du dépôt sur votre ordinateur local ou dans votre environnement de développement.

Déployer à l'aide de la CLI

Dans votre terminal local, remplacez le répertoire actif par le répertoire racine du dépôt.

Exécutez la commande suivante pour enregistrer l'état de votre dépôt dans Google Cloud Platform Container Registry. Remplacez PROJECT-ID par l'ID de votre projet Google Cloud Platform.

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

Déployez votre intégration en production à l'aide de la commande suivante. Remplacez PROJECT-ID par l'ID de projet Google Cloud Platform de votre agent et SERVICE-ACCOUNT-EMAIL par l'adresse e-mail client de votre compte de service.

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
  • Lorsque vous êtes invité à indiquer une région, sélectionnez-en une (par exemple, us-central1).
  • Lorsque vous êtes invité à saisir un nom de service, appuyez sur Entrée pour accepter le nom par défaut.
  • Lorsque vous êtes invité à autoriser les appels non authentifiés, appuyez sur y.

Pour en savoir plus, consultez la documentation de Cloud Run. Vous pouvez afficher la liste de vos déploiements d'intégration actifs sous Cloud Run dans la console Google Cloud Platform.

Variables d'environnement

Suivez les instructions Cloud Run pour définir les variables d'environnement nécessaires.

Une fois le service déployé, la CLI affiche l'URL à laquelle l'application a été déployée (target_url). Revenez en arrière et définissez la variable d'environnement APPLICATION_SERVER_URL à l'aide de cette valeur.

Arrêter le serveur d'application

Pour arrêter le serveur d'application, vous devez supprimer le service Cloud Run.

Dans votre terminal local, exécutez la commande suivante et sélectionnez la plate-forme cible précédemment choisie pour lister les déploiements actifs:

    gcloud beta run services list

Exécutez ensuite la commande suivante:

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