Implementa el servidor de aplicaciones

En esta guía, se describen los pasos necesarios para configurar un servidor de aplicaciones que puedes usar para renderizar sugerencias de Agent Assist 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 IU en el espacio de trabajo del agente, consulta la página principal del instructivo de LivePerson. Se requiere un servidor de aplicaciones y un servidor proxy para que puedas renderizar los módulos en LivePerson.

Aunque es posible configurar esta implementación de integración en cualquier plataforma de alojamiento, estas instrucciones usan Cloud Run de Google.

Configuración

Cuando implementes el servicio, debes definir las siguientes variables de entorno. Asegúrate de dejar las variables LP_CLIENT_ID y LP_CLIENT_SECRET en blanco cuando crees el servidor de aplicaciones inicialmente. LivePerson proporcionará estas variables cuando crees una aplicación de Conversational Cloud y las actualizarás en ese momento. También omitirás APPLICATION_SERVER_URL y DF_PROXY_SERVER_URL al principio. Cada una de estas dos variables se establecerá después de que se implementen la aplicación y los servidores proxy, y se devuelvan los valores de URL requeridos.

  • LP_ACCOUNT_ID: ID de la cuenta de LivePerson.
  • LP_CLIENT_ID: Es tu ID de cliente de LivePerson. LivePerson te lo proporcionará una vez que se instale la aplicación de Conversational Cloud. (Por ahora, omite esta variable, la actualizarás una vez que se proporcione la información).
  • LP_CLIENT_SECRET: Tu secreto del cliente de LivePerson. LivePerson te lo proporcionará una vez que se instale la aplicación de Conversational Cloud. (Por ahora, omite esta variable, la actualizarás una vez que se proporcione la información).
  • LP_SENTINEL_DOMAIN: Ve a https://developers.liveperson.com/domain-api.html. Ingresa tu número de cuenta y busca el dominio "sentinel".
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: Ve a https://developers.liveperson.com/domain-api.html. Ingresa tu número de cuenta y busca el dominio “accountConfigReadOnly”.
  • APPLICATION_SERVER_URL: Es la URL del servidor de aplicaciones de la IU. (omite este paso por ahora y actualízalo después de que se implemente el servidor de aplicaciones y conozcas su URL).
  • DF_PROXY_SERVER_URL: Es la URL del servidor proxy. (Por ahora, omite esta opción y actualízala después de que se haya implementado el servidor proxy y conozcas su URL).
  • PROJECT_ID es el ID del proyecto de Google Cloud. No incluyas el prefijo projects/.

Archivo .env de muestra:

    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

Implementar

El servidor de aplicaciones de la IU se debe implementar en un servicio de hosting de Google Cloud. Te recomendamos que uses Google App Engine o Cloud Run. En los siguientes pasos, se usa Cloud Run como ejemplo.

Configura una gcloud CLI

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

  1. En la página de documentación de gcloud CLI, selecciona tu SO y sigue las instrucciones de instalación.
  2. Ejecuta gcloud config get-value project para verificar la configuración del proyecto de Google Cloud Platform.
  3. Ve a la configuración de tu agente de Dialogflow y verifica el ID del proyecto asociado con el agente. El 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 los proyectos no coinciden, ejecuta gcloud config set project PROJECT-ID y reemplaza PROJECT-ID por el ID del proyecto del paso 3.

Configurar una cuenta de servicio

Debes crear una cuenta de servicio en tu proyecto de Google Cloud Platform para que la integración funcione correctamente. Para obtener más detalles, 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 con tus recursos de Agent Assist.
  2. Haz clic en el menú de navegación de la consola de Google Cloud Platform, coloca el cursor sobre IAM y administración y, luego, haz clic en Cuentas de servicio.
  3. Haz clic en + CREAR CUENTA DE SERVICIO, completa los detalles y asígnale el rol de Cliente de la API de Dialogflow.

Habilita las API obligatorias

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

Implementa con la CLI

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

Ejecuta el siguiente comando para guardar el estado de tu repositorio en Google Container Registry de Google Cloud Platform. Reemplaza 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

Usa el siguiente comando para implementar tu integración en vivo. Reemplaza PROJECT-ID por el ID del proyecto de Google Cloud Platform de tu agente y SERVICE-ACCOUNT-EMAIL por el correo electrónico 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 solicite una región, selecciona una (por ejemplo, us-central1).
  • Cuando se te solicite un nombre de servicio, presiona Intro para aceptar el predeterminado.
  • Cuando se te solicite permitir invocaciones no autenticadas, presiona 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 Google Cloud Platform Console.

Variables de entorno

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

Una vez que se implemente el servicio, la CLI mostrará la URL a la que se implementó la aplicación (target_url). Regresa y configura la variable de entorno APPLICATION_SERVER_URL con este valor.

Cómo cerrar el servidor de aplicaciones

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

En la terminal local, ejecuta el siguiente comando y selecciona la plataforma de destino que elegiste anteriormente para enumerar 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