BuilderX 内置了可以智能生成、编辑页面的 AI 助手(Beta)，其智能生成能力由 QwenPaw 提供模型调度与 Agent 运行时支撑，你只需要用自然语言描述需求，比如「生成一个水利水务监测应用，左边放置地图，右边放置图表，采用青蓝科技风」，AI 就会根据你提供的数据和地图找到合适的组件，帮你完成页面规划与搭建，旨在降低用户操作门槛，进一步提升应用搭建效率。

注意：BuilderX AI 助手目前仅在 SuperMap iPortal 2026 Update1 及后续版本支持，且仅通过 Docker Compose 包提供，此前版本或其他部署方式暂不支持。

支持功能

用户在 AI 助手中可通过自然语言描述需求，在当前正在编辑的页面中实现以下功能：

  • 生成页面：为空白页面规划内容、页面版式、视觉风格，最终从空白页面生成一个完整页面，仅全屏应用支持，滚动页面暂不支持
  • 修改页面：为已有页面生成页面版式、视觉风格优化方案，仅全屏应用支持，滚动页面暂不支持
  • 组件编辑：新增、删除组件、修改组件属性、调整组件在页面中的布局位置，仅全屏应用支持，滚动页面暂不支持
  • 组件查询：查询当前页面已添加的组件
  • 使用资源：在页面中添加数据、为组件绑定数据、列出已有数据源、预览数据源部分字段信息，当前支持以下数据。暂不支持在 AI 助手中上传本地文件，如需使用本地文件，请先在 BuilderX 中手动添加数据源

    • 地图：来自 iPortal 资源中心的公共地图、我的地图、公共地图服务、我的地图服务、用户提供的 iServer RestMap 地图服务、SuperMap Online 地图、天地图，服务均可选择服务内具体的某一幅地图

    • 三维场景：来自 iPortal 资源中心的公共场景、我的场景，场景底图支持天地图底图

    • 数据：来自 iPortal 资源中心的数据、iServer RestData 数据服务、当前页面地图中的图层数据

  • 应用保存：当用户明确要求时，将当前完整应用保存到 iPortal，支持保存当前应用和另存为

模型配置

使用 AI 助手前，需确保 QwenPaw 中已配置可用的模型，配置入口：http://<server>:<port>/models, 其中 <server>:<port> 是您当前 iPortal 服务的地址，例如 iPortal 地址是 http://127.0.0.1:8190/iportal，则模型配置地址为：http://127.0.0.1:8190/models，在 QwenPaw 中配置模型的具体方式可参考：QwenPaw 模型。您也可以直接与 AI 助手对话， AI 助手会提供可直接跳转的 QwenPaw 模型配置地址。

使用步骤

您可以按照以下步骤，通过 AI 助手进行应用搭建：

  1. 在 BuilderX 中创建或打开已有应用，进入当前需要编辑的页面；
  2. 从左侧边栏切换至 AI 助手，在 AI 助手面板底部对话框中描述并发送页面搭建或优化需求，AI 助手将自动规划页面结构、内容与样式，根据需求生成预览方案，如果对预览方案不满意，您可以继续通过对话调整；
  3. 当您确认页面效果没问题后，可以通过对话保存应用。

注意：

  1. 当 AI 助手连接失败时，请依次检查：（1）BuilderX 页面是否已打开并且已经成功连接 MCP Server；（2）AI 客户端配置中的 Server 地址和端口是否正确；（3）防火墙是否放行 WebSocket 9527 和 HTTP 9528 端口。
  2. 当页面刷新、页面切换、页面重连或上下文过期后，AI 生成的预览方案将失效，需要重新生成。
  3. 为了避免 AI 生成效果影响已有页面成果，AI 助手对页面的改动不会自动保存到 iPortal，只有在用户明确要求时才会保存应用。
  4. AI 助手只能操作您当前正在编辑的单个页面，暂不支持新建、删除、切换页面，也不支持同时修改多个页面、修改其他页面以及未打开应用中的页面，如果需要 AI 助手操纵多个页面，请先手动创建页面后切换到目标页面，再从该页面发起新的会话。

AI 话术参考

页面

  1. 当期望从空白页面生成完整页面时，需要描述整页需求，建议在对话中指明期望的内容、页面版式和视觉风格，三者可以单独提出或自由组合：
  • 页面内容：采用哪些数据、地图或场景构建什么内容主题的页面，例如：「使用 Online 中的“四川省电站发电”地图和“四川发电站上月发电量”数据制作发电数据可视化看板」
  • 页面版式：地图、图表和指标在页面中的位置关系，例如：「地图居中，两侧放分析图表，底部放指标」、「左侧放置地图，右侧放置图表组」
  • 视觉风格：页面中背景、主色、面板、标题、指标和图表的视觉语言，例如：「青蓝科技风」、「暖橙工业风」、「藏青商务风」、「荧光绿未来风」

话术示例：「使用 Online 中的“四川省电站发电”地图和“四川发电站上月发电量”数据生成一个发电数据可视化看板，采用左侧地图、右侧图表组的版式，整体使用暖橙工业风」、「使用 Online “第七次人口普查”第一幅地图和“第七次人口普查全国各省人口数”图层数据制作人口普查数据可视化页面，地图居中，左右两侧展示各省人口数量变化趋势和人口总数排行图表，顶部放两个关键指标，采用青蓝科技风」

  1. 若需重新生成页面效果，需要在对话中明确表达重建意图，并说明是否要保留已有的业务主题、页面版式或视觉风格。

话术示例：「重新搭建一个自然资源主题的页面」、「在保留现有业务数据的基础上，把当前页面整体替换为青蓝科技风」

组件

  1. 当期望在页面中新增组件、修改已有组件的属性、删除指定组件、调整组件在页面中的布局位置时，建议在对话中明确指明目标组件和期望完成的操作。

话术示例：「在页面右上角新增一个按钮」、「把销售图表的标题改成橙色」、「删除电力变化折线图」

数据

  1. 当期望查看当前页面有哪些可用数据时，可以询问页面已有的数据源，或指定数据以及要预览的字段。

话术示例：「页面里有哪些可用数据？」、「预览“设备告警”数据的设备名称、告警级别和发生时间」

  1. 当期望指定数据源生成组件或为组件绑定数据，建议在对话中指定数据源准确的名称或 URL，以及使用数据中具体哪些字段；使用地图图层数据时，明确指定哪个图层。

话术示例：「使用当前页面中“10月销售额”数据源创建一个饼图，放置在页面右侧」、「使用 https://<server>:<port>/iserver/services/data-demo/rest/data/datasources/World/datasets/Countries 创建图表」、「使用当前地图中的“监测站点”图层生成站点数量指标」、「添加我的场景中的“城市三维模型”」、「把当前三维场景的底图切换为天地图影像」

  1. 当期望对数据进行统计处理时，建议在对话中指定数据准确的字段名称和处理操作。

话术示例：「按区县统计用水量总和，降序显示前 10 名」、「按月份计算平均降雨量，并按月份升序排列」

保存

  1. 在对话中明确说出保存需求，AI 会调用保存工具，将当前应用完整保存到 iPortal。

话术示例：「将当前应用保存到 iPortal」、「将当前应用另存为 iPortal」

不建议使用的表达

  • 仅提到「美化一下」：缺少风格、范围和保留内容要求，AI 生成结果不可控，应指明页面版式和视觉风格等修改方向。
  • 同时指定多个主题风格：例如「既要青蓝又要暖橙」、「青蓝科技风和暖橙工业风都试试」会形成歧义，应明确采用哪一个主题风格。
  • 把版式当颜色：“换成左图右表风格”只表达了布局，没有表达颜色和材质。
  • 把业务主题词当视觉风格：例如“使用医疗风格”可能同时触发医疗内容理解；需要只借用业务主题的颜色时，应说「使用荧光绿科技风，业务内容保持不变」。

历史记录

AI 助手支持自动保存对话历史记录，历史记录可从最新一条追溯至第一条，支持关键字搜索对话。

  • 查看历史会话：点击 AI 助手面板右上角的“查看会话记录”，在面板中会显示历史会话记录，每条记录保存了对话内容，但不保存对话所实现的页面效果。
  • 恢复历史会话：在历史会话列表中，选择某一条历史会话，会在 AI 助手面板中加载该会话记录。