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 espacio 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 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.
Antes de comenzar
Antes de comenzar este instructivo, asegúrate de haber implementado 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 APPLICATION_SERVER_URL y DF_PROXY_SERVER_URL al principio, y establecerás ambos después de que se implementen los servidores de aplicaciones y proxy, y se devuelvan los valores 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.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 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.
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-proxy-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-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 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 mostrará la URL en la que se implementó la aplicación (target_url). Vuelve y configura la variable de entorno DF_PROXY_SERVER_URL para el servidor de aplicaciones con este valor.
Cierra el servidor proxy
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-proxy-server