Filtrage

Vous pouvez filtrer les conversations en fonction des informations tirées directement de leurs caractéristiques ou des attributs des opérations qu'elles ont subies.

Filtres de conversations

Vous pouvez filtrer les conversations en fonction d'une ou de plusieurs des caractéristiques du tableau ci-dessous. Ces filtres sont utiles pour affiner une recherche dans de grands ensembles de données de conversation. La section "Filtrage" de la page Lister les conversations répertorie les autorisations dont vous avez besoin pour appliquer les filtres suivants.

Terme de filtre Description Code de référence
ID de l'agent Chaîne pour un agent unique

agent_id="some agent_id"

quality_metadata.agent_info.agent_id:"some agent_id"

Équipe d'agents Chaîne pour une équipe d'agents

agent_team="some agent_team"

quality_metadata.agent_info.teams:"some agent_team"

Type d'agent Agent humain ou automatisé

quality_metadata.agent_info.agent_type:"HUMAN_AGENT"

quality_metadata.agent_info.agent_type="AUTOMATED_AGENT"

Date et heure de création de l'analyse Heure à laquelle l'analyse a été créée latest_analysis.create_time>"2023-12-31T16:00:10-08:00"
État de l'analyse Indique si la conversation a été analysée.

A été analysé : latest_analysis:"*"

Non analysé : -latest_analysis:"*"

Canal de conversation Support de la conversation : PHONE_CALL ou CHAT medium="PHONE_CALL"
Heure de création de la conversation Heure à laquelle la conversation a été importée dans CX Insights

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

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

Libellé de conversation Libellé ou tag attribué à une conversation

labels:"key_only"

labels.key_1:"value_1"

Date et heure de début de la conversation. Heure à laquelle la conversation a commencé

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

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

Date et heure de mise à jour de la conversation Heure de la dernière mise à jour de la conversation

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

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

Score CSAT Score de satisfaction client

quality_metadata.customer_satisfaction_rating>"1"

quality_metadata.customer_satisfaction_rating<"5"

Mise en surbrillance personnalisée (également appelée "Expression exacte") Sélections personnalisées pour signaler certaines expressions

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"

Source de données La source de la conversation est Cloud Storage ou Dialogflow, ou elle contient des enregistrements d'écran.

data_source.gcs_source: "*"

data_source.dialogflow_source: "*"

data_source.screen_recordings.video_uri: "*"

Conversation Dialogflow Conversation ayant eu lieu via Dialogflow, à l'aide d'un agent virtuel data_source.dialogflow_source.dialogflow_conversation="projects/123456789/locations/us-central1/conversations/some_dialogflow_conversation"
ID du profil de conversation Dialogflow Chaîne pour un profil de conversation Dialogflow unique dialogflow_conversation_profile_id="some_dialogflow_conversation_profile_id"
Durée Durée de la conversation duration<="20s"
Langue Langue parlée ou saisie dans la conversation, avec le code de langue au format BCP-47 et les préfixes acceptés language_code: "some_language_code"
Heure de création de la dernière analyse Heure à laquelle la dernière analyse a été créée

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

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

Dernier récapitulatif Correspondre à une partie du résumé le plus récent

latest_summary.text:"phrase to match"

latest_summary.text:"and another"

-latest_summary.text:"exclude this"

Tableau de données Toutes les conversations analysées par une fiche d'évaluation spécifique latest_analysis.analysis_result.call_analysis_metadata.qa_scorecard_results.qa_scorecard_revision_id=projects/PROJECT_ID/locations/us-central1/qaScorecards/SCORECARD_ID
Questions/réponses sur les tableaux de données Conversations analysées par une fiche d'évaluation spécifique et qui fournissent une réponse particulière à une question 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"))
Score de sentiment Score moyen du sentiment de l'utilisateur pour la conversation

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"

Durée du silence Durée du temps de silence de la conversation

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

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

Mise en surbrillance intelligente Les mises en évidence intelligentes vous aident à signaler certaines expressions.

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"

État du résumé Indique si un résumé a été généré.

Comporte un résumé : latest_summary:"*"

Aucun résumé : -latest_summary:"*"

Thème (également appelé "Problème") Thème ou problème identifié par la modélisation de sujets

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"

Transcription Correspondance avec le texte de la conversation

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"

Nombre de tours Nombre de tours de conversation

turn_count>"10"

turn_count<="20"

Filtres d'opération

Vous pouvez également filtrer les conversations en fonction des informations disponibles sur les opérations qui ont été effectuées sur celles-ci. Vous pouvez filtrer un ensemble de données de conversation en fonction des attributs d'opération suivants.

Terme de filtre Description Code de référence
Heure de création Heure à laquelle l'opération a été créée

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

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

ID de la conversation Chaîne pour une conversation spécifique metadata.conversation_id="some_conversation_id"
OK État final d'une opération

Fin : done="true"

Non terminé : done="false"

Type d'opération Type d'opération effectuée sur l'ensemble de données

Le type d'opération est : metadata.operation_type="BulkAnalyzeConversations"

Le type d'opération n'est pas : metadata.operation_type!="BulkAnalyzeConversations"

État État détaillé de l'opération

Opération réussie : status_code="0"

Échec, mais pas d'abandon : status_code!="ABORTED"

Pour afficher les erreurs liées à l'exécution d'une opération groupée, vous devez utiliser une commande curl.

  • Opérations d'analyse groupée :
    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"
  • Opérations d'ingestion groupée (transcription ou 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"