导入并扩展示例工作流

在产品部署目录中提供了两个示例工作流文件（路径：【SuperMap AgentX Server 安装路径】/distribute/compose/workflow_examples/）

  • 多智能体框架.json：展示如何通过多个智能体协同完成复杂空间分析任务；
  • 外部数据集调用iServer GPA示例.json：演示如何在工作流中调用 SuperMap iServer 的 GPA 组件，实现专业地理处理与分析。

这两个工作流均深度集成 SuperMap iServer GPA 能力，支持空间分析、数据转换、地图处理等常见 GIS 操作，并具备良好的扩展性，您可基于此快速构建符合自身业务需求的工作流。

接下来将以导入多智能体框架.json为例，演示如何导入并使用示例工作流。具体步骤如下：

一、准备工作

在开始导入工作流之前，请确保您的环境已部署

  • SuperMap AgentX Server
  • SuperMap iServer（端口 8090，并启用 GPA 功能）
  • PostgreSQL 容器（服务名 agentx-postgres）已启动且包含 PostGIS 扩展 

二、导入示例数据库

说明：针对外部数据集调用iServer GPA示例.json示例文件，默认需要导入示例数据库，如果您想使用自己的数据库，可跳过此步骤。

运行以下命令，检查数据库容器状态，确认 PostgreSQL 容器正在运行：

docker compose ps

应看到服务名为 agentx-postgres 的容器状态为 running。

执行数据导入脚本

bash
chmod +x data_import.sh
./data_import.sh

脚本会自动：

  1. 自动向上查找 docker-compose.yml 所在目录
  2. 将 demo_data.dump 复制到容器内 /tmp 目录
  3. 在容器内执行 pg_restore：
    1. 创建数据库 demo_data
    2. 导入所有空间数据表
    3. 创建 PostGIS 扩展（如果尚未创建）

导入成功后，数据库 demo_data 中将包含多个空间数据集，如道路、河流、土地利用等。

数据样例集说明

  • 数据源文件：demo_data.dump
  • 数据库：Schema：demo_data
  • 数据用途：用于演示多智能体框架的工作流，以及调用iServer的GPA MCP工具的工作流
  • 坐标系 (SRID)：GCS_WGS_1984
  • 最后更新时间：2025-12-15

本数据包含以下演示/可操作性数据集 （北京）

_R (Region)：面状要素（Polygon/MultiPolygon），表示区域、地块等。

_L (Line)：线状要素（LineString/MultiLineString），表示道路、河流等。

_P (Point)：点状要素（Point/MultiPoint），表示POI点、城镇中心等

名称 类型 描述
Neighbor_R  面 (Polygon) 北京邻区/周边区域，表示主要研究区域外部的相邻行政区划或地块
BaseMap_R  面 (Polygon) 北京城区及区县
Geomor_R 面 (Polygon) 北京地貌/地形区。表示不同的地质地貌单元（如平原、丘陵区域）
Lake_R 面 (Polygon) 北京湖泊水域。封闭的静态水体区域
Landuse_R 面 (Polygon) 北京土地利用现状。表示地块的用途（旱地、草地、水浇地等）
River_L 线 (Line) 北京河流/水系。线性的流动水体网络
Road_L 线 (Line) 北京道路路网。包含主要干道、次干道等交通网络
Town_P 点 (Point) 北京城镇/村落点。表示城镇的中心位置或主要居民点坐标
GreenFeild_R 面 (Polygon) 北京绿地/野外区域。公园、草地或未开发自然区域

三、在 iServer 中注册数据库

说明：针对外部数据集调用iServer GPA示例.json示例文件，如果您想使用自己的数据库，此步骤可直接将您的数据库注册进iServer中。

访问 iServer 管理页面 http://<服务器IP>:8090/iserver/ ，使用管理员账号登录。点击服务管理->数据->数据注册->注册数据存储，填写以下信息：

  • 存储ID：demo_data
  • 存储数据类型：空间数据库
  • 数据库存储类型：POSTGRESQL
  • 服务地址：agentx-postgres:5432
  • 数据库名称：demo_data
  • 用户名：agentx
  • 密码：agentx_2025
  • 允许编辑：勾选

点击注册数据存储，注册成功后，可在列表中看到 demo_data 及其包含的数据集（如 demo_data_Road_L、demo_data_Lake_R 等）。

四、发布地图服务

访问 iServer 管理页面 http://<服务器IP>:8090/iserver/ ，使用管理员账号登录。点击服务管理->服务->服务管理->快速创建服务，填写以下信息：

  • 选择数据源：文件型工作空间
  • 工作空间文件：点击选择->上传数据，选择 workstudio_example 目录下的 demo_workspace.zip，会在后台自动解压，继续选择解压后的工作空间文件 demo_data.smwu
  • 服务类型：REST-地图服务
  • 其他配置保持默认设置

点击发布。发布成功后，系统会生成一个地图服务 URL，用于后续可视化展示。

五、导入示例工作流

访问 SuperMap AgentX Server 低代码搭建工作流式智能体页面 http://<服务器IP>:8490/agentx/workflowstudio/

  • 选定某个项目后，点击项目列表上方的按钮
  • 选择上传多智能体工作流示例.json文件

上传成功后，在工作流列表中应出现名为 “多智能体工作流示例” 的项目。您可以点击运行测试，工作流将调用 iServer GPA 进行分析，并将结果写入 demo_data 数据库，通过已发布的地图服务进行可视化展示。

至此，已完成在低代码搭建工作流式智能体中导入示例工作流，可用于演示和测试多智能体工作流在真实空间数据上的分析与可视化过程。

六、后续数据扩展建议

针对产品包内带的示例工作流文件，如需导入更多演示数据，推荐使用 SuperMap iDesktop 或 iDesktopX 进行数据集管理：

1、确保 PostgreSQL 容器开放 5432 端口（可在 docker-compose.yml 中配置）

2、使用 iDesktop 或 iDesktopX 连接数据库，打开 iDesktop 或 iDesktopX ，在“工作空间管理器”的“数据源”节点上右键，选择打开数据库型数据源，填写连接信息

  • 引擎类型：PostgreSQL
  • 服务器地址：localhost:5432 (或宿主机实际IP)
  • 数据库名称：demo_data (可自定义)
  • 用户名称：agentx
  • 用户密码：agentx_2025

点击打开，若连接成功，即可看到当前库中已有的 Neighbor_R 等数据集。

3、导入/复制新数据

打开源数据：在 iDesktop/iDesktopX 中打开包含新演示数据的各类型数据源（如 UDB/UDBX、Shapefile、GDB 等）。
在源数据源下选中需要导入的数据集->鼠标右键点击复制数据集->选中 demo_data 数据库数据源->鼠标右键点击粘贴数据集。

可勾选创建空间索引以提升查询性能；字符集保持默认（UTF-8）；

点击导入完成操作。

4、在 iServer 中刷新

访问 iServer 管理页面 http://<服务器IP>:8090/iserver/ ，使用管理员账号登录。点击服务管理->数据->数据注册，找到 demo_data 存储项。可以看到新导入的数据集被列出，在 GPA 分析或相关MCP中即可调用新导入的数据集。