1. 是否可以将 GIS 云套件和 AgentX 部署到同一个Kubernetes环境中，是否会发生容器冲突？
2. 如何将部署在同一个 Kubernetes 环境的云套件和云套件中的 iPortal 配置给 AgentX 进行使用？
4. 为什么配置qwen3-32b大模型后，无法使用MapStudio AI制图助理以及自主规划智能体？
5. 为什么通过iServer GPA MCP工具执行生成缓冲区分析等耗时长的任务会报错，但在SuperMap iServer的GPA服务中查询却显示已执行成功？
8. 如何在_iServer_WebGPA_AI_建模助理中修改已配置的_AgentX服务地址？
- 是否可以将 GIS 云套件和 AgentX 部署到同一个Kubernetes环境中，是否会发生容器冲突？
答：可以将云套件和AgentX部署到同一个Kubernetes环境的不同命名空间中，云套件的部署流程请参考：部署云套件，AgentX的部署流程请参考：Kubernetes环境安装SuperMap AgentX Server，为解决许可中心端口冲突的问题，除帮助文档中介绍的基本配置项外，还需修改 AgentX 的 values.yaml 配置文件中的如下配置：
# 许可服务配置
bslicense:
provider: "External"
server: "ws://bslicense-server.<cloudsuite_namespace>.svc.cluster.local:9183"- bslicense.provider: 许可服务的来源，可选值：Built-in（内置服务）、External（外部服务），此场景下应填写 "External"；
- bslicense.server：许可服务地址，此处应填写“ws://bslicense-server.<cloudsuite_namespace>.svc.cluster.local:9183”，其中<cloudsuite_namespace>需替换为云套件的实际命名空间。
- 如何将部署在同一个 Kubernetes 环境的云套件和云套件中的 iPortal 配置给 AgentX 进行使用？
答：除帮助文档中介绍的基本配置项外，还需要修改 AgentX 的 values.yaml 配置文件中的如下配置，再启动 AgentX：
# GIS 服务配置
iserver:
provider: "External"
rootUrl: "<cloudsuite_root_url>/iserver"
token: "<cloudsuite_token>"
# GIS 门户配置
iportal:
provider: "External"
rootUrl: "<cloudsuite_root_url>/iportal"
token: "<iportal_token>"- iserver.provider：SuperMap iServer服务的来源，可选值：Built-in（内置服务）、External（外部服务）、None（不配置），此场景下应填写 "External"；
- iserver.rootUrl：iServer服务地址，此处应填写云套件iServer的地址 "<cloudsuite_root_url>/iserver" ，其中<cloudsuite_root_url>需替换为云套件的根路径；
- iserver.token：iServer的访问令牌，此处应填写云套件的token，需前往云套件首页>用户名>令牌处申请；
图：云套件令牌申请页面 - iportal.provider：SuperMap iPortal服务的来源，可选值：Built-in（内置服务）、External（外部服务）、None（不配置），此场景下应填写 "External"；
- iportal.rootUrl：iPortal服务地址，此处应填写云套件iPortal的地址 "<cloudsuite_root_url>/iportal" ，其中<cloudsuite_root_url>需替换为云套件的根路径；
- iportal.token：iPortal的访问令牌，由于iPortal与云套件安全模块相互独立，无法使用云套件的令牌。同时，云套件中的 iPortal 使用 Keycloak 进行登录，界面屏蔽了申请令牌功能，只能通过命令行发送请求获取。具体请参考下列步骤：
（1）执行以下命令，进入 iPortal 容器：
kubectl exec -it $(kubectl get pods -l app=iportal -o jsonpath='{.items[0].metadata.name}' -n <cloudsuite_namespace>) -n <cloudsuite_namespace> -- /bin/sh
（2）执行以下命令，生成的字符串即为iPortal的token：
curl --silent --fail --show-error \
--request POST "http://iportal:8090/iportal/services/security/tokens.json" \
--header "Content-Type: application/json;charset=UTF-8" \
-d "{\"userName\":\"$ADMINUSER\",\"password\":\"$PASSWORD\",\"clientType\":\"NONE\",\"expiration\":\"5,256,000\"}"此外，还需要在云套件中进行一些配置，以解锁AgentX中更多功能：
（1）如需使用AgentX的iServer GPA MCP 服务，需要在云套件中开启“处理自动化服务”，如下图所示：
图：云套件处理自动化服务页面 （2）如需使用 AgentX 的 iPortal MCP 服务，需要在云套件的iPortal 中配置 GPA 共享存储，如下图所示：
图：云套件iPortal GPA共享存储配置页面 （3）如需使用iPortal MapStudio AI制图功能，需要在云套件的iPortal中配置 AI 制图地址，服务地址填写为：
<agentx_root_url>/agentx/workflow/api/mapping/v1
图：云套件iPortal中地图工作室AI制图地址配置页面 - 知识问答式智能体中的知识库在进行文档解析时报错 “Value error, batch size is invalid, it should not be larger than 10...”，可能的原因是什么导致的，应该如何解决？
答：是因为所使用的词嵌入（Embeddiing）模型单次允许输入的最大数据条数小于系统配置的单次允许输入的最大数据条数，系统默认值为16，而部分模型（如text-embedding-V4）所允许的单次输入最大值仅为10。该问题可以通过修改配置文件解决：Docker环境下，修改.env配置文件中的
EMBEDDING BATCH SIZE参数，将默认值修改为当前使用的词嵌入模型单次允许输入的最大数据条数；Kubernetes环境下，修改values.yaml配置文件中的chatflow.embeddingBatchSize参数，根据模型实际情况进行设置。 - 为什么配置qwen3-32b大模型后，无法使用MapStudio AI制图助理以及自主规划智能体？
答：因为qwen3模型默认关闭“流式输出”功能、开启“思考模式”，但上述两个AI模块依赖流式输出模式，且需开启思考。所以推荐按以下内容进行配置，即开启流式输出及思考模式：
llm:
BASIC_MODEL:
base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
model: "qwen3-32b"
api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
streaming: True
extra_body:
enable_thinking: True - 为什么通过iServer GPA MCP工具执行生成缓冲区分析等耗时长的任务会报错，但在SuperMap iServer的GPA服务中查询却显示已执行成功？
答：此问题通常并非GPA服务本身执行失败，而是由于工具内置的超时机制所导致。
- MCP Inspector超时限制：MCP Inspector在等待GPA任务返回结果时，设有固定的超时时间。当分析任务执行时间超过此限制时，Inspector会主动中断等待并报错，但此时iServer上的GPA任务仍在继续或已完成。
- iServer GPA MCP 工具执行时限：当前的iServer GPA MCP设计支持的单次工具最长执行时间为30秒。对于超过此时限的“长耗时”GPA任务，MCP服务端会提前终止会话并返回超时错误，但此时iServer上的GPA任务也仍在继续或已完成。
当前的iServer GPA MCP工具适用于轻量级、快速的空间分析。对于处理大数据量或可能长时间运行的任务，建议直接调用iServer的GPA接口，以获得稳定可靠的结果。
- 配置豆包大模型doubao-1-5-pro-32k-character-250715后，为何Map Studio AI制图助理与WebGPA AI建模助理均无法正常调用，出现制图指令未生效、知识库查询未触发等情况？
答：因为所选模型doubao-1-5-pro-32k-character-250715不支持 Function Calling（工具调用）功能。当通过 MapStudio AI制图助理或 WebGPA AI建模助理发起相关操作时，模型无法正确识别并调用对应的工具（如设置颜色、查询知识库等），导致指令未实际执行。建议更换其他支持工具调用的模型。
- 已在iServer WebGPA AI 建模助理界面或 support\geoprocessing\conf\gpa-settings.xml 配置文件中配置好了 AgentX服务地址并可正常使用，为何在使用过程中界面仍再次显示需注册地址？
答：该问题通常由 AgentX服务地址不可正常访问导致的，请恢复该服务或将其更换为有效的服务地址（可直接在建模助理界面中重新填写地址），随后刷新建模助理界面即可。
- 如何在 iServer WebGPA AI 建模助理中修改已配置的 AgentX服务地址？
答：若当前 AgentX服务可正常访问，请先关闭该服务，然后刷新建模助理界面，在显示的注册页面中填写新地址并注册即可。