Ce guide décrit les étapes requises pour configurer un serveur d'applications que vous pouvez utiliser pour afficher les suggestions d'Agent Assist dans LivePerson. Le serveur d'applications 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 requis 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 le serveur d'applications. LivePerson fournira ces variables lorsque vous créerez une application Conversational Cloud, et vous les mettrez à jour à ce moment-là. Vous allez également ignorer APPLICATION_SERVER_URL et DF_PROXY_SERVER_URL dans un premier temps. Chacune de ces deux variables sera définie une fois que les serveurs d'application et les serveurs proxy auront été déployés et auront renvoyé les valeurs d'URL requises.
LP_ACCOUNT_ID: ID de compte LivePerson.LP_CLIENT_ID: votre ID client LivePerson. Il sera fourni par LivePerson une fois l'application Conversational Cloud installée. (Ignorez cette variable pour l'instant. Vous la mettrez à jour une fois les informations fournies.)LP_CLIENT_SECRET: votre code secret du client LivePerson. Il sera fourni par LivePerson une fois l'application Conversational Cloud installée. (Ignorez cette variable pour l'instant. Vous la mettrez à jour une fois que les informations auront été fournies.)LP_SENTINEL_DOMAIN: accédez à https://developers.liveperson.com/domain-api.html. Saisissez votre numéro de compte et 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'interface utilisateur. (Ignorez cette étape pour l'instant et effectuez la mise à jour 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 effectuez la mise à jour 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éfixeprojects/.
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 à titre d'exemple.
Configurer la gcloud CLI
Les processus de déploiement décrits dans ce tutoriel utilisent des commandes gcloud CLI. Pour configurer gcloud CLI localement pour ce déploiement, procédez comme suit :
- Sur la page de documentation de gcloud CLI, sélectionnez votre OS et suivez les instructions d'installation.
- Exécutez
gcloud config get-value projectpour vérifier la configuration du projet Google Cloud Platform. - Accédez aux paramètres de votre agent Dialogflow et vérifiez l'ID du projet associé à l'agent. Le projet Google Cloud Platform configuré dans la gcloud CLI doit correspondre à l'ID de projet de l'agent.
- Si les ID de projet ne correspondent pas, exécutez
gcloud config set project PROJECT-IDen remplaçantPROJECT-IDpar l'ID du 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 :
- Sélectionnez le projet Google Cloud Platform associé à vos ressources Agent Assist.
- Cliquez sur le menu de navigation de la console Google Cloud Platform, pointez sur IAM et administration, puis cliquez sur Comptes de service.
- Cliquez sur + CRÉER UN COMPTE DE SERVICE, renseignez les détails et attribuez-lui le rôle API client Dialogflow.
Activer les API requises
- Accédez au projet Google Cloud Platform de votre choix.
- Cliquez sur le menu de navigation dans la console Google Cloud Platform, puis sélectionnez Facturation. Assurez-vous que la facturation est activée pour votre projet.
- Activez Cloud Build et l'API Cloud Run pour ce projet.
- Clonez le dépôt Git suivant sur votre ordinateur local ou votre environnement de développement :
git clone [repository url]. - Ouvrez le répertoire racine du dépôt sur votre ordinateur local ou votre environnement de développement.
Créer un dépôt Docker dans Artifact Registry
Exécutez la commande gcloud artifacts repositories create pour créer un dépôt Docker, dans lequel vous enregistrerez l'état de votre dépôt :
gcloud artifacts repositories create REPOSITORY-NAME --repository-format=docker --location=LOCATION
Remplacez les éléments suivants :
REPOSITORY-NAME: nom de votre dépôt Docker.LOCATION: Google Cloud emplacement où vous souhaitez créer votre dépôt Docker.
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.
Utilisez la commande gcloud builds submit pour enregistrer l'état de votre dépôt dans Google Cloud Artifact Registry :
gcloud builds submit --tag=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-NAME/agent-assist-modules-application-server
Remplacez les éléments suivants :
LOCATION: emplacement Google Cloud où vous avez créé votre dépôt Docker.PROJECT-ID: ID du projet Google Cloud dans lequel vous avez créé votre dépôt Docker.REPOSITORY-NAME: nom de votre dépôt Docker.
Déployez votre intégration en production à l'aide de la commande gcloud run deploy :
gcloud run deploy --image=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-NAME/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory=1Gi
Remplacez les éléments suivants :
LOCATION: emplacement Google Cloud où vous avez créé votre dépôt Docker.PROJECT-ID: ID du projet Google Cloud dans lequel vous avez créé votre dépôt Docker.REPOSITORY-NAME: nom de votre dépôt Docker.SERVICE-ACCOUNT-EMAIL: adresse e-mail du client de votre compte de service.
Pendant l'exécution de la commande, procédez comme suit :
- Lorsque vous êtes invité à indiquer la 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 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 génère l'URL de déploiement de l'application (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'applications
Pour arrêter le serveur d'applications, 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