篩選

您可以根據直接從特徵或作業屬性中擷取的資訊，篩選對話。

對話篩選器

您可以根據下表中的一或多項特徵篩選對話。這些篩選器有助於在龐大的對話資料集中縮小搜尋範圍。「列出對話」頁面的「篩選」部分列出了套用下列篩選條件所需的權限。

注意： 在 curl 指令或網址中使用雙引號 (") 時，請以反斜線逸出，且 (") 後方不得有額外空格。

篩選條件	說明	參考代碼
代理 ID	不重複代理程式的字串	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 對話設定檔 ID	專屬 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:"*"
主題 (也稱為問題)	主題模型識別的主題或問題	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"
對話 ID	特定對話的字串	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"