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, serta menyiapkan cloud Pub/Sub dan Memorystore for 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.
Konfigurasi integrasi Agent Assist dengan widget interaksi di Genesys Cloud.
Konfigurasi Messenger di Genesys Cloud.
Gunakan alat chat web dan pesan 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 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 project ID Google Cloud 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 menerima nama layanan default.

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

Buat klien OAuth

Ikuti petunjuk dalam dokumentasi Genesys Cloud untuk membuat klien OAuth baru (Token Implicit Grant).
Pastikan jenis pemberian akses 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 API Dialogflow 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. Penting: Hanya sertakan fitur yang dikonfigurasi di profil percakapan Anda. Genesys Cloud mendukung fitur berikut
Untuk menambahkan cakupan ke klien oauth, buka bagian Cakupan dan pilih tag Anda.

. Cakupan harus mencakup pemberitahuan, otorisasi, percakapan, notifikasi, dan organisasi.

Contoh URL:

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

Lengkapi 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 US West(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: ID project Google Cloud Anda.
CONVERSATION_PROFILE: Profil percakapan yang akan digunakan. Ini harus cocok dengan profil di URL pengalihan klien OAuth.
FEATURES: Konstanta yang dipisahkan koma untuk fitur Agent Assist. Ini harus cocok dengan fitur di URL pengalihan klien OAuth.
CHANNEL: Pilih jenis integrasi, nilainya bisa 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 memberikan client ID.

Jalankan perintah deployment dengan variabel lingkungan yang telah diupdate.

    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.

Nonaktifkan server aplikasi

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

Jalankan perintah berikut:

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

Pernyataan penyangkalan harga

Jika Anda menggunakan integrasi Genesys Cloud, ada biaya yang terkait dengan layanan Cloud Run yang mendasarinya.

Men-deploy server aplikasi Genesys Cloud Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.