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 antes de que puedas renderizar los módulos en LivePerson.

Si bien es posible configurar esta implementación de integración en cualquier plataforma de hosting, estas instrucciones usan 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 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 los servidores de aplicaciones y 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 proporcionará esta información una vez que se haya instalado 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: Es el secreto del cliente de LivePerson. LivePerson proporcionará este valor una vez que se haya instalado 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 de "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 de "accountConfigReadOnly".
  • APPLICATION_SERVER_URL: URL del servidor de aplicaciones de la IU. (Omite este paso por ahora y actualiza la URL después de implementar el servidor de aplicaciones).
  • DF_PROXY_SERVER_URL: Es la URL del servidor proxy. (Omite este paso por ahora y actualiza la información después de que se implemente 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 debe implementarse 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 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 del proyecto del agente.
  4. Si los IDs del proyecto 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 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 desees.
  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 entorno de desarrollo: git clone [repository url].
  5. Abre el directorio raíz del repositorio en tu máquina local o entorno de desarrollo.

Implementa 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 Google Cloud Platform Container Registry. 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

Implementa tu integración en producción con el siguiente comando. 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 valor predeterminado.
  • Cuando se te solicite permitir invocaciones sin autenticar, 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 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 generará la URL en la que se implementó la aplicación (target_url). Vuelve y configura la variable de entorno APPLICATION_SERVER_URL con este valor.

Apaga el servidor de aplicaciones

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

En tu terminal local, ejecuta el siguiente comando y selecciona la plataforma de destino elegida 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