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 delle applicazioni viene utilizzato con un server proxy nella stessa directory. Per istruzioni sul rendering dei moduli UI nello spazio di lavoro dell'agente, consulta la pagina principale del tutorial di LivePerson. Prima di poter eseguire il rendering dei moduli in LivePerson, sono necessari sia un server delle 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 le aggiornerai in quel momento. Inizialmente verranno saltati anche APPLICATION_SERVER_URL
e DF_PROXY_SERVER_URL
. Ciascuna di queste due variabili verrà impostata dopo che i server delle applicazioni e proxy sono stati implementati 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 ora ignora questa variabile, la aggiornerai una volta fornite le informazioni).LP_CLIENT_SECRET
: il client secret di LivePerson. Verrà fornito da LivePerson una volta installata l'applicazione Conversational Cloud. Per ora ignora questa variabile, 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 account e cerca il dominio "sentinel".LP_ACCOUNT_CONFIG_READONLY_DOMAIN
: vai a https://developers.liveperson.com/domain-api.html. Inserisci il tuo numero di account e cerca il dominio per "accountConfigReadOnly
".APPLICATION_SERVER_URL
: URL del server delle applicazioni UI. (Salta per ora e aggiorna dopo il deployment del server delle applicazioni e quando conosci il suo 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 l'URL.)PROJECT_ID
: l'ID del tuo progetto Google Cloud. Non includere il prefissoprojects/
.
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 implementato 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. Per configurare l'interfaccia alla gcloud CLI in locale per questo deployment:
- Nella pagina della documentazione di gcloud CLI, seleziona il tuo sistema operativo e segui le istruzioni per l'installazione.
- Esegui
gcloud config get-value project
per controllare la configurazione del progetto Google Cloud Platform. - 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.
- Se gli ID progetto non corrispondono, esegui
gcloud config set project PROJECT-ID
, sostituendoPROJECT-ID
con l'ID progetto del passaggio 3.
Configura un service account
Perché l'integrazione funzioni correttamente, 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:
- Seleziona il progetto Google Cloud Platform associato alle risorse di Agent Assist.
- Fai clic sul menu di navigazione nella console Google Cloud Platform, passa il mouse sopra IAM e amministrazione e fai clic su Service account.
- Fai clic su + CREA SERVICE ACCOUNT, compila i dettagli e assegna il ruolo Client API Dialogflow.
Abilita le API richieste
- Vai al progetto Google Cloud Platform che preferisci.
- Fai clic sul menu di navigazione nella console Google Cloud Platform e seleziona Fatturazione. Verifica che la fatturazione sia attivata per il tuo progetto.
- Abilita Cloud Build e l'API Cloud Run per questo progetto.
- Clona il seguente repository Git sulla macchina locale o sull'ambiente di sviluppo:
git clone [repository url]
. - Apri la directory radice del repository sulla macchina locale o nell'ambiente di sviluppo.
Esegui il deployment utilizzando l'interfaccia a riga di comando
Nel terminale locale, cambia la directory attiva impostandola sulla directory radice del repository.
Esegui il seguente comando per salvare lo stato del repository in
Google Cloud Platform Container Registry. 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 nell'ambiente di produzione utilizzando il comando seguente. Sostituisci
PROJECT-ID
con l'ID progetto Google Cloud Platform del tuo agente e
SERVICE-ACCOUNT-EMAIL
con l'email del client del tuo 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 chiesto un nome di servizio, premi Invio per accettare il valore 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, la CLI 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.
Arrestare 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 questo comando:
gcloud beta run services delete agent-assist-modules-application-server