Google Cloud CCaaS

Panduan ini memandu Anda melalui proses menghubungkan aplikasi agen ke instance Google Cloud CCaaS.

Sebelum memulai

  1. Ikuti langkah-langkah di halaman penyiapan dan pembersihan untuk membuat atau mengonfigurasi project yang ingin Anda gunakan untuk deployment. Project ini harus dikaitkan dengan aplikasi agen dan instance Google Cloud CCaaS Anda, serta berada di region yang sama. Periksa project Anda untuk memastikan hal berikut:
    • Dialogflow API diaktifkan.
    • Akun layanan yang akan Anda gunakan untuk deployment memiliki izin Dialogflow API Admin (roles/dialogflow.admin).
  2. Buat dan konfigurasi aplikasi agen CX Agent Studio untuk digunakan dalam deployment.
  3. Buat dan konfigurasi pusat kontak Google Cloud CCaaS untuk digunakan dalam deployment.
  4. Pastikan streaming dua arah diaktifkan di instance pusat kontak Anda, seperti yang diinstruksikan dalam dokumentasi integrasi CX Agent Studio dengan Google Cloud CCaaS.
  5. Cuplikan kode dalam panduan ini mengasumsikan bahwa Anda telah menginstal gcloud CLI dan mengonfigurasi izin yang diperlukan.

Menghubungkan aplikasi agen ke profil percakapan baru

Google Cloud CCaaS menggunakan profil percakapan dengan useBidiStreaming diaktifkan untuk berkomunikasi dengan CX Agent Studio.

Contoh permintaan

Contoh berikut membuat profil percakapan dengan useBidiStreaming:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • REGION: Hanya multi-region us dan eu yang didukung.
  • DEPLOYMENT_ID: Nilai ID deployment CX Agent Studio yang ingin Anda kaitkan dengan profil percakapan.
  • CONVERSATION_PROFILE_NAME: Ganti nilai ini dengan nama yang ingin Anda berikan ke profil percakapan.
curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
        "displayName": "CONVERSATION_PROFILE_NAME",
        "languageCode": "en-US",
        "useBidiStreaming": true,
        "automatedAgentConfig": {
            "agent": "DEPLOYMENT_ID"
        }
      }' \
 https://REGION-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION/conversationProfiles

Contoh respons

{
  "name": "projects/ccaip-apps-incub-0fcb/locations/global/conversationProfiles/bAp81fGqTg-sp3TUNYTZlw",
  "displayName": "CONVERSATION_PROFILE_NAME",
  "automatedAgentConfig": {
    "agent": "projects/ccaip-apps-incub-0fcb/locations/global/apps/6afaa63d-49a3-4b89-8923-18cbe9b48ae5"
  },
  "languageCode": "en-US",
  "createTime": "2025-08-21T22:11:12.782515Z",
  "updateTime": "2025-08-21T22:11:12.782515Z",
  "useBidiStreaming": true
}

Menghubungkan aplikasi agen ke profil percakapan yang sudah ada

Profil percakapan harus dikaitkan dengan aplikasi agen dan dikonfigurasi untuk mengaktifkan useBidiStreaming.

Contoh berikut membuat profil percakapan dengan useBidiStreaming:

Contoh permintaan aplikasi agen Connect

  • PROJECT_ID: Project ID Google Cloud Anda.
  • INTEGRATION_ID: Ditampilkan dalam respons. Ini adalah ID integrasi profil percakapan baru Anda.
  • REGION: Hanya multi-region us dan eu yang didukung.
  • APP_ID: Nilai ID aplikasi agen CX Agent Studio yang ingin Anda kaitkan dengan profil percakapan.
curl -X PATCH \
  -H "x-goog-user-project: PROJECT_ID" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{"automatedAgentConfig": {"agent": "APP_ID"}}' "https://REGION-dialogflow.googleapis.com/v2beta1/INTEGRATION_ID?updateMask=automatedAgentConfig.agent"

Contoh respons aplikasi agen Connect

{
  "name": "projects/ccaip-apps-incub-0fcb/locations/us/conversationProfiles/FRDHwh2gS-O1n5SpoxKLfg",
  "displayName": "bdsac_us_polysynth_agent",
  "automatedAgentConfig": {
    "agent": "projects/ccaip-apps-incub-0fcb/locations/us/apps/6afaa63d-49a3-4b89-8923-18cbe9b48ae5"
  },
  "humanAgentAssistantConfig": {
    "humanAgentSuggestionConfig": {},
    "messageAnalysisConfig": {}
  },
  "sttConfig": {
    "model": "telephony",
    "useLongFormModel": true
  },
  "languageCode": "en-US",
  "updateTime": "2025-08-06T21:35:13.388052Z",
  "telephonySttConfig": {}
}

Mengaktifkan contoh permintaan useBidiStreaming

  • PROJECT_ID: Project ID Google Cloud Anda.
  • INTEGRATION_ID: Ditampilkan dalam respons. Ini adalah ID integrasi profil percakapan baru Anda.
  • REGION: Hanya multi-region us dan eu yang didukung.
curl -X PATCH \
  -H "x-goog-user-project:PROJECT_ID" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{ "useBidiStreaming": true }' "https://REGION-dialogflow.googleapis.com/v2beta1/INTEGRATION_ID?updateMask=useBidiStreaming"

Aktifkan contoh respons useBidiStreaming

{
  "name": "projects/ccaip-apps-incub-0fcb/locations/us/conversationProfiles/FRDHwh2gS-O1n5SpoxKLfg",
  "displayName": "bdsac_us_polysynth_agent",
  "automatedAgentConfig": {
    "agent": "projects/ccaip-apps-incub-0fcb/locations/us/apps/6afaa63d-49a3-4b89-8923-18cbe9b48ae5"
  },
  "humanAgentAssistantConfig": {
    "humanAgentSuggestionConfig": {},
    "messageAnalysisConfig": {}
  },
  "sttConfig": {
    "model": "telephony",
    "useLongFormModel": true
  },
  "languageCode": "en-US",
  "updateTime": "2025-08-06T21:54:12.206269Z",
  "telephonySttConfig": {},
  "useBidiStreaming": true
}