Affichez les métriques d'utilisation et de commentaires issues des insights sur l'expérience client au fil du temps grâce à un tableau de bord configurable. Les tableaux de bord configurables offrent une grande flexibilité en termes de représentation et de mise en page des données, car vous pouvez créer et gérer des vues personnalisées avec différents graphiques. Le tableau de bord configurable vous permet de sélectionner un type de graphique, d'enregistrer la configuration et de la récupérer la prochaine fois que vous accéderez à la page.
Composants du tableau de bord
Un tableau de bord contient les composants suivants.
| Composant | Description |
|---|---|
| Tableau de bord | Ressource de premier niveau qui stocke l'ensemble de la structure et des définitions de graphiques. |
| Section | Une section peut contenir des tuiles ou des sections imbriquées (qui apparaissent sous forme d'onglets). Les sections de tableau de bord peuvent avoir un nom à afficher et une description. Vous pouvez appliquer le filtre date_range à tous les graphiques d'un onglet entier. Les sections définissent leurs dimensions physiques à l'aide de la largeur et de la hauteur en unités de grille. |
| Vignette | Élément du tableau de bord, défini comme une section imbriquée ou un graphique. La plage de dates par défaut est "Semaine dernière". Vous pouvez également interroger date_range en tant que "1 dernier jour", "2 derniers jours", "1 dernière semaine", "2 dernières semaines", "1 dernier mois", "1 dernier trimestre", "1 dernière année" ou en tant que dates de début et de fin personnalisées. |
Définitions des champs du tableau de bord
Chaque tableau de bord est composé des champs suivants. Seules les valeurs display_name et description apparaissent dans la console.
| Champ | Description | Contraintes/Remarques |
|---|---|---|
name |
Nom du tableau de bord | Format : projects/{project}/locations/{location}/dashboards/{dashboard} |
display_name |
Nom fourni par l'utilisateur pour le tableau de bord | 100 caractères maximum |
description |
Description du tableau de bord | Facultatif |
create_time |
Date et heure de création du tableau de bord | Sortie uniquement |
update_time |
Code temporel de la dernière mise à jour du tableau de bord | Sortie uniquement |
filter |
Filtre pour tous les graphiques du tableau de bord | Accepte un filtre de chaîne facultatif |
Données et requêtes
Le graphique utilise le langage naturel, que les insights sur l'expérience client traduisent en requêtes SQL. Ces requêtes génèrent les données et les spécifications visuelles pour afficher le graphique. Les spécifications visuelles sont au format VEGA-LITE. L'API Charts utilise les sources GenerativeInsights data, session_id et revision_id pour stocker les états actuels des spécifications SQL et visuelles d'un graphique.
Opérations sur les tableaux de bord
Vous pouvez effectuer les opérations suivantes sur les tableaux de bord configurables.
Créer un tableau de bord
Suivez ces étapes pour créer votre tableau de bord.
Console
Accédez à la console CX Insights, connectez-vous avec votre compte Google et sélectionnez votre projet.
Cliquez sur Tableau de bord. Vous y trouverez des tableaux de bord prédéfinis et personnalisés.
Dans Dashboard Studio, cliquez sur + Ajouter un tableau de bord pour créer votre propre tableau de bord personnalisé.
Chaque tableau de bord apparaît sous la forme d'une tuile.
Lorsque vous cliquez sur un tableau de bord, vous obtenez un aperçu de tous les graphiques.
API REST
Envoyez une requête comme dans l'exemple suivant.
{
"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
Exécutez la commande Curl suivante. Dans cet exemple, la charge utile est enregistrée dans 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"
Modifier le tableau de bord
Suivez ces étapes pour modifier votre tableau de bord.
Console
Sélectionnez un tableau de bord, puis cliquez sur Plus more_vert > Modifier pour le modifier.
Choisissez l'une des options suivantes :
- + Ajouter une tuile
- + Ajouter une section
- edit Renommer l'onglet
- content_copy Dupliquer l'onglet
- delete Supprimer l'onglet
- Choisissez une plage de dates pour afficher vos résultats.
- Sélectionnez une vignette, puis cliquez sur Plus more_vert. Un panneau latéral s'affiche avec les options suivantes : "Demander à l'IA", "Paramètres de la tuile" et "Éditeur de requête".
Options supplémentaires
Demander à l'IA : cliquez sur "Demander à l'IA", puis saisissez une description textuelle de vos modifications. L'assistant IA peut vous aider à créer votre tableau de bord. Vous pouvez également poser des questions complémentaires à l'assistant IA. Si vous cliquez sur Enregistrer le graphique, vous pouvez revenir aux visualisations précédentes. Le langage naturel (LN) vous permet de générer des visualisations en spécifiant des requêtes descriptives telles que Quel est le nombre moyen de conversations par jour pour un agent virtuel ? Ces requêtes sont converties en SQL pour être exécutées dans BigQuery et en spécification visuelle (VEGA lite) pour être affichées.
Paramètres des tuiles : dans cette section, vous pouvez modifier directement la spécification visuelle pour contrôler l'attribut du graphique. Par exemple, modifiez le nom à afficher du graphique. Vous pouvez choisir le type de graphique de votre choix dans le menu déroulant. L'API Charts est compatible avec les types de graphiques et les représentations de données suivants :
- BAR
- LINE
- ZONE
- PIE
- DISPERSER
- TABLEAU
- SCORE_CARD
- SUNBURST
- JAUGE
- SANKEY
Vous pouvez spécifier plus précisément le filtre de conversation ou la nouvelle plage de dates lorsque vous rechargez le tableau de bord.
Éditeur de requête : vous pouvez interagir avec l'assistant IA et créer un tableau de bord. Si vous n'êtes pas satisfait de la réponse SQL générée par l'IA, vous pouvez modifier directement le code SQL pour générer un graphique. La réponse SQL repopule ensuite la spécification visuelle existante. L'éditeur de requête affiche le code SQL généré, dont le nom de table est masqué pour faire référence à une chaîne d'espace réservé prédéfinie, INSIGHTS_DASHBOARD_VIEW. Remarque : Vous ne pouvez effectuer que des opérations SELECT.
Curl
Exécutez la commande Curl suivante. Dans cet exemple, la charge utile est enregistrée dans 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"
Supprimer le tableau de bord
Pour supprimer un tableau de bord et tous les graphiques associés, procédez comme suit.
Console
Sélectionnez un tableau de bord, puis cliquez sur Plus more_vert > Supprimer pour le supprimer.
Curl
Exécutez la commande Curl suivante.
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"