Questa guida illustra i passaggi necessari per configurare un server proxy. Utilizzerai il server proxy in combinazione con un server di applicazioni per semplificare l'autenticazione con l'API Dialogflow. Per istruzioni su come eseguire il 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 di 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à implementato il 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 potrai aggiornarle in quel momento. Inoltre, inizialmente ignorerai APPLICATION_SERVER_URL e DF_PROXY_SERVER_URL, impostandoli entrambi dopo aver disegnato i server proxy e di applicazione e aver restituito i valori 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 "accountConfigReadOnly" nel dominio.APPLICATION_SERVER_URL: l'URL del server dell'applicazione dell'interfaccia utente.JWT_SECRET: una frase "segreta" che verrà utilizzata per firmare i token di autenticazione. Puoi utilizzare qualsiasi frase, anche se un segreto lungo e casuale è più sicuro. Consulta le best practice all'indirizzo https://fusionauth.io/learn/expert-advice/tokens/building-a-secure-jwt/#keys.
File .env di esempio:
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 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.
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-proxy-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-proxy-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 disegnato il servizio, la CLI mostrerà l'URL su cui è stata disegnato l'applicazione (target_url). Torna indietro e imposta la variabile di ambiente DF_PROXY_SERVER_URL per il server di applicazioni utilizzando questo valore.
Arresta il server proxy
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-proxy-server