Esta página se ha traducido con Cloud Translation API.

Desplegar el servidor de aplicaciones de Genesys Cloud

Puedes configurar un servidor de aplicaciones para renderizar sugerencias de Asistente en la web en Genesys Cloud.

Objetivos

La integración de Genesys Cloud implica los siguientes procesos:

Despliega el servidor backend del módulo de interfaz de usuario para llamar a la API Dialogflow, registrar un token de autenticación y configurar Cloud Pub/Sub y Memorystore para Redis.
Despliega el servidor de aplicaciones de Genesys Cloud para renderizar el módulo de interfaz de usuario de Asistente en Cloud Run.
Crea un cliente de OAuth.
Completa las variables de entorno.
Configura el widget de interacción en Genesys Cloud.
Configura la integración de Asistente con IA con el widget de interacción en Genesys Cloud.
Configura Messenger en Genesys Cloud.
Usa las herramientas de chat web y mensajería de Genesys Cloud para probar la integración.

Antes de empezar

Debes completar las siguientes acciones antes de iniciar la integración de Genesys Cloud:

Instala la CLI de Google Cloud si aún no la has configurado.
Sigue las Google Cloud instrucciones para crear una cuenta de servicio y asignarle el rol de cliente de la API de Dialogflow.
Ponte en contacto con agent-assist-ui-modules-support@google.com para acceder al repositorio de Genesys Cloud.
Implementa un backend de módulos de interfaz de usuario de Asistencia con agentes. Cuando implemente el servidor backend, especifique que la variable de entorno AUTH_OPTION sea GenesysCloud siguiendo las instrucciones de implementación.

Desplegar el servidor de aplicaciones de Genesys Cloud mediante la CLI

Clona el repositorio de Git en tu máquina local o entorno de desarrollo con el siguiente código:
```
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
```
En tu terminal local, usa el siguiente código para cambiar el directorio activo al directorio raíz del repositorio donde se encuentra el archivo Docker antes de ejecutar las compilaciones de la CLI de Google Cloud.
```
cd genesyscloud/frontend
```
Cuando se te pida un nombre de servicio, pulsa Intro para aceptar el predeterminado.
Implementa la integración con el siguiente comando. Sustituye PROJECT-ID por el ID de proyecto de tu agente, Google Cloud por el correo del cliente de tu cuenta de servicio y define UI_MODULE_SERVICE_ACCOUNT para Cloud Run.REGION
```
gcloud run deploy $AA_MODULE_APPLICATION_SERVER 

--source ./ 

--service-account=$ui_module_service_account 

--memory 1Gi --platform managed 

--region us-central1 

--allow-unauthenticated 
```
Haz clic en Intro para aceptar el nombre de servicio predeterminado.

Para obtener más información, consulta la documentación de Cloud Run. En la consola de Google Cloud , puedes ver una lista de tus implementaciones de integración activas en Cloud Run.

Crear un cliente de OAuth

Sigue las instrucciones de la documentación de Genesys Cloud para crear un cliente de OAuth (Token Implicit Grant).
Asegúrate de que el tipo de concesión sea Concesión implícita (navegador).
Añade la URL de tu aplicación a la sección URIs de redirección autorizados.

Actualiza la duración del token de cliente de OAuth 2.0 a 3600 segundos. Esto coincide con el token JWT para el acceso a la API de Dialogflow, que es de 1 hora.

{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.

Sustituye CONVERSATION_PROFILE_NAME por el nombre del perfil de conversación, como projects/your-project/locations/your-location/conversationProfiles/abc123.
Sustituye {FEATURES} por una lista separada por comas de las funciones de Asistente que quieras que incluya la aplicación. Importante: Incluye solo las funciones configuradas en tu perfil de conversación. Genesys Cloud admite las siguientes funciones:
Para añadir ámbitos al cliente de OAuth, vaya a la sección Ámbito y seleccione las etiquetas.

Los ámbitos deben incluir alertas, autorización, conversaciones, notificaciones y organización.

URL de ejemplo:

https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION

Completa las variables de entorno

La aplicación Genesys Cloud usa las siguientes variables de entorno. Para definir las variables de entorno, sigue las instrucciones de Cloud Run.

OAUTH_CLIENT_ID: ID de cliente de OAuth de Genesys Cloud.
GENESYS_CLOUD_REGION: Región de Genesys Cloud. Por ejemplo, usw2.pure.cloud para el oeste de EE. UU. (Oregón). El valor predeterminado es mypurecloud.com.
GENESYS_CLOUD_ENVIRONMENT: entorno de Genesys Cloud. El valor predeterminado es prod.
PROXY_SERVER: URL del conector backend de Asistente.
APPLICATION_SERVER_URL: URL del servidor de aplicaciones de la interfaz de usuario.
PROJECT_ID: tu ID de proyecto Google Cloud .
CONVERSATION_PROFILE: el perfil de conversación que se va a usar. Debe coincidir con el perfil de la URL de redirección del cliente de OAuth.
FEATURES: constante separada por comas para las funciones de Agent Assist. Debe coincidir con las funciones de la URL de redireccionamiento del cliente de OAuth.
CHANNEL: elige el tipo de integración. El valor puede ser "voice" o "chat".

Archivo .env de ejemplo:

OAUTH_CLIENT_ID={your-oauth-client-id}
GENESYS_CLOUD_REGION={your-pure-cloud-region}
GENESYS_CLOUD_ENVIRONMENT={your-pure-cloud-environment}
PROXY_SERVER={your-proxy-server-endpoint}
PROJECT_ID={your-gcp-project-id}
CONVERSATION_PROFILE={your-conversation-profile}
FEATURES=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
CHANNEL={use-voice-or-chat}

Cuando creas un cliente de OAuth, Genesys Cloud también proporciona un ID de cliente.

Ejecuta el comando de implementación con las variables de entorno actualizadas.

    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 

    --source ./ 

    --service-account=$ui_module_service_account 

    --memory 1Gi --platform managed 

    --region us-central1 

    --allow-unauthenticated 

    --set-env-vars ^~^OAUTH_CLIENT_ID=$OAUTH_CLIENT_ID~GENESYS_CLOUD_REGION=$GENESYS_CLOUD_REGION~GENESYS_CLOUD_ENVIORNMENT=$GENESYS_CLOUD_ENVIORNMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL

El servidor de aplicaciones de Genesys Cloud debe desplegarse en un Google Cloud servicio de alojamiento. Usa App Engine o Cloud Run.

Apagar el servidor de aplicaciones

Elimina el servicio de Cloud Run.
En tu terminal local, ejecuta el siguiente comando:
```
gcloud run services list
```
Selecciona la plataforma de destino elegida anteriormente para ver las implementaciones activas.

Ejecuta el siguiente comando:

gcloud run services delete agent-assist-modules-application-server

Aviso sobre los precios

Si usas la integración de Genesys Cloud, hay un coste asociado al servicio subyacente Cloud Run.

Desplegar el servidor de aplicaciones de Genesys Cloud Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.