Visualiza las métricas de uso y comentarios de Customer Experience Insights a lo largo del tiempo con un panel configurable. Los paneles configurables ofrecen flexibilidad en la representación y el diseño de los datos, ya que puedes crear y mantener vistas personalizadas con una variedad de gráficos. El panel configurable te permite seleccionar un tipo de gráfico, almacenar la configuración y recuperarla la próxima vez que visites la página.
Componentes del panel
Un panel contiene los siguientes componentes.
| Componente | Descripción |
|---|---|
| Panel | Es el recurso de nivel superior que almacena toda la estructura y las definiciones de gráficos. |
| Sección | Una sección puede tener mosaicos o secciones anidadas (estos aparecen como pestañas). Las secciones del panel pueden tener un nombre visible y una descripción. Puedes aplicar el filtro date_range a todos los gráficos de una pestaña completa. Las secciones definen sus dimensiones físicas con el ancho y la altura en unidades de cuadrícula. |
| Mosaico | Es un elemento dentro del panel, definido como una sección anidada o un gráfico. El período predeterminado es la semana anterior. Puedes consultar aún más el date_range como los últimos 1 día, los últimos 2 días, la última semana, las últimas 2 semanas, el último mes, el último trimestre, el último año o las fechas de inicio y finalización personalizadas. |
Definiciones de campos del panel
Cada panel se compone de los siguientes campos. Solo display_name y description aparecen en la consola.
| Campo | Descripción | Restricciones/Notas |
|---|---|---|
name |
Nombre del panel | Formato: projects/{project}/locations/{location}/dashboards/{dashboard} |
display_name |
Nombre proporcionado por el usuario para el panel | Máximo de 100 caracteres |
description |
Descripción del panel | Opcional |
create_time |
Marca de tiempo de creación del panel | Solo salida |
update_time |
Marca de tiempo de la última actualización del panel | Solo salida |
filter |
Filtro para todos los gráficos del panel | Admite el filtro de cadena opcional |
Datos y consultas
El gráfico usa lenguaje natural (LN), que Customer Experience Insights traduce en consultas de SQL. Estas consultas generan los datos y las especificaciones visuales para mostrar el gráfico. Las especificaciones visuales están en formato VEGA-LITE. La API de gráficos usa la fuente de datos GenerativeInsights data, session_id y revision_id para almacenar los estados actuales de SQL y las especificaciones visuales de un gráfico.
Operaciones del panel
Puedes realizar las siguientes operaciones en paneles configurables.
Crear panel
Sigue estos pasos para crear tu panel.
Console
Navega a la consola de CX Insights, accede con tu Cuenta de Google y selecciona tu proyecto.
Haz clic en Panel. Aquí, puedes ver paneles precompilados y personalizados.
En Dashboard Studio, haz clic en + Agregar panel para crear tu propio panel personalizado.
Cada panel aparece en forma de mosaico.
Cuando haces clic en un panel, se muestra una descripción general de todos los gráficos.
API de REST
Envía una solicitud como la del siguiente ejemplo.
{
"displayName": "My New Dashboard with Container",
"root_container": {
"displayName": "Overview tab",
"widgets": [
{
"container": {
"displayName": "Inner Chart Group 1",
"widgets": [
{
"chart": {
"displayName": "Most Reported Issues"
"dataSource": {"generativeInsights": "What are top 5 issues?"}
}
},
{
"chart": {
"displayName": "Topic Distribution"
"dataSource": {"generativeInsights": "What are the topics?"}
}
}
]
}
}
]
}
}
Curl
Ejecuta el siguiente comando de curl: En este ejemplo, la carga útil se guarda en create_dashboard_nested.json.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth --impersonate-service-account=$SA_EMAIL print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @create_dashboard_nested.json "https://$ENDPOINT/v1/projects/$PROJECT/locations/$LOCATION/dashboards?dashboard_id=$DASHBOARD_ID"
Editar panel
Sigue estos pasos para editar tu panel.
Console
Elige un panel y haz clic en Más more_vert > Editar para editarlo.
Elige una de las siguientes opciones:
- + Agregar mosaico
- + Agregar sección
- edit Cambiar nombre de la pestaña
- content_copy Duplicar pestaña
- delete Borrar pestaña
- Elige un período para ver los resultados.
- Elige un mosaico y haz clic en Más more_vert. Aparecerá un panel lateral con las siguientes opciones: Preguntar a la IA, Configuración del mosaico y Editor de consultas.
Opciones adicionales
Preguntar a la IA: Haz clic en Preguntar a la IA y, luego, ingresa una descripción de texto de los cambios. El asistente de IA puede ayudarte a crear tu panel. También tienes la opción de hacer preguntas de seguimiento al asistente de IA. Si haces clic en Guardar gráfico, puedes revertir a las visualizaciones anteriores. El lenguaje natural (LN) te permite generar visualizaciones especificando consultas descriptivas como ¿Cuál es el recuento promedio de conversaciones por día para un agente virtual? Estas consultas se convierten en SQL para su ejecución en BigQuery y en especificaciones visuales (VEGA lite) para fines de visualización.
Configuración del mosaico: En esta sección, puedes actualizar la especificación visual directamente para controlar el atributo del gráfico. Por ejemplo, puedes cambiar el nombre visible del gráfico. Puedes elegir el tipo de gráfico que prefieras en el menú desplegable. La API de gráficos admite los siguientes tipos de gráficos y representaciones de datos:
- BAR
- LINE
- AREA
- PIE
- SCATTER
- TABLE
- SCORE_CARD
- SUNBURST
- GAUGE
- SANKEY
Puedes especificar aún más el filtro de conversación o el nuevo período cuando vuelvas a cargar el panel.
Editor de consultas: Puedes interactuar con el asistente de IA y crear un panel. Si no estás satisfecho con la respuesta de SQL generada por la IA, puedes actualizar el SQL directamente para volver a generar un gráfico y la respuesta de SQL vuelve a propagar la especificación visual existente. El editor de consultas muestra el SQL generado, cuyo nombre de tabla está enmascarado para hacer referencia a una cadena de marcador de posición predefinida, INSIGHTS_DASHBOARD_VIEW. Nota: Solo puedes realizar cualquier operación SELECT.
Curl
Ejecuta el siguiente comando de curl: En este ejemplo, la carga útil se guarda en update_dashboard.json.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth --impersonate-service-account=$SA_EMAIL print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @update_dashboard.json \ "https://$ENDPOINT/v1/projects/$PROJECT/locations/$LOCATION/dashboards/$DASHBOARD_ID?update_mask=root_container"
Borrar panel
Sigue estos pasos para borrar un panel y todos los gráficos relacionados.
Console
Elige un panel y haz clic en Más more_vert > Borrar para borrarlo.
Curl
Ejecuta el siguiente comando de curl:
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth --impersonate-service-account=$SA_EMAIL print-access-token)" \ "https://$ENDPOINT/v1/projects/$PROJECT/locations/$LOCATION/dashboards/$DASHBOARD_ID"