安装SuperMap iPortal AI助理

SuperMap iPortal AI助理支持使用Docker Compose工具实现快速部署。Docker Compose是用于定义和运行多容器 Docker 应用的工具。通过 YAML文件描述应用的各个服务及其依赖，实现一键启动、停止和管理容器化应用的完整环境。

准备镜像包

在使用Docker Compose工具部署前，需要先完成镜像的准备，支持离线和在线两种方式安装镜像：

离线安装

前往网盘获取镜像包，分别提供了X86和ARM版本的镜像包，您可以按需下载。下面以X86版本的镜像包为例，解压supermap-iportal-ai-assistant-2025-linux-x64-images.tar.gz镜像包，所需镜像包括：

  • agentx-auto-agent服务镜像包
  • iportal-ai-assistant助理服务镜像包
  • iportal-ai-assistant-server服务镜像包

使用如下命令安装镜像包：

docker load -i iportal-ai-assistant-12.0.0.0-amd64.tar

docker load -i iportal-ai-assistant-server-12.0.0.0-amd64.tar

docker load -i agentx-auto-agent-12.0.0.0-amd64.tar

在线安装

1. 在线安装，需先登录阿里云，密码为 supermap@123。

docker login --username=478386058@qq.com 
registry.cn-chengdu.aliyuncs.com

2. 在线安装相关镜像

docker pull registry.cn-chengdu.aliyuncs.com/supermap/agentx-auto-agent:12.0.0.0-amd64

docker pull registry.cn-chengdu.aliyuncs.com/supermap/iportal-ai-assistant:12.0.0.0-amd64

docker pull registry.cn-chengdu.aliyuncs.com/supermap/iportal-ai-assistant-server:12.0.0.0-amd64

修改配置文件

前往网盘的docker-compose文件夹中获取配置文件包，根据实际情况修改配置文件：

文件名称 文件说明
.env 环境变量配置文件
application-app.yml aiassistant-server配置文件
docker-compose.yaml docker-compose配置文件
graphrag/.env GraphRag环境变量配置文件

.env文件配置说明

# Common settings 

...

## 宿主机CPU架构

ARCH=amd64

## 许可服务

BSLICENSE_SERVER=ws://172.16.168.199:9183 

...

## iPortal服务

IPORTAL_SERVER=http://172.16.168.198:8190 IPORTAL_URL=http://172.16.168.198:8190/iportal 

# openai格式大语言模型配置

DEFAULT_LLM_MODEL=Qwen/Qwen3-14B

LLM_SERVER=http://127.0.0.1:8000/v1

LLM_KEY=EMPTY

LLM_MODEL=Qwen/Qwen3-14B

# openai格式词嵌入模型配置

DEFAULT_EMBED_MODEL=bge-m3

EMBED_SERVER=http://127.0.0.1:8001/v1

EMBED_KEY=EMPTY

EMBED_MODEL=bge-m3

您需要根据实际情况，修改.env文件中加粗部分的内容，对应的配置项说明如下：

  • ARCH：宿主机CPU架构，X86-64/X64/AMD64使用amd64，arm64使用arm64

  • BSLICENSE_SERVER：安装Web许可后，所获得的许可中心地址

  • IPORTAL_SERVER：iPortal服务的根地址，http://[IP地址]:8190

  • IPORTAL_URL：iPortal服务的访问地址，http://[IP地址]:8190/iportal
  • DEFAULT_LLM_MODEL: 默认大语言模型的名称，当意图识别未传模型名称时，默认使用的模型
  • LLM_SERVER:大语言模型的服务地址，http://[IP地址]:8000/v1
  • LLM_KEY:大语言模型的访问密钥，可以为空
  • LLM_MODEL：大语言模型的名称
  • DEFAULT_EMBED_MODEL: 默认词嵌入模型的名称，当意图识别未传模型名称时，默认使用的模型
  • EMBED_SERVER:词嵌入模型的服务地址，http://[IP地址]:8001/v1
  • EMBED_KEY:词嵌入模型的访问密钥，可以为空
  • EMBED_MODEL：词嵌入模型的名称

application-app.yml文件配置说明

ai

 ...

 iPortal:    

    api:      

      addr: http://172.16.168.198:8190/iportal 

...

spring

   ai:

    openai:
      chat:
        enabled: true
        base-url: http://127.0.0.1:8000

        ...

        options:
           model: Qwen/Qwen3-14B
...

您需要根据实际情况，修改application-app.yml文件中加粗部分的内容，对应的配置项说明如下：

  • ai-iportal-api-addr：iPortal服务的访问地址

  • spring-ai-openai-chat-enabled：是否启用大语言模型服务，默认为true

  • spring-ai-openai-chat-base-url: 大语言模型服务的地址

  • spring-ai-openai-chat-options-model:大语言模型服务的名称

graphrag/.env文件配置说明

...

### OpenAI alike example
LLM_BINDING=openai
LLM_MODEL=Qwen/Qwen3-14B
LLM_BINDING_HOST=http://127.0.0.1:8000/v1
LLM_BINDING_API_KEY=EMPTY


### Embedding Configuration 
EMBEDDING_MODEL=bge-m3
EMBEDDING_DIM=1024
EMBEDDING_BINDING_API_KEY=EMPTY

### OpenAI alike example
EMBEDDING_BINDING=openai
EMBEDDING_BINDING_HOST=http://127.0.0.1:8001/v1

...

您需要根据实际情况，修改.env文件中加粗部分的内容，对应的配置项说明如下：

  • LLM_MODEL：大语言模型的名称

  • LLM_BINDING_HOST：大语言模型的服务地址

  • LLM_BINDING_API_KEY：大语言模型服务的密钥

  • EMBEDDING_BINDING_HOST：词嵌入模型服务的地址
  • EMBEDDING_BINDING_API_KEY：词嵌入模型服务的密钥

启动SuperMap iPortal AI助理服务

在完成文件配置后，在docker-compose.yaml文件的路径下执行以下命令即可快速启动SuperMap iPortal AI助理服务：

docker compose up -d

  • SuperMap iPortal AI助理接口UI页面

http://[IP地址]:8080/swagger-ui/index.html。

图：SuperMap iPortal AI助理接口UI页面
  • SuperMap iPortal AI助理首页

http://[IP地址]/iportal/apps/AIAssistant/index.html

使用SuperMap iPortal账号登录后，即可使用SuperMap iPortal AI助理。

图：SuperMap iPortal AI助理首页

卸载SuperMap iPortal AI助理服务

如果您要卸载通过Docker Compose方式部署的iPortal AI助理，只需前往docker-compose.yaml文件所在路径，依次执行以下命令即可完成卸载：

docker compose stop
docker compose rm

图：SuperMap iPortal AI助理卸载完成

遥感工具补充说明

在SuperMap iPortal AI助理中使用遥感能力，除了上述步骤流程外，还需完成以下配置：

配置Python运行环境

从官网技术资源中心的“组件 GIS”列表下下载Python运行环境包（supermap-iobjectspy-env-cpu.zip），解压出来是一个conda文件夹，将文件夹放置于【SuperMap iServer 产品目录】/support/python下。

配置机器学习资源包

从官网技术资源中心的“组件 GIS”列表下下载机器学习资源包（supermap-iobjectspy-resources-ml.zip），解压出来是一个resources-ml文件夹，放置于【SuperMap iServer 产品目录】/support/python下。该资源包提供有示例数据及示例模型可供参考。

说明：
  • 使用二元分类、地物分类、目标检测、场景分类、对象提取等深度学习功能时，需进行上述环境配置。
  • 机器学习服务暂不支持 Web 许可，请您参照相关步骤配置普通许可或云许可。

配置遥感资源包

网盘中下载遥感相关资源包（Remote Sensing Capability Extension Package），将资源包中的iportal-gpa-extension-1.0.0-SNAPSHOT.jar文件放置到{iServer_home}\support\geoprocessing\lib路径下；将模型文件（model文件夹）解压后放置到{iServer_home}\webapps\iserver路径下。

注意：

相关商用模型的授权许可独立于产品外，需要单独授权，以下为涉及到的模型名称和其对应的授权ID。

模型名称 ID
土地覆盖预训练大模型/LIM_LULC 33001
建筑物提取预训练模型/PIM_BUILDING 33101
建筑物变化检测预训练模型 33109
道路提取预训练模型 33107