用途:指导编写、优化、校验并同步 Contact Center AI (CCAI) Insights 可配置仪表盘。该仪表盘支持构建多标签页报表视图,组件由 Vega-Lite 规格和针对对话指标的 SQL 查询驱动。
主要能力:以声明式 dashboards.yaml 定义仪表盘,含 version、project_id、location、dashboard_id、display_name、date_range、root_container 等字段。支持的可视化类型:SCORE_CARD、BAR、LINE、AREA、PIE、SCATTER、TABLE、SANKEY。每个 chart 通过 data_source.generative_insights 提供 sql_query 与 Vega-Lite chart_spec。
结构要求:每个仪表盘必须有 root_container;root_container 下的直接组件必须全部是代表标签页或分区的 Container 组件。标签页内可包含子组件(container 分组、chart 可视化或 chart_reference 关联图表)。
使用方式:先收集用户所需指标、KPI 或标签页及目标 GCP 项目 ID 与位置,再创建或更新 dashboards.yaml。常用命令: 预览差异:uv run cxas insights diff-dashboards --file dashboards.yaml 干跑部署:uv run cxas insights push-dashboards --file dashboards.yaml --dry-run 推送部署:uv run cxas insights push-dashboards --file dashboards.yaml 如需删除远端过时仪表盘可加 --force。 拉取:uv run cxas insights pull-dashboards --parent projects/PROJECT_ID/locations/LOCATION [--out dashboards.yaml] 列出:uv run cxas insights list-dashboards --parent projects/PROJECT_ID/locations/LOCATION 获取:uv run cxas insights get-dashboard --dashboard-name projects/PROJECT_ID/locations/LOCATION/dashboards/DASHBOARD_ID 删除:uv run cxas insights delete-dashboard --dashboard-name projects/PROJECT_ID/locations/LOCATION/dashboards/DASHBOARD_ID
适用场景:需要为联络中心构建高管 KPI、坐席质检、自助服务拦截率、主要来电驱动因素、CSAT 趋势等多标签页分析视图时。
限制:资料未提供计费、价格、平台依赖等细节;所依据的对话数据表结构需参考所附 SQL cookbook 与 Vega-Lite cookbook。