Applicazione dei filtri

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

Filtri delle conversazioni

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 grandi set di dati delle conversazioni. La sezione "Filtro" della pagina Elenca conversazioni elenca le autorizzazioni necessarie per applicare i seguenti filtri.

Termine del filtro Descrizione Codice di riferimento
ID agente Stringa per un agente unico

agent_id="some agent_id"

quality_metadata.agent_info.agent_id:"some agent_id"

Team di agenti 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 automatizzato

quality_metadata.agent_info.agent_type:"HUMAN_AGENT"

quality_metadata.agent_info.agent_type="AUTOMATED_AGENT"

Data/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 Se la conversazione è stata analizzata

È stato analizzato: latest_analysis:"*"

Non è stato analizzato: -latest_analysis:"*"

Canale di conversazione Mezzo della conversazione: PHONE_CALL o CHAT medium="PHONE_CALL"
Ora di creazione della conversazione Data e ora di importazione della conversazione in CX Insights

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

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

Etichetta conversione Etichetta o tag assegnato a una conversazione

labels:"key_only"

labels.key_1:"value_1"

Ora di inizio della conversazione L'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 Data e 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 corrispondenze a frase) Custom Highlights 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 include 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 La durata della conversazione. duration<="20s"
Lingua Lingua parlata o digitata utilizzata nella conversazione con il codice lingua nel formato BCP-47 e prefissi supportati language_code: "some_language_code"
Data e 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 Corrispondere 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 di valutazione 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 del prospetto Conversazioni analizzate da un determinato prospetto 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 medio del sentiment 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 La durata del periodo di silenzio della 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 intelligente Evidenziazione intelligente 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

Ha 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 Corrispondenza del 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 svolte Numero di turni di conversazione

turn_count>"10"

turn_count<="20"

Filtri operazioni

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

Termine del 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

Data di completamento: done="true"

Non completata: 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"