Filtern

Sie können Unterhaltungen nach Informationen filtern, die direkt aus ihren Merkmalen oder aus Attributen von Vorgängen stammen, die in diesen Unterhaltungen stattgefunden haben.

Unterhaltungsfilter

Unterhaltungen können nach einer oder mehreren der Eigenschaften in der folgenden Tabelle gefiltert werden. Diese Filter sind nützlich, um die Suche in großen Konversationsdatensätzen einzugrenzen. Im Abschnitt „Filtern“ auf der Seite Unterhaltungen auflisten sind die Berechtigungen aufgeführt, die Sie zum Anwenden der folgenden Filter benötigen.

Filterbegriff Beschreibung Referenzcode
Agent-ID String für einen eindeutigen Agent

agent_id="some agent_id"

quality_metadata.agent_info.agent_id:"some agent_id"

Agent-Team String für ein Kundenserviceteam

agent_team="some agent_team"

quality_metadata.agent_info.teams:"some agent_team"

Agent-Typ Menschlicher oder automatisierter Kundenservicemitarbeiter

quality_metadata.agent_info.agent_type:"HUMAN_AGENT"

quality_metadata.agent_info.agent_type="AUTOMATED_AGENT"

Erstellungszeit der Analyse Zeitpunkt, zu dem die Analyse erstellt wurde latest_analysis.create_time>"2023-12-31T16:00:10-08:00"
Analysestatus Ob die Unterhaltung analysiert wurde

Wurde analysiert: latest_analysis:"*"

Nicht analysiert: -latest_analysis:"*"

Unterhaltungschannel Medium der Unterhaltung: PHONE_CALL oder CHAT medium="PHONE_CALL"
Erstellungszeitpunkt der Unterhaltung Zeitpunkt, zu dem die Unterhaltung in CX Insights importiert wurde

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

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

Konversationslabel Einer Unterhaltung zugewiesenes Label oder Tag

labels:"key_only"

labels.key_1:"value_1"

Unterhaltungsbeginn Zeitpunkt, zu dem die Unterhaltung begonnen hat

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

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

Aktualisierungszeitpunkt der Unterhaltung Zeitpunkt der letzten Aktualisierung der Unterhaltung

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

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

CSAT-Wert Kundenzufriedenheitswert

quality_metadata.customer_satisfaction_rating>"1"

quality_metadata.customer_satisfaction_rating<"5"

Benutzerdefinierte Hervorhebung (auch „Phrase Matchers“ genannt) Benutzerdefinierte Highlights, um bestimmte Formulierungen zu kennzeichnen

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"

Datenquelle Die Quelle der Unterhaltung ist Cloud Storage oder Dialogflow oder es sind Bildschirmaufzeichnungen vorhanden.

data_source.gcs_source: "*"

data_source.dialogflow_source: "*"

data_source.screen_recordings.video_uri: "*"

Dialogflow-Unterhaltung Konversation, die über Dialogflow mit einem virtuellen Kundenservicemitarbeiter stattgefunden hat data_source.dialogflow_source.dialogflow_conversation="projects/123456789/locations/us-central1/conversations/some_dialogflow_conversation"
Dialogflow-Unterhaltungsprofil-ID String für ein eindeutiges Dialogflow-Unterhaltungsprofil dialogflow_conversation_profile_id="some_dialogflow_conversation_profile_id"
Dauer Dauer der Unterhaltung duration<="20s"
Sprache Gesprochene oder eingegebene Sprache, die in der Unterhaltung verwendet wird, mit Sprachcode im BCP-47-Format und unterstützten Präfixen language_code: "some_language_code"
Erstellungszeit der letzten Analyse Zeitpunkt, zu dem die letzte Analyse erstellt wurde

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

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

Aktuelle Zusammenfassung Übereinstimmung mit einem Teil der letzten Zusammenfassung

latest_summary.text:"phrase to match"

latest_summary.text:"and another"

-latest_summary.text:"exclude this"

Kurzübersicht Alle Konversationen, die von einer bestimmten Scorecard analysiert wurden latest_analysis.analysis_result.call_analysis_metadata.qa_scorecard_results.qa_scorecard_revision_id=projects/PROJECT_ID/locations/us-central1/qaScorecards/SCORECARD_ID
Antwort auf Frage in der Kurzübersicht Unterhaltungen, die von einer bestimmten Scorecard analysiert werden und für eine Frage eine bestimmte Antwort liefern 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"))
Sentimentwert Durchschnittliche Stimmung des Nutzers für die Unterhaltung

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"

Dauer der Stille Dauer der Schweigezeit in der Unterhaltung

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

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

Smart Highlight Smarte Hervorhebungen, um bestimmte Formulierungen zu kennzeichnen.

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 der Zusammenfassung Ob eine Zusammenfassung generiert wurde

Hat eine Zusammenfassung: latest_summary:"*"

Keine Zusammenfassung: -latest_summary:"*"

Thema (auch als Problem bezeichnet) Thema oder Problem, das durch die Themenmodellierung identifiziert wurde

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"

Transkript Text der Unterhaltung anpassen

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"

Anzahl der Drehungen Anzahl der Unterhaltungsrunden

turn_count>"10"

turn_count<="20"

Vorgangsfilter

Sie können Unterhaltungen auch anhand der Informationen filtern, die aus den an ihnen ausgeführten Vorgängen verfügbar sind. Sie können ein Unterhaltungs-Dataset anhand der folgenden Vorgangsattribute filtern.

Filterbegriff Beschreibung Referenzcode
Erstellungszeit Zeitpunkt, zu dem der Vorgang erstellt wurde

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

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

Unterhaltungs-ID String für eine bestimmte Unterhaltung metadata.conversation_id="some_conversation_id"
Fertig Endgültiger Status eines Vorgangs

Abgeschlossen: done="true"

Nicht abgeschlossen: done="false"

Vorgangstyp Art des Vorgangs, der für das Dataset ausgeführt wurde

Vorgangstyp: metadata.operation_type="BulkAnalyzeConversations"

Der Vorgangstyp ist nicht: metadata.operation_type!="BulkAnalyzeConversations"

Status Detaillierter Status des Vorgangs

Erfolgreich abgeschlossen: status_code="0"

Fehlgeschlagen, aber nicht abgebrochen: status_code!="ABORTED"

Wenn Sie die Fehler aus einem Bulk-Vorgang aufrufen möchten, müssen Sie einen curl-Befehl verwenden.

  • Bulk-Analysevorgänge:
    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"
  • Bulk-Aufnahmevorgänge (Transkript oder 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"