Esegui il deployment del server applicazioni

Questa guida descrive i passaggi necessari per configurare un server delle applicazioni che puoi utilizzare per visualizzare i suggerimenti di Agent Assist in LivePerson. Il server delle applicazioni viene utilizzato con un server proxy nella stessa directory. Per istruzioni su come visualizzare i moduli dell'interfaccia utente nell'area di lavoro dell'agente, consulta la pagina principale del tutorial di LivePerson. Prima di poter visualizzare i moduli in LivePerson, sono necessari sia un server delle applicazioni sia un server proxy.

Sebbene sia possibile configurare il deployment di questa integrazione su qualsiasi piattaforma di hosting, queste istruzioni utilizzano Cloud Run di Google .

Configurazione

Quando esegui il deployment del servizio, devi definire le seguenti variabili di ambiente. Assicurati di lasciare vuote le variabili LP_CLIENT_ID e LP_CLIENT_SECRET quando crei inizialmente il server delle applicazioni. LivePerson fornirà queste variabili quando crei un'applicazione Conversational Cloud e le aggiornerai in quel momento. Inizialmente salterai anche APPLICATION_SERVER_URL e DF_PROXY_SERVER_URL. Ognuna di queste due variabili verrà impostata dopo che i server delle applicazioni e proxy sono stati sottoposti a deployment e hanno restituito i valori URL richiesti.

  • LP_ACCOUNT_ID: ID account LivePerson.
  • LP_CLIENT_ID: il tuo ID client LivePerson. Verrà fornito da LivePerson una volta installata l'applicazione Conversational Cloud. (Per il momento salta questa variabile, la aggiornerai una volta fornite le informazioni ).
  • LP_CLIENT_SECRET: il tuo client secret LivePerson. Verrà fornito da LivePerson una volta installata l'applicazione Conversational Cloud. (Per il momento salta questa variabile, la aggiornerai una volta fornite le informazioni).
  • LP_SENTINEL_DOMAIN: vai alla pagina https://developers.liveperson.com/domain-api.html. Inserisci il numero di conto bancario e cerca il dominio per "sentinel".
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: vai alla pagina https://developers.liveperson.com/domain-api.html. Inserisci il numero di conto bancario e cerca il dominio per "accountConfigReadOnly".
  • APPLICATION_SERVER_URL: URL del server delle applicazioni dell'interfaccia utente. (Per il momento salta questo passaggio e aggiorna dopo che il server delle applicazioni è stato sottoposto a deployment e conosci il suo URL).
  • DF_PROXY_SERVER_URL: l'URL del server proxy. (Per il momento salta questo passaggio e aggiorna dopo che il server proxy è stato sottoposto a deployment e conosci il suo URL).
  • PROJECT_ID: l'ID del tuo progetto Google Cloud. Non includere il prefisso projects/.

File .env di esempio:

    LP_ACCOUNT_ID = 12345678
    LP_CLIENT_ID = abc-123-f0f0
    LP_SENTINEL_DOMAIN = va.sentinel.liveperson.net
    LP_ACCOUNT_CONFIG_READONLY_DOMAIN = z1.acr.liveperson.net
    LP_CLIENT_SECRET = abc123abc123abc123abc123
    APPLICATION_SERVER_URL = https://my-project.wm.r.appspot.com
    DF_PROXY_SERVER_URL = https://proxy-server-dot-my-project.wm.r.appspot.com
    PROJECT_ID = my-project

Esegui il deployment

Il server delle applicazioni dell'interfaccia utente deve essere sottoposto a deployment in un servizio di hosting Google Cloud. Ti consigliamo di utilizzare Google App Engine o Cloud Run. I passaggi riportati di seguito utilizzano Cloud Run come esempio.

Configura gcloud CLI

Le procedure di deployment descritte in questo tutorial utilizzano i comandi gcloud CLI. Segui questi passaggi per configurare gcloud CLI in locale per questo deployment:

  1. Nella pagina della documentazione di gcloud CLI, seleziona il tuo sistema operativo e segui le istruzioni per l'installazione.
  2. Esegui gcloud config get-value project per controllare la configurazione del progetto Google Cloud Platform.
  3. Vai alle impostazioni dell'agente Dialogflow e controlla l'ID progetto associato all'agente. Il progetto Google Cloud configurato in gcloud CLI deve corrispondere all'ID progetto dell'agente.
  4. Se gli ID progetto non corrispondono, esegui gcloud config set project PROJECT-ID, sostituendo PROJECT-ID con l'ID progetto del passaggio 3.

Configura un account di servizio

Per il corretto funzionamento dell'integrazione, devi creare un service account nel tuo progetto Google Cloud Platform. Per maggiori dettagli, consulta la documentazione di Dialogflow.

Segui questi passaggi per creare un account di servizio e configurare l'integrazione:

  1. Seleziona il progetto Google Cloud Platform associato alle risorse di Agent Assist.
  2. Fai clic sul menu di navigazione nella console Google Cloud Platform, passa il mouse sopra IAM e amministrazione e fai clic su Service account.
  3. Fai clic su + CREA SERVICE ACCOUNT, inserisci i dettagli e assegna il ruolo Client API Dialogflow.

Abilita le API richieste

  1. Vai al progetto Google Cloud Platform che preferisci.
  2. Fai clic sul menu di navigazione nella console Google Cloud Platform e seleziona Fatturazione. Verifica che la fatturazione sia attivata per il tuo progetto.
  3. Abilita Cloud Build e l'API Cloud Run per questo progetto.
  4. Clona il seguente repository Git sulla tua macchina locale o sull'ambiente di sviluppo: git clone [repository url].
  5. Apri la directory principale del repository sulla tua macchina locale o sull'ambiente di sviluppo.

Esegui il deployment utilizzando l'interfaccia a riga di comando

Nel terminale locale, cambia la directory attiva impostandola sulla directory principale del repository.

Esegui il comando seguente per salvare lo stato del repository in Container Registry di Google Cloud. Sostituisci PROJECT-ID con l'ID del tuo progetto Google Cloud Platform.

    gcloud builds submit --tag gcr.io/PROJECT-ID/agent-assist-modules-application-server

Esegui il deployment dell'integrazione in produzione utilizzando il comando seguente. Sostituisci PROJECT-ID con l'ID progetto Google Cloud Platform dell'agente e SERVICE-ACCOUNT-EMAIL con l'indirizzo email del client del account di servizio.

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
  • Quando ti viene richiesta una regione, seleziona una regione (ad esempio, us-central1).
  • Quando ti viene richiesto un nome del servizio, premi Invio per accettare il valore predefinito.
  • Quando ti viene chiesto di consentire chiamate non autenticate, premi y.

Per ulteriori informazioni, consulta la documentazione di Cloud Run. Puoi visualizzare un elenco dei deployment di integrazione attivi in Cloud Run nella console di Google Cloud Platform.

Variabili di ambiente

Segui le istruzioni di Cloud Run per impostare le variabili di ambiente necessarie.

Una volta eseguito il deployment del servizio, l'interfaccia a riga di comando restituirà l'URL su cui è stato eseguito il deployment dell'applicazione (target_url). Torna indietro e imposta la variabile di ambiente APPLICATION_SERVER_URL utilizzando questo valore.

Arresta il server delle applicazioni

Per arrestare il server delle applicazioni, devi eliminare il servizio Cloud Run.

Nel terminale locale, esegui il comando seguente e seleziona la piattaforma di destinazione scelta in precedenza per elencare i deployment attivi:

    gcloud beta run services list

Quindi, esegui il comando seguente:

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