Dashboard configurabili

Visualizza le metriche di utilizzo e feedback di Customer Experience Insights nel tempo con una dashboard configurabile. Le dashboard configurabili offrono flessibilità nella rappresentazione e nel layout dei dati perché puoi creare e gestire visualizzazioni personalizzate con una varietà di grafici. La dashboard configurabile ti consente di selezionare un tipo di grafico, archiviare la configurazione e recuperarla la volta successiva che visiti la pagina.

Componenti della dashboard

Una dashboard contiene i seguenti componenti.

Componente Descrizione
Dashboard La risorsa di primo livello che memorizza l'intera struttura e le definizioni dei grafici.
Sezione Una sezione può contenere riquadri o sezioni nidificate (che vengono visualizzate come schede). Le sezioni della dashboard possono avere un nome visualizzato e una descrizione. Puoi applicare il filtro date_range a tutti i grafici di un'intera scheda. Le sezioni definiscono le loro dimensioni fisiche utilizzando larghezza e altezza in unità della griglia.
Riquadro Un elemento all'interno della dashboard, definito come sezione nidificata o grafico. L'intervallo di date predefinito è la settimana precedente. Puoi eseguire ulteriori query su date_range come ultimo giorno, ultimi due giorni, ultima settimana, ultime due settimane, ultimo mese, ultimo trimestre, ultimo anno o le date di inizio e fine personalizzate.

Definizioni dei campi della dashboard

Ogni dashboard è composta dai seguenti campi. Nella console vengono visualizzati solo display_name e description.

Campo Descrizione Vincoli/note
name Nome dashboard Formato: projects/{project}/locations/{location}/dashboards/{dashboard}
display_name Nome fornito dall'utente per la dashboard Massimo 100 caratteri
description Descrizione della dashboard Facoltativo
create_time Timestamp di creazione della dashboard Solo output
update_time Timestamp dell'ultimo aggiornamento della dashboard Solo output
filter Filtro per tutti i grafici della dashboard Supporta il filtro di stringhe facoltativo

Dati e query

Il grafico utilizza il linguaggio naturale (LN), che Customer Experience Insights traduce in query SQL. Queste query generano i dati e le specifiche visive per visualizzare il grafico. Le specifiche visive sono in formato VEGA-LITE. L'API del grafico utilizza l'origine dati GenerativeInsights data, session_id e revision_id per archiviare gli stati correnti delle specifiche SQL e visive di un grafico.

Operazioni della dashboard

Puoi eseguire le seguenti operazioni sulle dashboard configurabili.

Creazione dashboard

Segui questi passaggi per creare la dashboard.

Console

  1. Vai alla console CX Insights, accedi con il tuo Account Google e seleziona il tuo progetto.

    Console CX Insights

  2. Fai clic su Dashboard. Qui puoi vedere sia le dashboard predefinite sia quelle personalizzate.

  3. In Dashboard Studio, fai clic su + Aggiungi dashboard per creare la tua dashboard personalizzata.

  4. Ogni dashboard viene visualizzata sotto forma di riquadro.

  5. Quando fai clic su una dashboard, viene visualizzata una panoramica di tutti i grafici.

API REST

Invia una richiesta come nel seguente esempio.

{
"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

Esegui il seguente comando curl. In questo esempio, il payload viene salvato in 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"

Modifica dashboard

Segui questi passaggi per modificare la dashboard.

Console

  1. Scegli una dashboard e fai clic su Altro more_vert > Modifica per modificarla.

  2. Scegli una delle seguenti opzioni:

  • + Aggiungi riquadro
  • + Aggiungi sezione
  • modifica Rinomina scheda
  • content_copy Duplica scheda
  • delete Elimina scheda
  • Scegli un intervallo di date per visualizzare i risultati.
  • Scegli un riquadro e fai clic su Altro more_vert. Viene visualizzato un riquadro laterale con le seguenti opzioni: Chiedi all'AI, Impostazioni riquadro ed Editor di query.

Opzioni aggiuntive

Chiedi all'AI: fai clic su Chiedi all'AI e inserisci una descrizione testuale delle modifiche. L'assistente AI può aiutarti a creare la dashboard. Hai anche la possibilità di porre domande aggiuntive all'assistente AI. Se fai clic su Salva grafico, puoi eseguire il rollback alle visualizzazioni precedenti. Il linguaggio naturale (LN) ti consente di generare visualizzazioni specificando query descrittive come Qual è il numero medio di conversazioni al giorno per un agente virtuale? Queste query vengono convertite in SQL per l'esecuzione su BigQuery e in specifiche visive (VEGA lite) per la visualizzazione.

Impostazioni riquadro: in questa sezione puoi aggiornare direttamente le specifiche visive per controllare l'attributo del grafico. Ad esempio, puoi modificare il nome visualizzato del grafico. Puoi scegliere il tipo di grafico che preferisci nel menu a discesa. L'API del grafico supporta i seguenti tipi di grafici e rappresentazioni dei dati:

  • BAR
  • LINE
  • AREA
  • PIE
  • A DISPERSIONE
  • TABELLA
  • SCORE_CARD
  • SUNBURST
  • GAUGE
  • SANKEY

Puoi specificare ulteriormente il filtro di conversazione o il nuovo intervallo di tempo al ricaricamento della dashboard.

Editor di query: puoi interagire con l'assistente AI e creare una dashboard. Se non sei soddisfatto della risposta SQL generata dall'AI, puoi aggiornare direttamente l'SQL per rigenerare un grafico e la risposta SQL ripopola ulteriormente le specifiche visive esistenti. L'editor di query mostra l'SQL generato, il cui nome della tabella è mascherato per fare riferimento a una stringa segnaposto predefinita, INSIGHTS_DASHBOARD_VIEW. Nota: puoi eseguire solo operazioni SELECT.

Curl

Esegui il seguente comando curl. In questo esempio, il payload viene salvato in 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"

Elimina dashboard

Segui questi passaggi per eliminare una dashboard e tutti i grafici correlati.

Console

Scegli una dashboard e fai clic su Altro more_vert > Elimina per eliminarla.

Curl

Esegui il seguente comando 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"