Filtrare le conversazioni

Puoi filtrare le conversazioni in base alle informazioni ricavate direttamente dalle loro caratteristiche o dagli attributi delle operazioni che hanno subito.

Filtri di conversazione

Le conversazioni possono essere filtrate in base a una o più delle caratteristiche riportate nella tabella seguente. Questi filtri sono utili per restringere una ricerca tra set di dati di conversazione di grandi dimensioni. La sezione "Filtri" della pagina Elenco conversazioni elenca le autorizzazioni necessarie per applicare i seguenti filtri.

Termine di filtro Descrizione Codice di riferimento
ID agente Stringa per un agente univoco

agent_id="some agent_id"

quality_metadata.agent_info.agent_id:"some agent_id"

Team dell'agente Stringa per un team di agenti

agent_team="some agent_team"

quality_metadata.agent_info.teams:"some agent_team"

Tipo di agente Agente umano o automatico

quality_metadata.agent_info.agent_type:"HUMAN_AGENT"

quality_metadata.agent_info.agent_type="AUTOMATED_AGENT"

Ora di creazione dell'analisi Ora in cui è stata creata l'analisi latest_analysis.create_time>"2023-12-31T16:00:10-08:00"
Stato dell'analisi Indica se la conversazione è stata analizzata

È stata analizzata: latest_analysis:"*"

Non è stata analizzata: -latest_analysis:"*"

Canale di conversazione Mezzo della conversazione: PHONE_CALL o CHAT medium="PHONE_CALL"
Ora di creazione della conversazione Ora in cui la conversazione è stata importata in CX Insights

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

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

Etichetta conversazione Etichetta o tag assegnato a una conversazione

labels:"key_only"

labels.key_1:"value_1"

Ora di inizio della conversazione Ora in cui è iniziata la conversazione

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

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

Ora di aggiornamento della conversazione Ora dell'ultimo aggiornamento della conversazione

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

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

Punteggio CSAT Punteggio di soddisfazione del cliente

quality_metadata.customer_satisfaction_rating>"1"

quality_metadata.customer_satisfaction_rating<"5"

Evidenziazione personalizzata (chiamata anche Phrase Matchers) Evidenziazioni personalizzate per contrassegnare determinate frasi

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"

Origine dati L'origine della conversazione è Cloud Storage o Dialogflow oppure sono presenti registrazioni dello schermo

data_source.gcs_source: "*"

data_source.dialogflow_source: "*"

data_source.screen_recordings.video_uri: "*"

Conversazione Dialogflow Conversazione avvenuta tramite Dialogflow, utilizzando un agente virtuale data_source.dialogflow_source.dialogflow_conversation="projects/123456789/locations/us-central1/conversations/some_dialogflow_conversation"
ID profilo di conversazione Dialogflow Stringa per un profilo di conversazione Dialogflow univoco dialogflow_conversation_profile_id="some_dialogflow_conversation_profile_id"
Durata Durata della conversazione duration<="20s"
Lingua Lingua parlata o digitata utilizzata nella conversazione con codice lingua in formato BCP-47 e prefissi supportati language_code: "some_language_code"
Ora di creazione dell'ultima analisi Ora in cui è stata creata l'ultima analisi

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

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

Ultimo riepilogo Corrisponde a una parte del riepilogo più recente

latest_summary.text:"phrase to match"

latest_summary.text:"and another"

-latest_summary.text:"exclude this"

Scheda punteggi Tutte le conversazioni analizzate da una determinata scheda punteggi latest_analysis.analysis_result.call_analysis_metadata.qa_scorecard_results.qa_scorecard_revision_id=projects/PROJECT_ID/locations/us-central1/qaScorecards/SCORECARD_ID
Risposta alla domanda della scheda punteggi Conversazioni analizzate da una determinata scheda punteggi e che forniscono una risposta specifica a una domanda 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"))
Punteggio di sentiment Punteggio di sentiment medio dell'utente per la conversazione

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"

Durata silenzio Durata del silenzio nella conversazione

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

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

Evidenziazione smart Evidenziazioni smart per contrassegnare determinate frasi.

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"

Stato del riepilogo Indica se è stato generato un riepilogo

È presente un riepilogo: latest_summary:"*"

Nessun riepilogo: -latest_summary:"*"

Argomento (chiamato anche problema) Argomento o problema identificato dalla modellazione degli argomenti

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"

Trascrizione Corrisponde al testo della conversazione

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"

Numero di turni Numero di turni di conversazione

turn_count>"10"

turn_count<="20"

Filtri operazione

Puoi anche filtrare le conversazioni in base alle informazioni disponibili dalle operazioni eseguite su di esse. Puoi filtrare un set di dati di conversazione in base ai seguenti attributi dell'operazione.

Termine di filtro Descrizione Codice di riferimento
Ora di creazione Ora in cui è stata creata l'operazione

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

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

ID conversazione Stringa per una conversazione specifica metadata.conversation_id="some_conversation_id"
Fine Stato finale di un'operazione

Completato: done="true"

Non completato: done="false"

Tipo di operazione Tipo di operazione eseguita sul set di dati

Il tipo di operazione è: metadata.operation_type="BulkAnalyzeConversations"

Il tipo di operazione non è: metadata.operation_type!="BulkAnalyzeConversations"

Stato Stato dettagliato dell'operazione

Completato correttamente: status_code="0"

Non riuscito, ma non interrotto: status_code!="ABORTED"

Per visualizzare gli errori derivanti dall'esecuzione di un'operazione collettiva, devi utilizzare un comando curl.

  • Operazioni di analisi collettiva:
    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"
  • Operazioni di importazione collettiva (trascrizione o 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"