Panduan ini menguraikan langkah-langkah yang diperlukan untuk menyiapkan server proxy. Anda akan menggunakan server proxy bersama dengan server aplikasi untuk menyederhanakan autentikasi dengan Dialogflow API. Untuk petunjuk tentang cara merender modul UI di ruang kerja agen, lihat halaman tutorial LivePerson utama. Server aplikasi dan server proxy di direktori yang sama diperlukan sebelum Anda dapat merender modul di LivePerson.
Meskipun Anda dapat menyiapkan deployment integrasi ini di platform hosting mana pun, petunjuk ini menggunakan Cloud Run Google.
Sebelum memulai
Pastikan Anda telah men-deploy server aplikasi sebelum memulai tutorial ini.
Konfigurasi
Saat men-deploy layanan, Anda harus menentukan variabel lingkungan berikut.
Pastikan untuk mengosongkan variabel LP_CLIENT_ID dan LP_CLIENT_SECRET
saat Anda pertama kali membuat server aplikasi. LivePerson akan memberikan
variabel ini saat Anda
membuat aplikasi Conversational Cloud,
dan Anda akan memperbaruinya pada saat itu. Anda juga akan melewatkan
APPLICATION_SERVER_URL dan DF_PROXY_SERVER_URL di awal, yang ditetapkan setelah
server aplikasi dan proxy di-deploy serta menampilkan nilai
yang diperlukan.
LP_ACCOUNT_ID: ID akun LivePerson.LP_CLIENT_ID: Client ID LivePerson Anda. Ini akan disediakan oleh LivePerson setelah aplikasi Conversational Cloud diinstal. (Lewati variabel ini untuk saat ini, Anda akan memperbaruinya setelah informasi disediakan).LP_CLIENT_SECRET: Rahasia klien LivePerson Anda. Ini akan disediakan oleh LivePerson setelah aplikasi Conversational Cloud diinstal. (Lewati variabel ini untuk saat ini, Anda akan memperbaruinya setelah informasi disediakan).LP_SENTINEL_DOMAIN: Buka https://developers.liveperson.com/domain-api.html. Masukkan nomor akun Anda dan cari domain untuk "sentinel".LP_ACCOUNT_CONFIG_READONLY_DOMAIN: Buka https://developers.liveperson.com/domain-api.html. Masukkan nomor akun Anda dan cari domain untuk "accountConfigReadOnly".APPLICATION_SERVER_URL: URL server aplikasi UI.JWT_SECRET: Frasa "rahasia" yang akan digunakan untuk menandatangani token autentikasi. Anda dapat menggunakan frasa apa pun, meskipun secret acak yang panjang paling aman. Lihat praktik terbaik di https://fusionauth.io/learn/expert-advice/tokens/building-a-secure-jwt/#keys.
Contoh file .env:
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
Deploy
Server aplikasi UI harus di-deploy ke layanan hosting Google Cloud. Sebaiknya gunakan Google App Engine atau Cloud Run. Langkah-langkah di bawah menggunakan Cloud Run sebagai contoh.
Men-deploy menggunakan CLI
Di terminal lokal, ubah direktori aktif ke direktori root repositori.
Jalankan perintah berikut untuk menyimpan status repositori Anda ke dalam
Google Cloud Platform Container Registry. Ganti
PROJECT-ID dengan project ID Google Cloud Platform Anda.
gcloud builds submit --tag gcr.io/PROJECT-ID/agent-assist-modules-proxy-server
Deploy integrasi Anda untuk ditayangkan menggunakan perintah berikut. Ganti
PROJECT-ID dengan project ID Google Cloud Platform agen Anda, dan
SERVICE-ACCOUNT-EMAIL dengan email klien akun layanan Anda.
gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-proxy-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
- Saat diminta untuk memasukkan region, pilih region (misalnya,
us-central1). - Saat diminta memasukkan nama layanan, tekan enter untuk menerima nama default.
- Saat diminta untuk mengizinkan pemanggilan yang tidak diautentikasi, tekan
y.
Untuk mengetahui informasi selengkapnya, lihat dokumentasi Cloud Run. Anda dapat melihat daftar deployment integrasi aktif di bagian Cloud Run di Konsol Google Cloud Platform.
Variabel lingkungan
Ikuti petunjuk Cloud Run untuk menetapkan variabel lingkungan yang diperlukan.
Setelah layanan di-deploy, CLI akan menampilkan URL tempat
aplikasi di-deploy (target_url). Kembali dan tetapkan
variabel lingkungan DF_PROXY_SERVER_URL untuk server aplikasi menggunakan
nilai ini.
Menonaktifkan server proxy
Untuk mematikan server aplikasi, Anda harus menghapus layanan Cloud Run.
Di terminal lokal, jalankan perintah berikut dan pilih platform target yang sebelumnya dipilih untuk mencantumkan deployment aktif:
gcloud beta run services list
Selanjutnya, jalankan perintah berikut:
gcloud beta run services delete agent-assist-modules-proxy-server