Filtros

Puedes filtrar las conversaciones según la información obtenida directamente de sus características o de los atributos de las operaciones por las que pasaron esas conversaciones.

Filtros de conversación

Las conversaciones se pueden filtrar según una o más de las características que se indican en la siguiente tabla. Estos filtros son útiles para acotar una búsqueda entre grandes conjuntos de datos de conversaciones. En la sección "Filtrado" de la página List Conversations, se enumeran los permisos que necesitas para aplicar los siguientes filtros.

Término de filtro Descripción Código de referencia
ID del agente Cadena para un agente único

agent_id="some agent_id"

quality_metadata.agent_info.agent_id:"some agent_id"

Equipo de agentes Es una cadena para un equipo de agentes.

agent_team="some agent_team"

quality_metadata.agent_info.teams:"some agent_team"

Tipo de agente Agente humano o automatizado

quality_metadata.agent_info.agent_type:"HUMAN_AGENT"

quality_metadata.agent_info.agent_type="AUTOMATED_AGENT"

Fecha y hora de creación del análisis Fecha y hora en que se creó el análisis latest_analysis.create_time>"2023-12-31T16:00:10-08:00"
Estado del análisis Indica si se analizó la conversación.

Se analizó: latest_analysis:"*"

No se analizó: -latest_analysis:"*"

Canal de conversación Medio de la conversación: PHONE_CALL o CHAT medium="PHONE_CALL"
Fecha y hora de creación de la conversación Fecha y hora en que se importó la conversación a CX Insights

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

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

Etiqueta de conversación Etiqueta asignada a una conversación

labels:"key_only"

labels.key_1:"value_1"

Hora de inicio de la conversación Fecha y hora en que comenzó la conversación

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

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

Hora de actualización de la conversación Fecha y hora en que se actualizó la conversación por última vez

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

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

Puntuación de Satisfacción del cliente (CSAT) Puntuación de satisfacción del cliente

quality_metadata.customer_satisfaction_rating>"1"

quality_metadata.customer_satisfaction_rating<"5"

Destacado personalizado (también llamado Phrase matchers) Destacados personalizados para marcar ciertas frases

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"

Fuente de datos La fuente de la conversación es Cloud Storage o Dialogflow, o tiene grabaciones de pantalla.

data_source.gcs_source: "*"

data_source.dialogflow_source: "*"

data_source.screen_recordings.video_uri: "*"

Conversación de Dialogflow Conversación que tuvo lugar a través de Dialogflow, con un agente virtual data_source.dialogflow_source.dialogflow_conversation="projects/123456789/locations/us-central1/conversations/some_dialogflow_conversation"
ID del perfil de conversación de Dialogflow Es una cadena para un perfil de conversación único de Dialogflow. dialogflow_conversation_profile_id="some_dialogflow_conversation_profile_id"
Duración Duración de la conversación duration<="20s"
Idioma Idioma hablado o escrito que se usa en la conversación, con el código de idioma en formato BCP-47 y prefijos admitidos language_code: "some_language_code"
Fecha y hora de creación del análisis más reciente Fecha y hora en que se creó el análisis más reciente

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

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

Resumen más reciente Coincide con una parte del resumen más reciente

latest_summary.text:"phrase to match"

latest_summary.text:"and another"

-latest_summary.text:"exclude this"

Cuadro de evaluación Todas las conversaciones analizadas por un cuadro de evaluación específico latest_analysis.analysis_result.call_analysis_metadata.qa_scorecard_results.qa_scorecard_revision_id=projects/PROJECT_ID/locations/us-central1/qaScorecards/SCORECARD_ID
Respuesta a la pregunta del cuadro de evaluación Conversaciones analizadas por un cuadro de evaluación específico y que arrojan una respuesta particular para una pregunta 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"))
Puntuación de las opiniones Puntuación promedio del sentimiento del usuario en la conversación

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"

Duración del silencio Duración del tiempo de silencio de la conversación

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

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

Momento destacado inteligente Destacados inteligentes para marcar ciertas frases

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"

Estado del resumen Indica si se generó un resumen.

Tiene un resumen: latest_summary:"*"

Sin resumen: -latest_summary:"*"

Tema (también llamado problema) Tema o problema identificado por el modelado de temas

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"

Transcripción Coincide con el texto de la conversación

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"

Cantidad de giros Cantidad de turnos de conversación

turn_count>"10"

turn_count<="20"

Filtros de operación

También puedes filtrar las conversaciones según la información disponible de las operaciones que se realizaron en ellas. Puedes filtrar un conjunto de datos de conversaciones según los siguientes atributos de operación.

Término de filtro Descripción Código de referencia
Fecha de creación Fecha y hora en que se creó la operación

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

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

ID de la conversación Cadena para una conversación específica metadata.conversation_id="some_conversation_id"
Listo Estado final de una operación

Completada: done="true"

No se completó: done="false"

Tipo de operación Tipo de operación que se realizó en el conjunto de datos

El tipo de operación es: metadata.operation_type="BulkAnalyzeConversations"

El tipo de operación no es metadata.operation_type!="BulkAnalyzeConversations".

Estado Estado detallado de la operación

Se completó correctamente: status_code="0"

Falló, pero no se anuló: status_code!="ABORTED"

Para ver los errores que se producen cuando se ejecuta una operación masiva, debes usar un comando curl.

  • Operaciones de análisis masivo:
    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"
  • Operaciones de transferencia masiva (transcripción 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"