סינון שיחות

אפשר לסנן את השיחות על סמך מידע שנאסף ישירות מהמאפיינים שלהן או ממאפיינים של פעולות שהשיחות האלה עברו.

מסנני שיחות

אפשר לסנן את השיחות לפי מאפיין אחד או יותר מהמאפיינים שמפורטים בטבלה הבאה. המסננים האלה שימושיים לצמצום החיפוש בקרב קבוצות גדולות של נתוני שיחות. בקטע 'סינון' בדף רשימת שיחות מפורטות ההרשאות שצריך כדי להחיל את המסננים הבאים.

הערה: כשמשתמשים במירכאות כפולות (") בפקודת curl או בכתובת URL, צריך לסמן אותן בתו בריחה (escape) באמצעות לוכסן הפוך, בלי להוסיף רווח אחרי (").

מונח לסינון	תיאור	קוד הפניה
מזהה הסוכן	מחרוזת לסוכן ייחודי	agent_id="some agent_id" quality_metadata.agent_info.agent_id:"some agent_id"
צוות נציגים	מחרוזת לצוות נציגים	agent_team="some agent_team" quality_metadata.agent_info.teams:"some agent_team"
סוג הסוכן	נציג אנושי או אוטומטי	quality_metadata.agent_info.agent_type:"HUMAN_AGENT" quality_metadata.agent_info.agent_type="AUTOMATED_AGENT"
זמן יצירת הניתוח	השעה שבה הניתוח נוצר	latest_analysis.create_time>"2023-12-31T16:00:10-08:00"
סטטוס הניתוח	האם השיחה נותחה	עבר ניתוח: latest_analysis:"*" לא נותח: -latest_analysis:"*"
ערוץ שיחה	אמצעי התקשורת בשיחה: PHONE_CALL או CHAT	medium="PHONE_CALL"
שעת יצירת השיחה	השעה שבה השיחה יובאה ל-CX Insights	create_time>"1969-12-31T16:00:10-08:00" create_time<="1969-12-31T16:00:20-08:00"
תווית שיחה	תווית או תג שהוקצו לשיחה	labels:"key_only" labels.key_1:"value_1"
שעת ההתחלה של השיחה	השעה שבה השיחה התחילה	start_time>"1969-12-31T16:00:10-08:00" start_time>"1969-12-31T16:00:20-08:00"
שעת העדכון של השיחה	השעה שבה השיחה עודכנה לאחרונה	update_time>"1969-12-31T16:00:10-08:00" update_time<="1969-12-31T16:00:20-08:00"
ציון שביעות רצון	ציון שביעות רצון הלקוחות	quality_metadata.customer_satisfaction_rating>"1" quality_metadata.customer_satisfaction_rating<"5"
קבוצת מילות מפתח בהתאמה אישית (נקראת גם 'התאמה לביטוי')	הדגשות מותאמות אישית שיעזרו לכם לסמן ביטויים מסוימים	latest_analysis.analysis_result.call_analysis_metadata.phrase_matchers.id:"add_one_positive_custom_highlight" latest_analysis.analysis_result.call_analysis_metadata.phrase_matchers.id:"multiple positive custom highlights" -latest_analysis.analysis_result.call_analysis_metadata.phrase_matchers.id:"one_negative_custom_highlight" -latest_analysis.analysis_result.call_analysis_metadata.phrase_matchers.id:"multiple negative custom highlights"
מקור הנתונים	מקור השיחה הוא Cloud Storage או Dialogflow, או שהיא כוללת הקלטות מסך	data_source.gcs_source: "*" data_source.dialogflow_source: "*" data_source.screen_recordings.video_uri: "*"
שיחה ב-Dialogflow	שיחה שהתנהלה באמצעות Dialogflow, עם נציג וירטואלי	data_source.dialogflow_source.dialogflow_conversation="projects/123456789/locations/us-central1/conversations/some_dialogflow_conversation"
מזהה פרופיל השיחה ב-Dialogflow	מחרוזת לפרופיל שיחה ייחודי ב-Dialogflow	dialogflow_conversation_profile_id="some_dialogflow_conversation_profile_id"
משך	משך הזמן של השיחה	duration<="20s"
שפה	השפה המדוברת או המוקלדת שבה מתנהלת השיחה, עם קוד שפה בפורמט BCP-47 וקידומות נתמכות	language_code: "some_language_code"
הזמן האחרון שבו נוצר ניתוח	הזמן שבו נוצר הניתוח האחרון	latest_analysis.create_time>"1969-12-31T16:00:10-08:00" latest_analysis.create_time<$eq;"1969-12-31T16:00:20-08:00"
הסיכום האחרון	התאמה לחלק מהסיכום האחרון	latest_summary.text:"phrase to match" latest_summary.text:"and another" -latest_summary.text:"exclude this"
כרטיס מידע	כל השיחות שנותחו על ידי כרטיס ניקוד מסוים	latest_analysis.analysis_result.call_analysis_metadata.qa_scorecard_results.qa_scorecard_revision_id=projects/PROJECT_ID/locations/us-central1/qaScorecards/SCORECARD_ID
תשובה לשאלה בכרטיס המידע	שיחות שמנותחות על ידי כרטיס ניקוד מסוים, ונותנות תשובה מסוימת לשאלה	latest_analysis.analysis_result.call_analysis_metadata.qa_scorecard_results.qa_answers.contains((qa_question="projects/PROJECT_ID/locations/LOCATION_ID/qaScorecards/SCORECARD_ID/revisions/REVISION_ID/qaQuestions/QUESTION"),(answer_value.str_value="ANSWER"))
ציון סנטימנט	ציון הסנטימנט הממוצע של המשתמש בשיחה	latest_analysis.analysis_result.call_analysis_metadata.sentiments.sentiment_data.score>"0.1" latest_analysis.analysis_result.call_analysis_metadata.sentiments.sentiment_data.score<"0.2"
משך ההשתקה	משך ההשתקה הזמנית של השיחה	latest_analysis.analysis_result.call_analysis_metadata.silence.silence_duration>"10s" latest_analysis.analysis_result.call_analysis_metadata.silence.silence_duration<$eq;"20s"
הדגשה חכמה	הדגשות חכמות שיעזרו לכם לסמן ביטויים מסוימים.	latest_analysis.analysis_result.call_analysis_metadata.intents.display_name:"one_positive_smart_highlight" latest_analysis.analysis_result.call_analysis_metadata.intents.display_name:"multiple positive smart highlights" -latest_analysis.analysis_result.call_analysis_metadata.intents.display_name:"one_negative_smart_highlight" -latest_analysis.analysis_result.call_analysis_metadata.intents.display_name:"multiple negative smart highlights"
סטטוס הסיכום	האם נוצר סיכום	כולל סיכום: latest_summary:"*" אין סיכום: -latest_summary:"*"
נושא (נקרא גם בעיה)	נושא או בעיה שזוהו על ידי Topic Modeling	latest_analysis.analysis_result.issues.issue="projects/123456789/locations/us-central1/issueModels/test_model/issues/issue_foo" latest_analysis.analysis_result.issue_model_id="projects/123456789/locations/us-central1/issueModels/test_model"
תמליל	התאמה של טקסט השיחה	transcript.transcript_segments.text:"one_positive_term" transcript.transcript_segments.text:"multiple positive terms" -transcript.transcript_segments.text:"one_negative_term" -transcript.transcript_segments.text:"multiple negative terms"
מספר הפניות	מספר שלבי השיחה	turn_count>"10" turn_count<="20"

מסנני פעולות

אפשר גם לסנן את השיחות על סמך המידע שזמין מפעולות שבוצעו בהן. אפשר לסנן מערך נתונים של שיחות על סמך מאפייני הפעולה הבאים.

מונח לסינון	תיאור	קוד הפניה
זמן יצירה	הזמן שבו נוצרה הפעולה	metadata.create_time>"1969-12-31T16:00:10-08:00" metadata.create_time<="1969-12-31T16:00:20-08:00"
מזהה השיחה	מחרוזת לשיחה ספציפית	metadata.conversation_id="some_conversation_id"
סיום	הסטטוס הסופי של פעולה	הושלם: done="true" לא הושלם: done="false"
סוג הפעולה	סוג הפעולה שבוצעה במערך הנתונים	סוג הפעולה הוא: metadata.operation_type="BulkAnalyzeConversations" סוג הפעולה הוא לא: metadata.operation_type!="BulkAnalyzeConversations"
סטטוס	סטטוס מפורט של הפעולה	הושלם בהצלחה: status_code="0" הפעולה נכשלה אבל לא בוטלה: status_code!="ABORTED"

כדי לראות את השגיאות מהרצת פעולה בכמות גדולה, צריך להשתמש בפקודת curl.

• פעולות ניתוח בכמות גדולה:

  curl -X GET \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "Content-Type: application/json; charset=utf-8" "https://contactcenterinsights.googleapis.com/v1/projects/$PROJECT/locations/$LOCATION/operations?filter=metadata.operation_type=\"BulkAnalyzeConversations\"&page_size=10"

• פעולות המרה בכמות גדולה (תמליל או אודיו):

  curl -X GET \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "Content-Type: application/json; charset=utf-8"  "https://contactcenterinsights.googleapis.com/v1/projects/$PROJECT/locations/$LOCATION/operations?filter=metadata.operation_type=\"IngestConversations\"&page_size=10"