会話をフィルタする

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

会話フィルタ

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

フィルタ キーワード 説明 参照コード
エージェント 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 インサイトにインポートされた時刻

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"