Esegui il deployment del server applicazioni

Questa guida illustra i passaggi necessari per configurare un server applicazioni che puoi utilizzare per visualizzare i suggerimenti di Agent Assist in LivePerson. Il server di applicazioni viene utilizzato con un server proxy nella stessa directory. Per istruzioni sul rendering dei moduli dell'interfaccia utente nello spazio di lavoro dell'agente, consulta la pagina principale del tutorial di LivePerson. Per poter visualizzare i moduli in LivePerson sono necessari sia un server applicazioni sia un server proxy.

Sebbene sia possibile configurare questo deployment dell'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 potrai aggiornarle in quel momento. Inoltre, inizialmente salterai APPLICATION_SERVER_URL e DF_PROXY_SERVER_URL. Ognuna di queste due variabili verrà impostata dopo che i server proxy e dell'applicazione sono stati dimessi 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 dopo l'installazione dell'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 dopo l'installazione dell'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 del tuo account e cerca il dominio "sentinel".
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: vai a https://developers.liveperson.com/domain-api.html. Inserisci il numero del tuo account e cerca il dominio per "accountConfigReadOnly".
  • APPLICATION_SERVER_URL: l'URL del server dell'applicazione dell'interfaccia utente. (Per il momento salta questo passaggio e aggiornalo dopo aver eseguito il deployment del server dell'applicazione e aver conosciuto il relativo URL).
  • DF_PROXY_SERVER_URL: l'URL del server proxy. Per il momento, salta questo passaggio e aggiornalo dopo aver eseguito il deployment del server proxy e aver conosciuto il relativo 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 dell'applicazione UI deve essere dipiegato 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.

Configurare unagcloud CLI

Le procedure di deployment descritte in questo tutorial utilizzano i comandi gcloud CLI. Per configurare l'interfaccia alla gcloud CLI in locale per questo dispiegamento:

  1. Nella pagina della documentazione dell'interfaccia a riga di comando gcloud, 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 della Google Cloud Platform.
  3. Vai alle impostazioni dell'agente Dialogflow e controlla l'ID progetto associato all'agente. Il progetto Google Cloud configurato nella CLI gcloud 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.

Configurare un account di servizio

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

Per creare un account di servizio e configurare l'integrazione:

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

Abilita le API richieste

  1. Vai al progetto Google Cloud Platform che ti interessa.
  2. Fai clic sul menu di navigazione nella console della 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 nell'ambiente di sviluppo: git clone [repository url].
  5. Apri la directory principale del repository sulla tua macchina locale o nell'ambiente di sviluppo.

Esegui il deployment utilizzando l'interfaccia a riga di comando

Nel terminale locale, imposta la directory attiva sulla directory radice del repository.

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

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

Esegui il deployment dell'integrazione utilizzando il seguente comando. Sostituisci PROJECT-ID con l'ID progetto Google Cloud Platform del tuo agente e SERVICE-ACCOUNT-EMAIL con l'email del cliente dell'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 chiesto di selezionare una regione, scegli una regione (ad esempio us-central1).
  • Quando ti viene chiesto un nome del servizio, premi Invio per accettare quello predefinito.
  • Quando ti viene chiesto di consentire chiamate non autenticate, premi y.

Per saperne di più, 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 mostrerà l'URL a 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 dell'applicazione, devi eliminare il servizio Cloud Run.

Nel terminale locale, esegui il seguente comando 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