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:

  1. Esegui il deployment del server di backend per il modulo UI per chiamare l'API Dialogflow, registrare un token di autenticazione e configurare Cloud Pub/Sub e Memorystore for Redis.
  2. Esegui il deployment del server delle applicazioni Genesys Cloud per il rendering del modulo dell'interfaccia utente di Assistente agente in Cloud Run.
  3. Crea un client OAuth.
  4. Completa le variabili di ambiente.
  5. Configura il widget di interazione in Genesys Cloud.
  6. Configura l'integrazione di Agent Assist con il widget di interazione in Genesys Cloud.
  7. Configura Messenger in Genesys Cloud.
  8. 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:

  1. Installa Google Cloud CLI se non l'hai ancora configurata.
  2. Segui le istruzioni Google Cloud per creare un service account e assegnare il ruolo di client API Dialogflow.
  3. Contatta l'indirizzo agent-assist-ui-modules-support@google.com per accedere al repository Genesys Cloud.
  4. Esegui il deployment di un backend dei moduli UI di Agent Assist. Quando esegui il deployment del server di backend, specifica che la variabile di ambiente AUTH_OPTION deve essere GenesysCloud, seguendo le istruzioni per il deployment.

Esegui il deployment del server delle applicazioni Genesys Cloud utilizzando la CLI

  1. 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
    
  2. 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
    
  3. Quando ti viene chiesto un nome del servizio, premi Invio per accettare il valore predefinito.
  4. 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'email 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
  5. 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

  1. Segui le istruzioni nella documentazione di Genesys Cloud per creare un nuovo client OAuth (Token Implicit Grant).
  2. Assicurati che il tipo di autorizzazione sia Autorizzazione implicita (browser).
  3. Aggiungi l'URL dell'applicazione alla sezione URI di reindirizzamento autorizzati.
  4. Aggiorna la durata del token client OAuth 2.0 a 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.
    
  5. Sostituisci CONVERSATION_PROFILE_NAME con il nome del profilo conversazionale, ad esempio projects/your-project/locations/your-location/conversationProfiles/abc123.
  6. Sostituisci {FEATURES} con un elenco separato da virgole delle funzionalità di Assistente Agente che vuoi includere nell'applicazione. Importante: includi solo le funzionalità configurate nel tuo profilo conversazione. Genesys Cloud supporta le seguenti funzionalità
  7. Per aggiungere ambiti al client OAuth, vai alla sezione Ambito e seleziona i tag.

. Gli ambiti devono includere avvisi, autorizzazione, conversazioni, notifiche e organizzazione.

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 Stati Uniti occidentali(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: URL del server delle applicazioni UI.
  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • CONVERSATION_PROFILE: il profilo della 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 delle applicazioni Genesys Cloud deve essere implementato in un servizio di hosting. Google Cloud Utilizza App Engine o Cloud Run.

Arrestare il server delle applicazioni

  1. Elimina il servizio Cloud Run.
  2. Nel terminale locale, esegui questo comando:
    gcloud run services list
    
  3. Seleziona la piattaforma di destinazione scelta in precedenza per visualizzare gli deployment attivi.
  4. Esegui questo comando:
    gcloud run services delete agent-assist-modules-application-server
    

Disclaimer sui prezzi

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

Passaggi successivi