Esegui il deployment del server delle applicazioni Genesys Cloud

Puoi configurare un server delle applicazioni per il rendering dei suggerimenti di Agent Assist sul web in Genesys Cloud.

Obiettivi

L'integrazione di Genesys Cloud prevede i seguenti processi:

Esegui il deployment del server di backend per il modulo dell'UI per chiamare l'API Dialogflow, registra un token di autenticazione e configura Cloud Pub/Sub e Memorystore for Redis.
Esegui il deployment del server delle applicazioni Genesys Cloud per il rendering del modulo dell'UI di Agent Assist in Cloud Run.
Crea un client OAuth.
Completa le variabili di ambiente.
Configura il widget di interazione in Genesys Cloud.
Configura l'integrazione di Agent Assist con il widget di interazione in Genesys Cloud.
Configura Messenger in Genesys Cloud.
Utilizza gli strumenti di chat web e messaggistica di Genesys Cloud per testare l'integrazione.

Prima di iniziare

Prima di iniziare l'integrazione di Genesys Cloud, devi completare le seguenti azioni:

Installa Google Cloud CLI, se non l'hai ancora configurato.
Segui le Google Cloud istruzioni per creare un account di servizio e assegnare il ruolo di client API Dialogflow.
Scrivi all'indirizzo agent-assist-ui-modules-support@google.com per accedere al repository Genesys Cloud.
Esegui il deployment di un backend dei moduli dell'UI di Agent Assist backend. Quando esegui il deployment del server di backend, specifica la variabile di ambiente AUTH_OPTION come GenesysCloud, seguendo le istruzioni di deployment.

Esegui il deployment del server delle applicazioni Genesys Cloud utilizzando CLI

Clona il repository Git sulla tua macchina locale o sull'ambiente di sviluppo con il seguente codice:
```
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
```
Nel terminale locale, utilizza il seguente codice per modificare la directory attiva nella directory principale del repository in cui si trova il file Docker prima di eseguire le build di Google Cloud CLI.
```
cd genesyscloud/frontend
```
Quando ti viene richiesto un nome del servizio, premi Invio per accettare il valore predefinito.
Esegui il deployment dell'integrazione utilizzando il seguente comando. Sostituisci PROJECT-ID con l'ID progetto dell'agente Google Cloud , UI_MODULE_SERVICE_ACCOUNT con l'indirizzo email del client del tuo account di servizio e imposta REGION per Cloud Run.
```
gcloud run deploy $AA_MODULE_APPLICATION_SERVER 

--source ./ 

--service-account=$ui_module_service_account 

--memory 1Gi --platform managed 

--region us-central1 

--allow-unauthenticated 
```
Fai clic su Invio per accettare il nome del servizio predefinito.

Per maggiori dettagli, consulta la documentazione di Cloud Run. Nella Google Cloud console, puoi visualizzare un elenco dei deployment di integrazione attivi in Cloud Run.

Crea un client OAuth

Segui le istruzioni nella documentazione di Genesys Cloud per creare un nuovo client OAuth.
Assicurati che il tipo di autorizzazione sia Autorizzazione del codice / PKCE.
Aggiungi l'URL dell'applicazione alla sezione URI di reindirizzamento autorizzati.
Aggiorna la durata del token client OAuth 2.0 a 3600 secondi. Corrisponde alla durata predefinita di 1 ora del token JWT per l'accesso all'API Dialogflow. Se hai bisogno di una durata personalizzata, aggiorna di conseguenza la durata del token OAuth e JWT.
```
{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}
```
Sostituisci {APPLICATION_SERVER_URL} con l'URL del server delle applicazioni dell'UI.
Sostituisci CONVERSATION_PROFILE_NAME con il nome del profilo di conversazione, ad esempio projects/your-project/locations/your-location/conversationProfiles/abc123.
Sostituisci {FEATURES} con un elenco separato da virgole delle funzionalità di Agent Assist che vuoi includere nell'applicazione. Importante: includi solo le funzionalità configurate nel profilo di conversazione. Genesys Cloud supporta le seguenti funzionalità
Per aggiungere ambiti al client OAuth, vai alla sezione Ambiti.
Seleziona i seguenti ambiti: alerting, authorization, conversations, notifications, messaging e organization.

URL di esempio:

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

Ti consigliamo di attivare l'autenticazione popup per gli iframe incorporati per garantire un'esperienza di accesso senza interruzioni.

Completa le variabili di ambiente

L'applicazione Genesys Cloud utilizza le seguenti variabili di ambiente. Per impostare le variabili di ambiente, segui le istruzioni di Cloud Run.

OAUTH_CLIENT_ID: ID client OAuth di Genesys Cloud.
GENESYS_CLOUD_REGION: regione di Genesys Cloud. Ad esempio, usw2.pure.cloud per Stati Uniti occidentali(Oregon). Il valore predefinito è mypurecloud.com.
GENESYS_CLOUD_ENVIRONMENT: ambiente di Genesys Cloud. Il valore predefinito è prod.
PROXY_SERVER: l'URL del connettore di backend di Agent Assist.
APPLICATION_SERVER_URL: l'URL del server delle applicazioni dell'UI.
PROJECT_ID: l' Google Cloud ID progetto.
CONVERSATION_PROFILE: il profilo di conversazione da utilizzare. Deve corrispondere al profilo nell'URL di reindirizzamento del client OAuth.
FEATURES: costante separata da virgole per le funzionalità di Agent Assist. Deve corrispondere alle funzionalità nell'URL di reindirizzamento del client OAuth.
CHANNEL: scegli il tipo di integrazione, il valore può essere "voice" o "chat".

File .env di esempio:

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}

Quando crei un client OAuth, Genesys Cloud fornisce anche un ID client.

Esegui il comando di deployment con le variabili di ambiente aggiornate.

    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_ENVIRONMENT=$GENESYS_CLOUD_ENVIRONMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL

Il server delle applicazioni Genesys Cloud deve essere sottoposto a deployment in un Google Cloud servizio di hosting. Utilizza App Engine o Cloud Run.

Arresta il server delle applicazioni

Elimina il servizio Cloud Run.
Nel terminale locale, esegui il seguente comando:
```
gcloud run services list
```
Seleziona la piattaforma di destinazione scelta in precedenza per elencare i deployment attivi.

Esegui il seguente comando:

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

Dichiarazione di non responsabilità sui prezzi

Se utilizzi l'integrazione di Genesys Cloud, è previsto un costo associato al servizio Cloud Run sottostante.

Esegui il deployment del server delle applicazioni Genesys Cloud Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.