Implementar el servidor proxy

En esta guía se describen los pasos necesarios para configurar un servidor proxy. Usarás el servidor proxy junto con un servidor de aplicaciones para simplificar la autenticación con la API Dialogflow. 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. Para poder renderizar los módulos en LivePerson, se necesitan un servidor de aplicaciones y un servidor proxy en el mismo directorio.

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

Antes de empezar

Antes de empezar este tutorial, asegúrate de que ya has desplegado el servidor de aplicaciones.

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 inicialmente APPLICATION_SERVER_URL y DF_PROXY_SERVER_URL, y configurarás ambos después de que se hayan implementado los servidores de aplicaciones y proxy, y hayan devuelto los valores 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. Escribe 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.
  • JWT_SECRET: una frase "secreta" que se usará para firmar los tokens de autenticación. Puedes usar cualquier frase, aunque lo más seguro es que sea una larga y aleatoria. Consulta las prácticas recomendadas en https://fusionauth.io/learn/expert-advice/tokens/building-a-secure-jwt/#keys.

Archivo .env de ejemplo:

    LP_ACCOUNT_ID = 12345678
    LP_CLIENT_ID = abc-123-f0f0
    LP_CLIENT_SECRET = abc123abc123abc123abc123
    LP_SENTINEL_DOMAIN = va.sentinel.liveperson.net
    LP_ACCOUNT_CONFIG_READONLY_DOMAIN = z1.acr.liveperson.net
    APPLICATION_SERVER_URL = https://my-project.wm.r.appspot.com
    JWT_SECRET = an_example_JWT_secret_phrase_please_use_something_better

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.

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-proxy-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-proxy-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 DF_PROXY_SERVER_URL del servidor de aplicaciones con este valor.

Apagar el servidor proxy

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-proxy-server