版本：8.2.0

如何快速搭建一个超级应用

更新时间：2026-04-30 14:24:27

产品介绍

「超级应用」旨在将观远智能决策平台中现有能力原子化，构建 Agent 友好的开放平台。通过应用托管、CLI/Skill 与超级应用开发框架等模块，赋能企业级各类 AI、数据相关应用开发，支持客户内部 IT 与数据角色以及业务人员高效构建、集成、定制化数据分析、智能体相关应用。

超级应用的表现形式包括：

「超级应用开发框架」是一个前端代码示例库，内置观远 ADK、超级应用调试与发布框架，主要解决超级应用开发效率问题。

「guancli」是一个命令行工具，只需一行指令即可在命令行中读取观远平台相关数据以及完成仪表板新建等操作。主要用来解决各类 Coding Agent 与观远平台交互的便利性与安全性问题。
「guancli skill」是一个提供给 Coding Agent 使用的说明文件，让 AI 知道当用户提到 ETL、数据集、页面、卡片、血缘、SQL、目录、表单、ChatBI 时，应该优先使用 guancli。

例如：当用户说“看一下这个 page”“这个数据集长什么样”“帮我查一下这个 ETL 的 SQL”“页面卡片用了哪些数据集”时，AI 能自动判断需要调用哪些命令。

代码的灵活性也带来潜在安全风险。在保存相关代码或者启用相关代码前，建议各位管理员邀请企业内部相关技术专家、安全专家审阅、评估代码的潜在风险。观远数据（乙方）不承担甲方错误、不当使用超级应用功能而引发的资产损失、数据损失、信息泄露等相关责任。

甲方需要特别注意不应当直接拷贝、使用外部第三方提供的代码或者软件包；不应当使用功能意图不明的代码与软件包。

在开始搭建之前，请确保准备好以下工具：

安装 Node.js

访问 https://nodejs.org/，下载并安装 LTS 版本的 Node.js（包含 npm）。
安装 guancli
- 方法一：使用 npm 命令安装
```
# 首次安装
npm install -g @guandata/guancli

# 已安装过的更新版本
npm update -g @guandata/guancli
```
- 方法二：下载安装包安装
  1. 下载 guancli 安装包：guandata-guancli-1.0.16.tgz
  2. 将安装包解压到目标项目文件夹
  3. 运行安装命令：
```
npm install -g ./guandata-guancli-1.0.16.tgz
```
  安装完成后即可使用 guancli 命令行工具。
安装 guancli skill

使用终端命令或者直接与大模型对话安装 guancli skill。
```
guancli install-skill
```

提供两种创建应用的方式

方法一：使用 guancli 命令创建
```
guancli app create --path [项目存放路径] --name [项目名称]
```
说明
- 若未指定项目存放路径，系统会自动选择默认路径存放项目。
- 项目创建完成后系统会自动启动服务，若未自动启动，则可参考下方自行启动项目。
方法二：与大模型对话创建应用

配置项	说明
Vite_Dev_Port	本地开发调试时开发服务器的端口号。默认使用 `http://localhost:8000` 预览看板。如果跟其他服务冲突，可通过修改这个值来变更端口。
Vite_BI_Host	后端观远 BI 服务器的访问地址，指定应用发布的目标域，数据集等资源来自该域。
配置账密	登录当前域对应的账户，用于识别相应账户的权限，目前仅支持管理员账号发布应用。
UID_Token	用于证明访问权限的安全令牌，在看板嵌入或 API 调用时标识当前用户身份，免去重复登录。 UID Token 获取方式登录到要发布的域，通过浏览器开发者工具获取：「右键 > 检查 > 应用 > Cookie > 选择域 > uid Token」，Cookie Value 即为所需的 UID Token。
Vite_App_ID	创建的应用在 BI 平台中的唯一标识符，应用首次发布成功后会自动生成。

以下以搭建一个简单的看板 demo 为例进行说明。

用自然语言描述想要生成的前端应用。

数据集 ID 的获取方式
- 方法一：进入目标数据集的详情页，查看数据集的 URL，数据集 ID 为图中圈出的部分。
- 方法二：直接与大模型对话，使用 guancli 能力获取数据集 ID ，例如：直接对话大模型「帮我找到名称为 XXX 数据集的 ID」。
大模型会根据要求生成 demo，可以根据自己想要达成的效果来进行描述，不断优化，直至大模型给出的前端 demo 符合要求。