Questa guida descrive i passaggi necessari per configurare un server proxy. Utilizzerai il server proxy insieme a un server delle applicazioni per semplificare l'autenticazione con l'API Dialogflow. 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 nella stessa directory.
Sebbene sia possibile configurare questo deployment dell'integrazione su qualsiasi piattaforma di hosting, queste istruzioni utilizzano Cloud Run di Google.
Prima di iniziare
Prima di iniziare questo tutorial, assicurati di aver già eseguito il deployment del server delle applicazioni.
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, impostandoli entrambi dopo che i server
delle applicazioni e proxy sono stati implementati e hanno restituito i valori
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 numero del tuo account e cerca il dominio per "accountConfigReadOnly".APPLICATION_SERVER_URL: URL del server delle applicazioni UI.JWT_SECRET: una frase "segreta" che verrà utilizzata per firmare i token di autenticazione. Puoi utilizzare qualsiasi frase, anche se una lunga sequenza casuale è la più sicura. Consulta le best practice all'indirizzo https://fusionauth.io/learn/expert-advice/tokens/building-a-secure-jwt/#keys.
File .env campione:
LP_ACCOUNT_ID = 12345678
LP_CLIENT_ID = abc-123-f0f0
LP_CLIENT_SECRET = abc123abc123abc123abc123
LP_SENTINEL_DOMAIN = va.sentinel.liveperson.net
LP_ACCOUNT_CONFIG_READONLY_DOMAIN = z1.acr.liveperson.net
APPLICATION_SERVER_URL = https://my-project.wm.r.appspot.com
JWT_SECRET = an_example_JWT_secret_phrase_please_use_something_better
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.
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-proxy-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-proxy-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 DF_PROXY_SERVER_URL per il server delle applicazioni utilizzando questo valore.
Arrestare il server proxy
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-proxy-server