通过可配置的信息中心，查看客户体验数据分析随时间变化的用量和反馈指标。可配置的信息中心在数据呈现和布局方面非常灵活，因为您可以使用各种图表来构建和维护自定义视图。借助可配置的信息中心，您可以选择图表类型、存储配置，并在下次访问该页面时检索配置。
信息中心组件
信息中心包含以下组件。
| 组件 | 说明 |
|---|---|
| 信息中心 | 用于存储整个结构和图表定义的顶级资源。 |
| 部分 | 一个版块可以包含功能块或嵌套版块（显示为标签页）。信息中心部分可以有显示名称和说明。您可以将 date_range 过滤条件应用于整个标签页中的所有图表。版块使用网格单位的宽度和高度来定义其物理尺寸。 |
| 模块 | 信息中心内的元素，定义为嵌套部分或图表。默认日期范围为“上周”。您可以进一步查询 date_range，例如过去 1 天、过去 2 天、过去 1 周、过去 2 周、过去 1 个月、过去 1 个季度、过去 1 年或自定义的开始日期和结束日期。 |
信息中心字段定义
每个信息中心都包含以下字段。控制台中仅显示 display_name 和 description。
| 字段 | 说明 | 限制/备注 |
|---|---|---|
name |
信息中心名称 | 格式：projects/{project}/locations/{location}/dashboards/{dashboard} |
display_name |
用户提供的信息中心名称 | 最多 100 个字符 |
description |
信息中心说明 | 可选 |
create_time |
信息中心创建时间戳 | 仅限输出 |
update_time |
信息中心上次更新时间戳 | 仅限输出 |
filter |
过滤信息中心内的所有图表 | 支持可选的字符串过滤条件 |
数据和查询
该图表使用自然语言 (NL)，客户体验数据分析会将其转换为 SQL 查询。这些查询会生成用于显示图表的数据和视觉规范。可视化规范采用 VEGA-LITE 格式。图表 API 使用 GenerativeInsights data 源、session_id 和 revision_id 来存储图表的当前 SQL 和可视化规范状态。
信息中心操作
您可以对可配置的信息中心执行以下操作。
创建信息中心
请按照以下步骤创建信息中心。
控制台
前往 CX Insights 控制台，使用您的 Google 账号登录，然后选择您的项目。
点击信息中心。您可以在此处查看预构建的信息中心和自定义信息中心。
在信息中心工作室中，点击 + 添加信息中心以创建您自己的自定义信息中心。
每个信息中心都以图块的形式显示。
点击某个信息中心后，系统会显示所有图表的概览。
REST API
提交如下示例所示的请求。
{
"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
运行以下 curl 命令。在此示例中，载荷保存在 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"
修改信息中心
请按照以下步骤修改信息中心。
控制台
选择一个信息中心，然后依次点击更多图标 more_vert > 修改，以修改该信息中心。
请从下列选项中选择一项：
- + 添加功能块
- + 添加部分
- 修改 重命名标签页
- content_copy 复制标签页
- 删除 “删除”标签页
- 选择日期范围以查看结果。
- 选择一个功能块，然后点击更多图标 more_vert。系统会显示一个侧边栏，其中包含以下选项：“向 AI 提问”“平铺设置”和“查询编辑器”。
其他选项
向 AI 提问：点击“向 AI 提问”，然后输入对更改的文字描述。AI 助理可帮助您构建信息中心。您还可以选择向 AI 助理提出后续问题。如果您点击保存图表，则可以回滚到之前的可视化图表。借助自然语言 (NL)，您可以通过指定描述性查询（例如虚拟客服每天的平均对话次数是多少？）来生成可视化图表。这些查询会转换为 SQL 以针对 BigQuery 执行，并转换为可视化规范 (VEGA Lite) 以用于显示。
图块设置：在此部分中，您可以直接更新视觉规范来控制图表属性。例如：更改图表的显示名称。您可以在下拉菜单中选择所需的图表类型。图表 API 支持以下图表类型和数据表示形式：
- BAR
- LINE
- AREA
- PIE
- SCATTER
- 表
- SCORE_CARD
- SUNBURST
- 仪表盘
- SANKEY
重新加载信息中心后，您可以进一步指定对话过滤条件或新的时间范围。
查询编辑器：您可以与 AI 助理互动并构建信息中心。如果您对 AI 生成的 SQL 回答不满意，可以直接更新 SQL 以重新生成图表，并且 SQL 回答会进一步重新填充现有的可视化规范。查询编辑器会显示生成的 SQL，其表名称已屏蔽，以引用预定义的占位字符串 INSIGHTS_DASHBOARD_VIEW。注意：您只能执行任何 SELECT 操作。
Curl
运行以下 curl 命令。在此示例中，载荷保存在 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"
删除信息中心
请按照以下步骤删除信息中心和所有相关图表。
控制台
选择一个信息中心，然后依次点击更多 more_vert > 删除，即可删除该信息中心。
Curl
运行以下 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"