Desplegar el servidor de aplicaciones

En esta guía se describen los pasos necesarios para configurar un servidor de aplicaciones que puedas usar para renderizar sugerencias de Asistente para agentes en LivePerson. El servidor de aplicaciones se usa con un servidor proxy en el mismo directorio. Para obtener instrucciones sobre cómo renderizar los módulos de la interfaz de usuario en el espacio de trabajo del agente, consulta la página principal del tutorial de LivePerson. Se necesitan un servidor de aplicaciones y un servidor proxy para poder renderizar los módulos en LivePerson.

Aunque es posible configurar este despliegue de integración en cualquier plataforma de alojamiento, en estas instrucciones se usa Cloud Run de Google.

Configuración

Cuando implementes el servicio, debes definir las siguientes variables de entorno. Asegúrate de dejar en blanco las variables LP_CLIENT_ID y LP_CLIENT_SECRET cuando crees el servidor de aplicaciones por primera vez. LivePerson proporcionará estas variables cuando crees una aplicación de Conversational Cloud, y tú las actualizarás en ese momento. También te saltarás inicialmente APPLICATION_SERVER_URL y DF_PROXY_SERVER_URL. Cada una de estas dos variables se definirá después de que se hayan implementado los servidores de aplicaciones y proxy, y hayan devuelto los valores de URL necesarios.

  • LP_ACCOUNT_ID: ID de cuenta de LivePerson.
  • LP_CLIENT_ID: tu ID de cliente de LivePerson. LivePerson te proporcionará esta información una vez que se haya instalado la aplicación Conversational Cloud. Por ahora, omite esta variable. La actualizarás cuando se haya proporcionado la información.
  • LP_CLIENT_SECRET: tu secreto de cliente de LivePerson. LivePerson lo proporcionará una vez que se haya instalado la aplicación Conversational Cloud. Por ahora, omite esta variable. La actualizarás cuando se haya proporcionado la información.
  • LP_SENTINEL_DOMAIN: Ve a https://developers.liveperson.com/domain-api.html. Introduce tu número de cuenta y busca el dominio de "sentinel".
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: Ve a https://developers.liveperson.com/domain-api.html. Introduce el número de tu cuenta y busca el dominio de "accountConfigReadOnly".
  • APPLICATION_SERVER_URL: URL del servidor de aplicaciones de la interfaz de usuario. (Sáltalo por ahora y actualízalo después de que se haya implementado el servidor de aplicaciones y sepas su URL).
  • DF_PROXY_SERVER_URL: URL del servidor proxy. (Sáltalo por ahora y actualízalo cuando se haya implementado el servidor proxy y sepas su URL).
  • PROJECT_ID: tu ID de proyecto de Google Cloud. No incluya el prefijo projects/.

Archivo .env de ejemplo:

    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

Desplegar

El servidor de aplicaciones de la interfaz de usuario debe implementarse en un servicio de alojamiento de Google Cloud. Te recomendamos que uses Google App Engine o Cloud Run. En los pasos que se indican a continuación, se usa Cloud Run como ejemplo.

Configurar una CLI de gcloud

Los procesos de implementación que se describen en este tutorial utilizan comandos de gcloud CLI. Sigue los pasos que se indican a continuación para configurar la CLI de gcloud de forma local para esta implementación:

  1. En la página de documentación de gcloud CLI, selecciona tu sistema operativo y sigue las instrucciones de instalación.
  2. Ejecuta gcloud config get-value project para comprobar la configuración del proyecto de Google Cloud Platform.
  3. Ve a los ajustes de tu agente de Dialogflow y comprueba el ID de proyecto asociado al agente. El ID de proyecto de Google Cloud Platform configurado en la CLI de gcloud debe coincidir con el ID de proyecto del agente.
  4. Si los IDs de proyecto no coinciden, ejecuta gcloud config set project PROJECT-ID y sustituye PROJECT-ID por el ID de proyecto del paso 3.

Configurar una cuenta de servicio

Para que la integración funcione correctamente, debes crear una cuenta de servicio en tu proyecto de Google Cloud Platform. Para obtener más información, consulta la documentación de Dialogflow.

Sigue estos pasos para crear una cuenta de servicio y configurar la integración:

  1. Selecciona el proyecto de Google Cloud Platform asociado a tus recursos de Asistente.
  2. En el menú de navegación de la consola de Google Cloud Platform, coloca el cursor sobre IAM y administración y haz clic en Cuentas de servicio.
  3. Haz clic en + CREAR CUENTA DE SERVICIO, rellena los detalles y asigna el rol API del cliente de Dialogflow.

Habilitar las APIs necesarias

  1. Ve al proyecto de Google Cloud Platform que quieras.
  2. Haz clic en el menú de navegación de la consola de Google Cloud Platform y selecciona Facturación. Comprueba que la facturación esté habilitada en tu proyecto.
  3. Habilita Cloud Build y la API de Cloud Run en este proyecto.
  4. Clona el siguiente repositorio de Git en tu máquina local o entorno de desarrollo: git clone [repository url].
  5. Abre el directorio raíz del repositorio en tu máquina local o en tu entorno de desarrollo.

Desplegar con la CLI

En tu terminal local, cambia el directorio activo al directorio raíz del repositorio.

Ejecuta el siguiente comando para guardar el estado de tu repositorio en Container Registry de Google Cloud Platform. Sustituye PROJECT-ID por el ID de tu proyecto de Google Cloud Platform.

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

Implementa tu integración en el entorno de producción con el siguiente comando. Sustituye PROJECT-ID por el ID del proyecto de Google Cloud Platform de tu agente y SERVICE-ACCOUNT-EMAIL por el correo del cliente de tu cuenta de servicio.

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
  • Cuando se te pida que elijas una región, selecciona una (por ejemplo, us-central1).
  • Cuando se te solicite un nombre de servicio, pulsa Intro para aceptar el predeterminado.
  • Cuando se te pregunte si quieres permitir las invocaciones sin autenticar, pulsa y.

Para obtener más información, consulta la documentación de Cloud Run. Puedes ver una lista de tus implementaciones de integración activas en Cloud Run en la consola de Google Cloud Platform.

Variables de entorno

Sigue las instrucciones de Cloud Run para definir las variables de entorno necesarias.

Una vez que se haya implementado el servicio, la CLI mostrará la URL en la que se ha implementado la aplicación (target_url). Vuelve y define la variable de entorno APPLICATION_SERVER_URL con este valor.

Apagar el servidor de aplicaciones

Para apagar el servidor de aplicaciones, debes eliminar el servicio de Cloud Run.

En tu terminal local, ejecuta el siguiente comando y selecciona la plataforma de destino que hayas elegido anteriormente para ver una lista de las implementaciones activas:

    gcloud beta run services list

A continuación, ejecuta el siguiente comando:

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