Google Cloud CCaaS

במדריך הזה נסביר איך לחבר אפליקציית נציג למופע של Google Cloud CCaaS.

לפני שמתחילים

  1. פועלים לפי השלבים בדף הגדרה וניקוי כדי ליצור או להגדיר את הפרויקט שבו רוצים להשתמש לפריסה. הפרויקט הזה צריך להיות משויך גם לבקשת הסוכן וגם למופע Google Cloud CCaaS, ולהיות באותו region. כדאי לבדוק את הפרויקט ולוודא את הדברים הבאים:
    • האפשרות Dialogflow API מופעלת.
    • לחשבון השירות שתשתמשו בו לפריסה יש את ההרשאה Dialogflow API Admin (roles/dialogflow.admin).
  2. יוצרים ומגדירים אפליקציית סוכן של CX Agent Studio לשימוש בפריסה.
  3. יוצרים ומגדירים מרכז שירות לקוחות ב-Google Cloud CCaaS לשימוש בפריסה.
  4. בקטעי הקוד במדריך הזה מניחים שה-CLI של gcloud מותקן ושההרשאות הנדרשות מוגדרות.

קישור של אפליקציית נציג לפרופיל שיחה חדש

‫Google Cloud CCaaS משתמש בפרופיל שיחה עם useBidiStreaming מופעל כדי לתקשר עם CX Agent Studio.

דוגמה לבקשה

בדוגמה הבאה נוצר פרופיל שיחה עם useBidiStreaming:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫REGION: נתמכים רק אזורים מרובים מסוג us ו-eu.
  • ‫AGENT_NAME: השם של הפריסה או הסוכן של CX Agent Studio שרוצים לשייך לפרופיל השיחה.
  • CONVERSATION_PROFILE_NAME: מחליפים את הערך הזה בשם שרוצים לתת לפרופיל השיחה.
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": "AGENT_NAME"
        }
      }' \
 https://REGION-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION/conversationProfiles

דוגמה לתשובה

{
  "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
}

חיבור אפליקציית סוכן לפרופיל שיחה קיים

פרופיל השיחה צריך להיות משויך לאפליקציית נציג ולהיות מוגדר להפעלת useBidiStreaming.

בדוגמה הבאה נוצר פרופיל שיחה עם useBidiStreaming:

בקשה לדוגמה לחיבור אפליקציית סוכן

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫INTEGRATION_ID: הערך שמוחזר בתגובה. זהו מזהה השילוב של פרופיל השיחה החדש.
  • ‫REGION: נתמכים רק אזורים מרובים מסוג us ו-eu.
  • ‫APP_ID: ערך המזהה של אפליקציית הסוכן ב-CX Agent Studio שרוצים לשייך לפרופיל השיחה.
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"

דוגמה לתשובה של אפליקציית נציג

{
  "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": {}
}

הפעלת בקשה לדוגמה של useBidiStreaming

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫INTEGRATION_ID: הערך שמוחזר בתגובה. זהו מזהה השילוב של פרופיל השיחה החדש.
  • ‫REGION: נתמכים רק אזורים מרובים מסוג us ו-eu.
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"

הפעלת 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
}