Halaman ini diterjemahkan oleh Cloud Translation API.

Men-deploy server aplikasi Genesys Cloud

Anda dapat menyiapkan server aplikasi untuk merender saran Agent Assist di web di Genesys Cloud.

Tujuan

Integrasi Genesys Cloud melibatkan proses berikut:

Deploy server backend untuk modul UI guna memanggil Dialogflow API, mendaftarkan token autentikasi, dan menyiapkan Pub/Sub cloud dan Memorystore untuk Redis.
Deploy server aplikasi Genesys Cloud untuk merender modul UI Agent Assist di Cloud Run.
Buat klien OAuth.
Lengkapi variabel lingkungan.
Siapkan widget interaksi di Genesys Cloud.
Konfigurasikan integrasi Agent Assist dengan widget interaksi di Genesys Cloud.
Mengonfigurasi Messenger di Genesys Cloud.
Gunakan alat pesan dan chat web Genesys Cloud untuk menguji integrasi.

Sebelum memulai

Anda harus menyelesaikan tindakan berikut sebelum memulai integrasi Genesys Cloud:

Instal Google Cloud CLI, jika Anda belum mengonfigurasinya.
Ikuti Google Cloud petunjuk untuk membuat akun layanan dan menetapkan peran klien Dialogflow API.
Hubungi agent-assist-ui-modules-support@google.com untuk mendapatkan akses ke repositori Genesys Cloud.
Men-deploy backend modul UI Agent Assist. Saat Anda men-deploy server backend, tentukan variabel lingkungan AUTH_OPTION menjadi GenesysCloud, dengan mengikuti petunjuk deployment.

Men-deploy server aplikasi Genesys Cloud menggunakan CLI

Clone repositori git ke komputer lokal atau lingkungan pengembangan Anda dengan kode berikut:
```
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
```
Di terminal lokal, gunakan kode berikut untuk mengubah direktori aktif ke direktori root repositori tempat file Docker berada sebelum menjalankan build Google Cloud CLI.
```
cd genesyscloud/frontend
```
Saat diminta memasukkan nama layanan, tekan Enter untuk menerima nama default.

Deploy integrasi menggunakan perintah berikut. Ganti PROJECT-ID dengan Google Cloud project ID agen Anda, UI_MODULE_SERVICE_ACCOUNT dengan email klien akun layanan Anda, dan tetapkan REGION untuk Cloud Run.

gcloud run deploy $AA_MODULE_APPLICATION_SERVER 

--source= ./ 

--service-account=$ui_module_service_account 

--memory 1Gi --platform managed 

--region us-central1 

--allow-unauthenticated

Klik Enter untuk menyetujui nama layanan default.

Untuk mengetahui detailnya, lihat dokumentasi Cloud Run. Di Google Cloud konsol, Anda dapat melihat daftar deployment integrasi aktif di bagian Cloud Run.

Membuat klien OAuth

Ikuti petunjuk dalam dokumentasi Genesys Cloud untuk membuat klien OAuth baru (Token Implicit Grant).
Pastikan jenis hibah adalah Implicit Grant (Browser).
Tambahkan URL aplikasi Anda ke bagian Authorized redirect URIs.

Perbarui durasi token klien Oauth 2.0 menjadi 3.600 detik. Ini cocok dengan token JWT untuk akses Dialogflow API selama 1 jam.

{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.

Ganti CONVERSATION_PROFILE_NAME dengan nama profil percakapan, seperti projects/your-project/locations/your-location/conversationProfiles/abc123.
Ganti FEATURES dengan daftar fitur Agent Assist yang dipisahkan koma yang ingin Anda sertakan dalam aplikasi. Hanya sertakan fitur yang dikonfigurasi di profil percakapan Anda. Genesys Cloud mendukung fitur berikut

Contoh URL:

https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION

Menyelesaikan variabel lingkungan

Aplikasi Genesys Cloud menggunakan variabel lingkungan berikut. Untuk menetapkan variabel lingkungan, ikuti petunjuk Cloud Run.

OAUTH_CLIENT_ID: Client ID OAuth Genesys Cloud.
GENESYS_CLOUD_REGION: Region Genesys Cloud. Misalnya, usw2.pure.cloud untuk Amerika Serikat Barat(Oregon). Nilai defaultnya adalah mypurecloud.com.
GENESYS_CLOUD_ENVIRONMENT: Lingkungan cloud Genesys. Nilai defaultnya adalah prod.
PROXY_SERVER: URL konektor backend Agent Assist.
APPLICATION_SERVER_URL: URL server aplikasi UI.
PROJECT_ID: Google Cloud Project ID Anda.
CONVERSATION_PROFILE: Profil percakapan yang akan digunakan. Ini harus cocok dengan profil di URL alihan klien OAuth.
FEATURES: Konstanta yang dipisahkan koma untuk fitur Agent Assist. Hal ini harus cocok dengan fitur di URL alihan klien OAuth.
CHANNEL: Pilih jenis integrasi, nilainya dapat berupa "voice" atau "chat".

Contoh file .env:

OAUTH_CLIENT_ID={your-oauth-client-id}
GENESYS_CLOUD_REGION={your-pure-cloud-region}
GENESYS_CLOUD_ENVIRONMENT={your-pure-cloud-environment}
PROXY_SERVER={your-proxy-server-endpoint}
PROJECT_ID={your-gcp-project-id}
CONVERSATION_PROFILE={your-conversation-profile}
FEATURES=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
CHANNEL={use-voice-or-chat}

Saat Anda membuat klien OAuth, Genesys Cloud juga akan memberikan client ID.

Jalankan perintah deployment dengan variabel lingkungan yang telah diperbarui.

    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 

    --source ./ 

    --service-account=$ui_module_service_account 

    --memory 1Gi --platform managed 

    --region us-central1 

    --allow-unauthenticated 

    --set-env-vars ^~^OAUTH_CLIENT_ID=$OAUTH_CLIENT_ID~GENESYS_CLOUD_REGION=$GENESYS_CLOUD_REGION~GENESYS_CLOUD_ENVIORNMENT=$GENESYS_CLOUD_ENVIORNMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL

Server aplikasi Genesys Cloud harus di-deploy ke Google Cloud layanan hosting. Gunakan App Engine atau Cloud Run.

Menonaktifkan server aplikasi

Hapus layanan Cloud Run.
Di terminal lokal, jalankan perintah berikut:
```
gcloud run services list
```
Pilih platform target yang dipilih sebelumnya untuk mencantumkan deployment aktif.

Jalankan perintah berikut:

gcloud run services delete agent-assist-modules-application-server