フィルタリング

会話は、その特性から直接取得した情報、または会話が実行されたオペレーションの属性に基づいてフィルタできます。

会話フィルタ

会話は、次の表の 1 つ以上の特性でフィルタできます。これらのフィルタは、大規模な会話データセットの中から検索結果を絞り込む場合に便利です。会話を一覧表示するページの [フィルタリング] セクションには、次のフィルタを適用するために必要な権限が記載されています。

注: curl コマンドまたは URL で二重引用符（"）を使用する場合は、バックスラッシュでエスケープし、二重引用符（"）の後に余分なスペースを入れないでください。

フィルタ キーワード	説明	参照コード
エージェント 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"
CSAT スコア	顧客満足度スコア	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"