הפעלת התראות Cloud Pub/Sub לאירועים של CCAI Agent Assist

הפעלת ההתראות של Cloud Pub/Sub מאפשרת לכם לקבל התראה בכל פעם שאירוע של Agent Assist מסתיים. אתם יכולים להגדיר את Agent Assist כך שישלח התראה על כל האירועים או רק על אירועים ספציפיים, כולל הצעות של Agent Assist, מידע על מחזור החיים של השיחה ותמלילים בזמן אמת.

דרישות מוקדמות

1. מפעילים את Dialogflow API.
2. פועלים לפי ההוראות ליצירת נושא ב-Cloud Pub/Sub.

הפעלת התראות Cloud Pub/Sub

אתם יכולים להגדיר את Agent Assist כך שישלח תזכורת לכל האירועים או לאירועים ספציפיים בפרופיל השיחה.

פרופיל שיחה מגדיר קבוצה של פרמטרים ששולטים בהצעות או בהתראות שמוצגות לסוכן במהלך שיחה. יש לכם אפשרות להגדיר התראות של Cloud Pub/Sub באמצעות מסוף Agent Assist או על ידי קריאה ישירה ל-API. אפשר להגדיר כל סוג של התראה בנפרד באמצעות הנושאים שיצרתם.

לפרטים נוספים על פרמטרים להגדרת Cloud Pub/Sub, אפשר לעיין במאמרי העזרה של conversationProfile.

הפעלת התראות Cloud Pub/Sub באמצעות מסוף Agent Assist

הערה: אפשר להשתמש בסימולטור של Agent Assist כדי ליצור שיחה. במקרה כזה, ההתראות על תמלילים והצעות בזמן אמת מתפרסמות בנושאי Pub/Sub פנימיים של Google, ולא בנושאים שהגדרתם בפרופילים של השיחות.

כשיוצרים פרופיל חדש לשיחה באמצעות מסוף Agent Assist, אפשר לבחור אילו סוגי התראות רוצים לקבל באמצעות הנושאים שיצרתם:

הפעלת התראות Cloud Pub/Sub באמצעות API

אם אתם מעדיפים לקרוא ישירות ל-API כדי ליצור או לעדכן פרופיל שיחה, כדאי לעיין בקטע הזה כדי לראות אילו מיקומים צריך להגדיר במשאב ConversationProfile.

בדוגמה הבאה, ההגדרה מאפשרת את כל ההתראות של Cloud Pub/Sub שתואמות לTOPIC_ID שצוין.

{
  "name": "projects/PROJECT_ID/locations/global/conversationProfiles/CONVERSATION_PROFILE_ID",
  "displayName": "CONVERSATION_PROFILE_NAME",
  "automatedAgentConfig": {
  },
  "humanAgentAssistantConfig": {
    "notificationConfig": {
      "topic": "projects/PROJECT_ID/topics/FEATURE_SUGGESTION_TOPIC_ID",
      "messageFormat": "JSON"
    },
    "humanAgentSuggestionConfig": {
      "featureConfigs": [{
        "enableEventBasedSuggestion": true,
        "suggestionFeature": {
          "type": "ARTICLE_SUGGESTION"
        },
        "conversationModelConfig": {
        }
      }]
    },
    "messageAnalysisConfig": {
    }
  },
  "notificationConfig": {
    "topic": "projects/PROJECT_ID/topics/CONVERSARION_LIFECYCLE_TOPIC_ID",
    "messageFormat": "JSON"
  },
  "newMessageEventNotificationConfig": {
    "topic": "projects/PROJECT_ID/topics/LIVE_TRANSCRIPT_TOPIC_ID",
    "messageFormat": "JSON"
  },
  "newRecognitionResultNotificationConfig": {
    "topic": "projects/PROJECT_ID/topics/NEW_RECOGNITION_RESULT_TOPIC_ID",
    "messageFormat": "JSON"
  },
  "languageCode": "en-US"
}

הגדרת ההודעה ב-Cloud Pub/Sub

התראה	הטריגר	הגדרה ב-ConversationProfile
suggestion_event	כש-Agent Assist יוצר הצעה	ConversationProfile.humanAgentAssistantConfig.notificationConfig מגדירים את SuggestionFeatureConfig.enableEventBasedSuggestion כ-true לתכונות שנבחרו תכונות נתמכות: ARTICLE_SUGGESTION, ‏ FAQ ו-DIALOGFLOW_ASSIST
life_cycle_event	כשהשיחה נפתחת או נסגרת	ConversationProfile.notificationConfig
new_message_event	כשמופיע תמליל חדש של הודעה או אמירה	ConversationProfile.newMessageEventNotificationConfig
new_recognition_result_event	כשתמליל ביניים זמין	ConversationProfile.newRecognitionResultNotificationConfig

התוכן של ההודעה ב-Cloud Pub/Sub

התוכן של ההודעה ב-Cloud Pub/Sub תלוי באירוע שמפעיל את ההתראה הזו ב-Cloud Pub/Sub.

התראה	נתוני ההודעה	דוגמה לנתוני הודעה
suggestion_event	HumanAgentAssistantEvent	{ "conversation": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID", "participant": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID/participants/PARTICIPANT_ID", "suggestionResults": [SuggestionResult] }
life_cycle_event	ConversationEvent	{ "conversation": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID", "type": "CONVERSATION_STARTED" }
new_message_event	ConversationEvent	{ "conversation": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID", "type": "NEW_MESSAGE", "newMessagePayload": Message }
new_recognition_result_event	ConversationEvent	{ "conversation": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID", "type": "NEW_RECOGNITION_RESULT", "newRecognitionResultPayload": StreamingRecognitionResult }