元信息管理

SuperMap AgentX Server 提供统一的元信息管理入口，用于集中展示、检索、接入和维护平台中的空间数据元信息，并结合向量化能力为后续语义检索与智能分析提供支撑。元信息管理中的数据集，当前可在低代码搭建智能体中检索与使用。

以管理员身份登陆 AgentX 首页，依次进入后台管理>元信息管理，页面主要包含以下功能模块：

  • 元信息管理：统一浏览已接入的数据集，支持搜索、分类过滤、查看详情、触发向量化和删除等管理操作。
  • 数据接入：支持从目录和数据库扫描数据源，按需选择数据集接入。
  • 数据源管理：支持注册、修改、取消注册数据源，查看已接入数据集和不扫描数据集，设置维护模式，并执行检查更新。
  • 分类管理：支持多级分类维护、分类详情查看与分类名称修改。
  • 向量管理：查看当前向量化统计、向量配置。

元信息管理

元信息管理模块用于集中展示系统中已接入的数据集信息。页面以数据卡片形式显示数据集名称、格式、分类、几何类型、标签、更新时间以及当前向量状态。

查看数据集

在元信息管理页面中，可直接浏览当前已接入的数据集卡片信息。每个数据集卡片支持展示以下内容：

  • 数据集名称与数据格式标识，例如 PostGIS、Shapefile、GeoTIFF、UDBX、UDB 等；
  • 数据分类、几何类型、标签与更新时间；
  • 向量化状态，包括未向量化、处理中、已完成和失败等状态。

搜索与筛选数据集

元信息管理提供面向数据集的快速检索与条件筛选能力，用于缩小目标数据范围。

  • 搜索方式：支持关键词检索和语义检索两种模式；
    • 关键词检索：根据数据集名称、描述等字段进行模糊匹配；
    • 语义检索：使用自然语言描述意图，基于向量相似度返回结果。需要注意的是，数据集元信息需向量化后，方可支持语义检索。
  • 分类筛选：支持按多级分类筛选数据集，选择某一级分类时，结果包含该分类及其子分类下的数据集；
  • 分类展示：默认不展示临时数据分类，用户可按需勾选展示。

查看数据详情

点击数据卡片可进入数据详情页，查看当前数据集的详细信息。

  • 基本信息：查看数据集名称、描述、分类、格式、来源、几何类型等信息；
  • 空间信息：查看几何类型、空间范围、坐标参考等信息；
  • 属性字段：查看数据集属性字段列表及相关字段类型信息；
  • 状态信息：查看数据集向量状态及语义描述，可按需重建向量。

管理数据集

在数据卡片的更多操作菜单中，可对数据集执行以下管理操作：

  • 编辑：进入数据详情页查看和维护数据集信息；
  • 向量化：对指定数据集发起向量化操作，向量化后的数据集可支持语义检索；
  • 删除：按需删除当前数据集。

数据接入

数据接入模块用于新增数据源并将扫描的数据集结果按需导入元信息目录，支持目录接入与数据库接入两种模式。

目录接入

选择目录接入模式后，可扫描文件系统目录中的 GIS 数据文件。

  • 目录路径：填写待扫描目录；需要注意的是，待扫描的数据目录必须放置在产品包/cfg/metadata/data/路径下，填写时填入路径/app/metadata/data；
  • 数据源名称：可自动生成，也可手动修改；
  • 文件类型：支持选择 .shp、.tiff、.tif、.udbx、.udb 等文件扩展名；
  • 递归扫描：支持开启目录递归扫描；
  • 扫描目录：执行扫描后查看并选择可导入的数据集。
注意：

数据源名称不能与现有数据源重复。若页面提示名称已存在，需要修改后再执行接入或扫描。

数据库接入

选择数据库接入模式后，可接入数据库中的空间数据表。

接入方式

数据库接入提供两种接入方式：

  • 选择已注册数据源接入：从已有数据源列表中选择目标数据源，并执行扫描与接入；
  • 注册数据源并接入：新增数据库数据源后直接发起扫描与接入。
    • 数据库类型：支持 PostGIS、PostgreSQL 和 SuperMap PostGIS数据库；
    • 连接信息：包括主机、端口、数据库、Schema、用户名和密码；
    • 数据源名称：可自动生成，也可手动修改；
    • 测试连接：用于校验数据库连接是否可用。
注意：

当前已支持接入ArcGIS PostGIS类型的SDE数据库并支持读取该数据库数据集的字段别名，需要注意是，对接SDE数据库时需先在SuperMap iDesktopX中新建PostGIS数据源，在元信息管理中通过选择 SuperMap PostGIS数据库类型完成接入。

扫描与接入设置

  • 扫描范围：支持扫描全部空间表，或按指定表名扫描。
  • 扫描起始位置：支持设置数据集扫描的起始位置，可从头开始扫描，也可输入序号，从序号位置的表开始扫描。
  • 单次扫描数量：设置单次扫描数据集的数量，默认50个/次，支持按批次扫描，降低大规模数据源一次性扫描带来的性能和操作压力。
  • 标签和分类：支持自动添加标签和分类，也支持手动填入标签和分类，您可以按需选择。

数据库接入的扫描完成后，会生成待导入数据预览列表，便于逐条或批量选择需要接入的数据集。对当前不需要接入的数据集，可点击忽略加入不扫描列表，后续扫描时将不再显示，接入成功的数据集会同步展示在数据源管理->已接入数据集列表中，便于后续查看和管理。

数据源管理

数据源管理模块用于统一维护已注册的数据源，并从数据源维度查看接入数据集与不扫描数据集。

管理数据源

  • 注册数据源：新增数据库类型的数据源：
    • 数据库类型：支持 PostGIS、PostgreSQL 和 SuperMap PostGIS数据库；
    • 连接信息：包括主机、端口、数据库、Schema、用户名和密码；
    • 数据源名称：可自动生成，也可手动修改；
    • 测试连接：用于校验数据库连接是否可用。
  • 取消注册数据源：支持取消注册不再使用的数据源。
  • 进入维护模式：维护模式用于在数据库迁移、结构调整或其他需要暂时冻结元信息变更的场景下，暂停指定数据源的自动同步和手动更新操作。同时，维护期间不能扫描接入数据集、移除已接入数据集。
  • 退出维护模式：维护完成后，支持退出维护模式，退出维护后自动执行一次检查更新。
  • 检查更新：支持定期检查更新，检测本地数据源是否发生了数据集的增删、数据集元信息的改动。检查更新将主动触发数据源差异检测，扫描实际数据源的字段别名信息，并将扫描结果与已接入的元信息进行比较，当检测到冲突时，您可以选择保留元信息管理中的值（推荐），或使用实际数据源中的值覆盖。当前支持两种更新模式：
    • 局部更新：仅扫描已接入数据集，检测并更新其元信息，不新增或移除数据集。
    • 全局更新：扫描整个数据源；除更新已接入数据集外，还会将检测到的新数据集增量接入。需要注意的是，已加入“不扫描数据集”列表的数据集在全局更新时不会被扫描接入。
  • 备份恢复：支持定期将数据源记录导出到本地备份，按需导入恢复，有效降低误操作、系统故障等导致的数据意外丢失风险。
    • 备份：将数据源记录（数据集的描述、分类、标签和属性字段）导出为带时间戳的 JSON 文件，放置于指定的位置；
    • 恢复：将备份到本地的JSON文件上传，选择需要恢复到备份记录的数据集，确认导入即可。需要注意的是，恢复操作将覆盖现有的数据集记录，请谨慎操作。
注意：
  • 数据源处于维护中、连接失败或源目录不存在时，检查更新无法正常完成；请先恢复连通性并退出维护模式。
  • 选择“实际数据源为主”处理字段别名冲突可能覆盖元信息管理中的人工修改，该操作应在确认备份后执行。

管理已接入数据集

  • 查看数据集信息：支持查看数据集名称、格式、要素数量、几何类型、分类、标签、接入时间等信息；
  • 移除数据：可将不需要的数据从接入列表中移除。

管理不扫描数据集

  • 查看数据集信息：支持查看数据集名称、格式、要素数量、几何类型、忽略时间等信息；
  • 移除数据：如该数据集需要扫描并接入，可将数据集从不扫描列表中移除。

分类管理

分类管理模块用于统一维护元数据分类，采用左侧分类树、右侧分类详情的布局，支持查看和维护多级分类。

  • 支持新增同级分类、添加子级分类、修改分类名称和删除未被使用的分类；
  • 分类最多支持三级，例如“行政区划 / 四川 / 成都”；
  • 分类名称限制不超过 15 个字，一级分类数量最多可创建 30 个。

向量管理

向量管理页面用于查看元信息向量化处理情况。

查看向量统计

页面顶部以统计卡片形式展示当前向量化概况，主要包括以下指标：

  • 数据集总数；
  • 已完成向量化的数据集数量；
  • 待处理任务数量；
  • 向量存储占用空间。

查看向量配置

向量配置区域用于查看当前服务使用的向量化参数，包括嵌入模型、向量维度和自动向量化状态。

注意：

如未配置嵌入模型，则无法进行元信息向量化、使用语义检索功能。嵌入模型配置入口：

  • Docker安装包：.env配置文件
  • Kubernetes安装包：values.yaml配置文件

常见问题解答

  1. 在元信息管理中，GPA空间分析生成的结果数据，如何修改默认存储的数据库？

    答：GPA空间分析的结果数据默认存储在 agentx_gpa_result 数据库中。如果您需要更改存储位置，可以通过修改 AgentX Server 的环境变量配置来实现，具体操作如下：

    1）进入AgentX Server的安装目录，Docker安装包找到 .env 配置文件（Kubernetes安装包找到values.yaml配置文件）。

    2）在文件中定位到 GPA_RESULT_DATASOURCE 配置项。

    3）修改该项中的连接参数，指向您目标数据库的地址、名称和账号信息。

    4）保存文件后，重启AgentX服务，配置即可生效。

    配置项说明如下：

    # ENV for GPA MCP Server
    ...
    GPA_RESULT_DATASOURCE='--server=agentx-postgres:5432 --database=agentx_gpa_result --user=agentx --password=agentx_2025 --Schema=sdx --dbType=PGGIS --providerType=sdx'
    ...

    • --server：数据库服务地址和端口。请填写目标数据库的IP（或域名）和端口号。
    • --database：目标数据库名称。请修改为您希望实际存储结果数据的库名。
    • --user：数据库登录用户名。确保该用户对上述数据库有读写权限。
    • --password：数据库登录密码。填写对应用户的密码。
    • --Schema：指定 SuperMap 系统表（以 sm 开头的表）所在的数据库 Schema 名称。默认建议使用 sdx，但也可根据实际部署情况设置为其他 Schema（如 public），前提是该 Schema 下已包含完整的 SuperMap 系统表。请勿填写为业务表名或非系统表所在的 Schema。
    • --dbType：数据库类型标识，通常保持默认即可。
    • -providerType：数据提供者类型，通常保持默认即可。