Questa pagina è stata tradotta dall'API Cloud Translation.

Esegui il deployment del server delle applicazioni Genesys Cloud

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

Obiettivi

L'integrazione di Genesys Cloud prevede le seguenti procedure:

Esegui il deployment del server di backend per il modulo dell'interfaccia utente in modo che chiami l'API Dialogflow, registri un token di autenticazione e configuri Cloud Pub/Sub e Memorystore per Redis.
Esegui il deployment del server delle applicazioni Genesys Cloud per il rendering del modulo dell'interfaccia utente 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 messaggistica e chat web 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 già configurato.
Segui le istruzioni di Google Cloud per creare un account di servizio e assegnare il ruolo client dell'API Dialogflow.
Contatta agent-assist-ui-modules-support@google.com per accedere al repository di Genesys Cloud.
Esegui il deployment di un backend dei moduli dell'interfaccia utente di Agent Assist. 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 la CLI

Clona il repository Git sulla tua macchina locale o nel tuo 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 chiesto un nome del servizio, premi Invio per accettare quello predefinito.
Esegui il deployment dell'integrazione utilizzando il seguente comando. Sostituisci PROJECT-ID con l'ID progetto Google Cloud del tuo agente, UI_MODULE_SERVICE_ACCOUNT con l'indirizzo email del cliente 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 console Google Cloud , puoi visualizzare un elenco dei deployment di integrazione attivi in Cloud Run.

Creare un client OAuth

Segui le istruzioni riportate nella documentazione di Genesys Cloud per creare un nuovo client OAuth (concessione implicita del token).
Assicurati che il tipo di autorizzazione sia Autorizzazione implicita (browser).
Aggiungi l'URL dell'applicazione alla sezione URI di reindirizzamento autorizzati.

Aggiorna la durata del token client OAuth 2.0 su 3600 secondi. Corrisponde al token JWT per l'accesso all'API Dialogflow di 1 ora.

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

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 che l'applicazione includa. Includi solo le funzionalità configurate nel profilo della conversazione. Genesys Cloud supporta le seguenti funzionalità

URL di esempio:

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

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 Genesys Cloud. Ad esempio, usw2.pure.cloud per la costa occidentale degli Stati Uniti(Oregon). Il valore predefinito è mypurecloud.com.
GENESYS_CLOUD_ENVIRONMENT: ambiente cloud Genesys. Il valore predefinito è prod.
PROXY_SERVER: l'URL del connettore di backend di Agent Assist.
APPLICATION_SERVER_URL: l'URL del server dell'applicazione dell'interfaccia utente.
PROJECT_ID: l'ID del tuo progetto Google Cloud .
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_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

Il server di applicazioni Genesys Cloud deve essere dipiegato in un servizio di hosting Google Cloud . 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 questo comando:

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