Quick BI CLI 安装与使用指南

第一步：通过对话安装

• 打开您的 AI 智能体工作台，并在对话框输入以下命令并发送：

  作为Agent助手，请参考说明安装Quick BI CLI：https://quickbi-prod.oss-cn-beijing.aliyuncs.com/quickbi-cli/AI_INSTALLATION_GUIDE.md

• 当看到“Quick BI CLI 安装成功”的提示，说明已完成安装。

第二步：配置凭证

• 安装完成后，AI 助理将主动向您要求提供您的身份凭证。您需将个人的身份凭证发送给您的 AI 助理完成配置设置。

  

• 如何获取身份凭证：登录 Quick BI 控制台 → 挪动光标至右上角头像 → 个人识别码 → 复制对应信息。

  

示例一：报表快速外嵌

场景概述

在企业日常运营中，经常需要将数据报表分享给外部合作伙伴、管理层查看。传统的报表嵌入方式需要技术人员手动调用 API 接口，开通流程长且需要定时任务维护票据续期。

通过 Quick BI CLI，您只需用自然语言描述需求，即可一键完成报表的免密嵌入配置，并直接发送给指定人员。

使用示例

场景描述：将指定工作空间下的报表开通嵌入访问权限，设置访问有效期，并生成分享链接。

适用场景

• 向客户展示业务数据报表

• 向管理层汇报经营数据

• 跨部门数据共享与协作

功能说明

CLI 将自动完成以下操作：

• 生成报表嵌入 Ticket

• 设置访问有效期（支持自定义天数）

• 返回可访问的嵌入链接

• 通过指定渠道发送给接收人（可选）

操作指令示例：

• 基础用法：“使用 Quick BI CLI，将 xx 工作空间下的 xx 报表开通嵌入访问，访问时间限制为 30 天，设置完成后返回链接给我。”

• 进阶用法：“使用 Quick BI CLI，将 xx 工作空间下的 xx 报表开通嵌入访问，访问时间限制为 30 天，设置好后发送给 xx 人员查看，内容为：您好，这是我们公司的销售数据，请查收。”

效果示例如下：

示例二：数据资产盘点与审计分析

场景概述

企业数据资产的管理需要定期审计和性能分析，以了解资源使用情况和优化方向。传统的审计日志和性能分析仅提供界面展示或 OpenAPI 接口，前者信息展示有限，后者技术门槛较高。

Quick BI CLI 提供了自然语言交互式的数据审计能力，帮助您快速获取数据资产的使用情况和性能表现。

适用场景

• 定期数据资产盘点

• 报表使用热度分析

• 性能瓶颈排查与优化

• 数据治理与合规审计

功能说明

CLI 将为您提供：

• 资源审计：以表格形式展示访问量排名、访问趋势等统计信息

• 性能分析：针对指定报表或仪表板，分析其关联数据集的查询性能、响应时间等指标

使用示例

场景描述：查看近期访问量最高的报表，并对热门报表进行性能分析。

操作指令示例：“使用 Quick BI 命令行工具，用表格展示近 7 天访问量前 10 的报表，并对排名第一的仪表板根据关联数据集做近七天的性能分析。”

效果示例如下：

同时，可查看详细的性能分析报告，包括详细的组件清单、业务指标映射与优化建议。

示例三：组织成员管理

场景概述

传统方式依赖人工在控制台操作，流程繁琐。Quick BI CLI 支持通过自然语言指令快速完成成员管理任务。企业在以下场景需要频繁进行成员管理操作：

• 新员工入职，需要创建 Quick BI 账号并分配权限

• 系统迁移，需要将用户从旧系统批量导入

• 组织架构调整，需要变更成员角色或所属工作空间

适用场景

• 新员工入职账号开通

• 批量导入用户数据

• 工作空间成员权限调整

• 组织架构变更后的权限同步

功能说明

CLI 支持以下组织成员管理能力：

• 添加组织成员

• 将成员添加到指定工作空间

• 批量更新工作空间成员角色

使用示例

场景描述：为新入职员工创建账号并添加到指定工作空间。

操作指令示例：“使用 Quick BI CLI，将今天入职的新同事 xxx 加入组织，并添加到 xx 的工作空间作为分析师。”

效果示例如下：