Visualize as métricas de uso e feedback do Customer Experience Insights ao longo do tempo com um painel configurável. Os painéis configuráveis oferecem flexibilidade na representação e no layout dos dados, porque você pode criar e manter visualizações personalizadas com vários gráficos. O painel configurável permite selecionar um tipo de gráfico, armazenar a configuração e recuperá-la na próxima vez que você acessar a página.
Componentes do painel
Um painel contém os seguintes componentes.
| Componente | Descrição |
|---|---|
| Painel | O recurso de nível superior que armazena toda a estrutura e as definições de gráfico. |
| Seção | Uma seção pode ter blocos ou seções aninhadas (que aparecem como guias). As seções do painel podem ter um nome de exibição e uma descrição. É possível aplicar o filtro date_range a todos os gráficos em uma guia inteira. As seções definem as dimensões físicas usando largura e altura em unidades de grade. |
| Bloco | Um elemento no painel, definido como uma seção aninhada ou um gráfico. O período padrão é a semana passada. Você pode consultar ainda mais o date_range como último dia, últimos dois dias, última semana, últimas duas semanas, último mês, último trimestre, último ano ou as datas de início e término personalizadas. |
Definições de campo do painel
Cada painel é composto pelos seguintes campos. Somente display_name e description aparecem no console.
| Campo | Descrição | Restrições/observações |
|---|---|---|
name |
Nome do painel | Formato: projects/{project}/locations/{location}/dashboards/{dashboard} |
display_name |
Nome fornecido pelo usuário para o painel | Máximo de 100 caracteres |
description |
Descrição do painel | Opcional |
create_time |
Timestamp de criação do painel | Somente saída |
update_time |
Timestamp da última atualização do painel | Somente saída |
filter |
Filtro para todos os gráficos no painel | Aceita filtro de string opcional |
Dados e consultas
O gráfico usa linguagem natural (LN), que o Customer Experience Insights traduz em consultas SQL. Essas consultas geram os dados e as especificações visuais para mostrar o gráfico. As especificações visuais estão em um formato VEGA-LITE. A API de gráfico usa a fonte de GenerativeInsights data, session_id e revision_id para armazenar os estados atuais de SQL e especificações visuais de um gráfico.
Operações do painel
É possível realizar as seguintes operações em painéis configuráveis.
Criar painel
Siga estas etapas para criar seu painel.
Console
Navegue até o console do CX Insights, faça login com sua Conta do Google e selecione seu projeto.
Clique em Painel. Aqui, você pode conferir painéis pré-criados e personalizados.
No estúdio do painel, clique em + Adicionar painel para criar seu próprio painel personalizado.
Cada painel aparece na forma de um bloco.
Ao clicar em um painel, você tem uma visão geral de todos os gráficos.
API REST
Envie uma solicitação como o exemplo a seguir.
{
"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
Execute o comando curl a seguir. Neste exemplo, o payload é salvo em 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 dashboard
Siga estas etapas para editar seu painel.
Console
Escolha um painel e clique em Mais more_vert > Editar para editar o painel.
Escolha uma das seguintes opções:
- + Adicionar bloco
- + Adicionar seção
- Editar Renomear guia
- content_copy Duplicar guia
- delete Excluir guia
- Escolha um período para conferir os resultados.
- Escolha um bloco e clique em Mais more_vert. Um painel lateral aparece com as seguintes opções: "Perguntar à IA", "Configurações do bloco" e "Editor de consultas".
Mais opções
Perguntar à IA: clique em "Perguntar à IA" e insira uma descrição de texto das mudanças. O assistente de IA pode ajudar você a criar seu painel. Você também tem a opção de fazer perguntas complementares ao assistente de IA. Se você clicar em Salvar gráfico, poderá reverter para as visualizações anteriores. A linguagem natural (LN) permite gerar visualizações especificando consultas descritivas, como Qual é a contagem média de conversas por dia para um agente virtual? Essas consultas são convertidas em SQL para execução no BigQuery e em especificação visual (VEGA lite) para fins de exibição.
Configurações do bloco: nesta seção, é possível atualizar a especificação visual diretamente para controlar o atributo do gráfico. Por exemplo: mudar o nome de exibição do gráfico. Você pode escolher o tipo de gráfico preferido no menu suspenso. A API de gráfico aceita os seguintes tipos de gráfico e representações de dados:
- BAR
- LINE
- AREA
- PIE
- SCATTER
- TABLE
- SCORE_CARD
- SUNBURST
- GAUGE
- SANKEY
Você pode especificar ainda mais o filtro de conversa ou o novo período ao recarregar o painel.
Editor de consultas: é possível interagir com o assistente de IA e criar um painel. Se você não estiver satisfeito com a resposta SQL gerada pela IA, poderá atualizar o SQL diretamente para regenerar um gráfico. A resposta SQL também repopula a especificação visual atual. O editor de consultas mostra o SQL gerado, cujo nome da tabela é mascarado para referenciar uma string de marcador predefinida, INSIGHTS_DASHBOARD_VIEW. Observação: só é possível fazer qualquer operação SELECT.
Curl
Execute o comando curl a seguir. Neste exemplo, o payload é salvo em 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"
Excluir painel
Siga estas etapas para excluir um painel e todos os gráficos relacionados.
Console
Escolha um painel e clique em Mais more_vert > Excluir para excluir o painel.
Curl
Execute o comando curl a seguir.
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"