Pemfilteran

Anda dapat memfilter percakapan berdasarkan informasi yang diperoleh langsung dari karakteristiknya atau dari atribut operasi yang telah dilalui percakapan tersebut.

Filter percakapan

Percakapan dapat difilter berdasarkan satu atau beberapa karakteristik dalam tabel berikut. Filter ini berguna untuk mempersempit penelusuran di antara set data percakapan yang besar. Bagian "Pemfilteran" di halaman List Conversations mencantumkan izin yang Anda perlukan untuk menerapkan filter berikut.

Istilah filter Deskripsi Kode referensi
ID Agen String untuk agen unik

agent_id="some agent_id"

quality_metadata.agent_info.agent_id:"some agent_id"

Tim agen String untuk tim agen

agent_team="some agent_team"

quality_metadata.agent_info.teams:"some agent_team"

Jenis agen Agen manusia atau otomatis

quality_metadata.agent_info.agent_type:"HUMAN_AGENT"

quality_metadata.agent_info.agent_type="AUTOMATED_AGENT"

Waktu pembuatan analisis Waktu saat analisis dibuat latest_analysis.create_time>"2023-12-31T16:00:10-08:00"
Status analisis Apakah percakapan telah dianalisis

Telah dianalisis: latest_analysis:"*"

Belum dianalisis: -latest_analysis:"*"

Saluran percakapan Media percakapan: PHONE_CALL atau CHAT medium="PHONE_CALL"
Waktu pembuatan percakapan Waktu saat percakapan diimpor ke CX Insights

create_time>"1969-12-31T16:00:10-08:00"

create_time<="1969-12-31T16:00:20-08:00"

Label percakapan Label atau tag yang ditetapkan ke percakapan

labels:"key_only"

labels.key_1:"value_1"

Waktu mulai percakapan Waktu percakapan dimulai

start_time>"1969-12-31T16:00:10-08:00"

start_time>"1969-12-31T16:00:20-08:00"

Waktu pembaruan percakapan Waktu saat percakapan terakhir diperbarui

update_time>"1969-12-31T16:00:10-08:00"

update_time<="1969-12-31T16:00:20-08:00"

Skor CSAT Skor kepuasan pelanggan

quality_metadata.customer_satisfaction_rating>"1"

quality_metadata.customer_satisfaction_rating<"5"

Sorotan kustom (juga disebut Pencocok frasa) Sorotan kustom untuk membantu menandai frasa tertentu

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"

Sumber data Sumber percakapan adalah Cloud Storage atau Dialogflow, atau memiliki rekaman layar

data_source.gcs_source: "*"

data_source.dialogflow_source: "*"

data_source.screen_recordings.video_uri: "*"

Percakapan Dialogflow Percakapan yang terjadi melalui Dialogflow, menggunakan agen virtual data_source.dialogflow_source.dialogflow_conversation="projects/123456789/locations/us-central1/conversations/some_dialogflow_conversation"
ID profil percakapan Dialogflow String untuk profil percakapan Dialogflow yang unik dialogflow_conversation_profile_id="some_dialogflow_conversation_profile_id"
Durasi Durasi percakapan berlangsung duration<="20s"
Bahasa Bahasa lisan atau tulisan yang digunakan dalam percakapan dengan kode bahasa dalam format BCP-47 dan awalan yang didukung language_code: "some_language_code"
Waktu pembuatan analisis terbaru Waktu saat analisis terbaru dibuat

latest_analysis.create_time>"1969-12-31T16:00:10-08:00"

latest_analysis.create_time<$eq;"1969-12-31T16:00:20-08:00"

Ringkasan terbaru Mencocokkan sebagian ringkasan terbaru

latest_summary.text:"phrase to match"

latest_summary.text:"and another"

-latest_summary.text:"exclude this"

Kartu skor Semua percakapan yang dianalisis oleh kartu skor tertentu latest_analysis.analysis_result.call_analysis_metadata.qa_scorecard_results.qa_scorecard_revision_id=projects/PROJECT_ID/locations/us-central1/qaScorecards/SCORECARD_ID
Jawaban pertanyaan kartu skor Percakapan yang dianalisis oleh kartu skor tertentu dan yang menghasilkan jawaban tertentu untuk suatu pertanyaan 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"))
Nilai sentimen Skor sentimen pengguna rata-rata untuk percakapan

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"

Durasi senyap Durasi waktu senyap percakapan

latest_analysis.analysis_result.call_analysis_metadata.silence.silence_duration>"10s"

latest_analysis.analysis_result.call_analysis_metadata.silence.silence_duration<$eq;"20s"

Sorotan smart Sorotan pintar untuk membantu menandai frasa tertentu.

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"

Status ringkasan Apakah ringkasan telah dibuat

Memiliki ringkasan: latest_summary:"*"

Tidak ada ringkasan: -latest_summary:"*"

Topik (juga disebut Masalah) Topik atau masalah yang diidentifikasi oleh Pemodelan Topik

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"

Transkrip Mencocokkan teks percakapan

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"

Jumlah belokan Jumlah giliran percakapan

turn_count>"10"

turn_count<="20"

Filter operasi

Anda juga dapat memfilter percakapan berdasarkan informasi yang tersedia dari operasi yang telah dilakukan pada percakapan tersebut. Anda dapat memfilter set data percakapan berdasarkan atribut operasi berikut.

Istilah filter Deskripsi Kode referensi
Waktu pembuatan Waktu saat operasi dibuat

metadata.create_time>"1969-12-31T16:00:10-08:00"

metadata.create_time<="1969-12-31T16:00:20-08:00"

ID Percakapan String untuk percakapan tertentu metadata.conversation_id="some_conversation_id"
Selesai Status akhir operasi

Selesai: done="true"

Tidak selesai: done="false"

Jenis Operasi Jenis operasi yang dilakukan pada set data

Jenis operasinya adalah: metadata.operation_type="BulkAnalyzeConversations"

Jenis operasi bukan: metadata.operation_type!="BulkAnalyzeConversations"

Status Status mendetail operasi

Berhasil diselesaikan: status_code="0"

Gagal, tetapi tidak dibatalkan: status_code!="ABORTED"

Untuk melihat error dari menjalankan operasi massal, Anda harus menggunakan perintah curl.

  • Operasi analisis massal:
    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"
  • Operasi penyerapan massal (transkrip atau audio):
    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"