Esegui il deployment del server applicazioni

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

Sebbene sia possibile configurare questo deployment di 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 l'application server. 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 il deployment dei server proxy e dell'applicazione e la restituzione dei valori URL richiesti.

  • LP_ACCOUNT_ID: ID account LivePerson.
  • LP_CLIENT_ID: il tuo ID client LivePerson. Questo valore verrà fornito da LivePerson una volta installata l'applicazione Conversational Cloud. (Per il momento, ignora questa variabile, che aggiornerai una volta fornite le informazioni).
  • LP_CLIENT_SECRET: il tuo client secret LivePerson. Questo verrà fornito da LivePerson una volta installata l'applicazione Conversational Cloud. (Salta questa variabile per il momento, la aggiornerai una volta fornite le informazioni).
  • LP_SENTINEL_DOMAIN: vai alla pagina https://developers.liveperson.com/domain-api.html. Inserisci il tuo 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: l'URL del server dell'applicazione UI. (Salta questo passaggio per il momento ed esegui l'aggiornamento dopo aver eseguito il deployment del server applicazioni e averne ottenuto l'URL).
  • DF_PROXY_SERVER_URL: l'URL del server proxy. (Salta per ora e aggiorna dopo aver eseguito il deployment del server proxy e averne ottenuto l'URL).
  • PROJECT_ID: l'ID del tuo progetto Google Cloud. Non includere il prefisso projects/.

File .env campione:

    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 UI deve essere distribuito 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

I processi di deployment descritti in questo tutorial utilizzano i comandi gcloud CLI. Segui i passaggi riportati di seguito per configurare gcloud CLI localmente 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 Platform configurato nell'interfaccia a riga di comando 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.

Configura un service account

Per il corretto funzionamento dell'integrazione, devi creare un service account nel tuo progetto Google Cloud Platform. Per ulteriori 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 tue risorse Agent Assist.
  2. Fai clic sul menu di navigazione nella console di Google Cloud Platform, passa il mouse sopra IAM e amministrazione e fai clic su Service account.
  3. Fai clic su + CREA SERVICE ACCOUNT, compila i dettagli e assegna il ruolo API client Dialogflow.

Abilita le API richieste

  1. Vai al progetto Google Cloud Platform desiderato.
  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 nel tuo ambiente di sviluppo: git clone [repository url].
  5. Apri la directory root del repository sulla tua macchina locale o nel tuo ambiente di sviluppo.

Crea un repository Docker in Artifact Registry

Utilizza il comando gcloud artifacts repositories create per creare un repository Docker, in cui salverai lo stato del tuo repository:

gcloud artifacts repositories create REPOSITORY-NAME --repository-format=docker --location=LOCATION

Sostituisci quanto segue:

  • REPOSITORY-NAME: il nome del repository Docker.
  • LOCATION: la località Google Cloud in cui vuoi creare il repository Docker.

Esegui il deployment utilizzando l'interfaccia a riga di comando

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

Utilizza il comando gcloud builds submit per salvare lo stato del repository in Google Cloud Artifact Registry:

gcloud builds submit --tag=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-NAME/agent-assist-modules-application-server

Sostituisci quanto segue:

  • LOCATION: la località Google Cloud in cui hai creato il repository Docker.
  • PROJECT-ID: l'ID del progetto Google Cloud in cui hai creato il repository Docker.
  • REPOSITORY-NAME: il nome del repository Docker.

Esegui il deployment dell'integrazione in produzione utilizzando il comando gcloud run deploy:

gcloud run deploy --image=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-NAME/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory=1Gi

Sostituisci quanto segue:

  • LOCATION: la località Google Cloud in cui hai creato il repository Docker.
  • PROJECT-ID: l'ID del progetto Google Cloud in cui hai creato il repository Docker.
  • REPOSITORY-NAME: il nome del repository Docker.
  • SERVICE-ACCOUNT-EMAIL: l'indirizzo email del client del account di servizio.

Durante l'esecuzione del comando, segui questi passaggi:

  1. Quando ti viene richiesta una regione, selezionala (ad esempio us-central1).
  2. Quando ti viene chiesto un nome di servizio, premi Invio per accettare il valore predefinito.
  3. 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 restituirà l'URL in 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 applicazioni

Per arrestare l'application server, 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