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 de Dialogflow. Para obtener instrucciones sobre cómo renderizar los módulos de la IU en el lugar de trabajo del agente, consulta la página principal del instructivo de LivePerson. Se requiere un servidor de aplicaciones y un servidor proxy en el mismo directorio 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.
Antes de comenzar
Asegúrate de haber implementado el servidor de aplicaciones antes de comenzar este instructivo.
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 te 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 los configurarás después de que se hayan implementado la aplicación y los servidores proxy, y se hayan devuelto los valores 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 el número de tu cuenta y busca el dominio de "accountConfigReadOnly".APPLICATION_SERVER_URL: Es la URL del servidor de aplicaciones de la IU.JWT_SECRET: Es una frase “secreta” que se usará para firmar los tokens de autenticación. Puedes usar cualquier frase, aunque un secreto largo y aleatorio es más seguro. Consulta las prácticas recomendadas en https://fusionauth.io/learn/expert-advice/tokens/building-a-secure-jwt/#keys.
Archivo .env de muestra:
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
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.
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-proxy-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-proxy-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 en la que se implementó la
aplicación (target_url). Regresa y configura la
variable de entorno DF_PROXY_SERVER_URL para el servidor de aplicaciones con
este valor.
Cómo cerrar el servidor proxy
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-proxy-server