高频问题与解答
本文整理了 GIS Agent 在产品认知、数据使用、成果管理、模型用量和技术排查方面的常见问题。产品认知与定位
Q1: GIS Agent 是什么?它与通用 AI 工具的核心区别在哪里?
A: GIS Agent 并非通用聊天机器人,可以理解为一个面向空间任务的 GIS 工作助手。- 核心区别: 通用 AI(如 ChatGPT)擅长处理文本、代码等通用信息,但通常不处理地理空间概念与操作。GIS Agent 结合专业 GIS 能力,可用于执行“缓冲区分析”“流域提取”“三维地质建模”等任务。
- 本质差异: 通用 AI 更偏向问答式信息处理;GIS Agent 更偏向围绕空间任务生成地图、页面和分析成果。
Q2: GIS Agent 旨在解决哪些核心痛点?
A: 主要包括以下三点:- 降低使用门槛: 传统 GIS 软件操作复杂,学习成本高。GIS Agent 支持自然语言描述需求,用户无需掌握底层库、数据库或后端开发技术。
- 提升响应效率: 传统空间分析需求从提出到交付常需数天至数周。GIS Agent 可帮助将部分流程压缩到分钟级或小时级。
- 沉淀数字资产: 项目经验易随人员流动而流失。GIS Agent 可将成功交付成果沉淀为可复用的行业 Skill,实现经验的数字化与规模化复用。
Q3: 产品名称是“GIS Agent”还是“GIS GeoAgent”?
A: 内部全称为 GIS GeoAgent,对外发布及日常沟通中,统一使用 GIS Agent 这一简洁称谓,两者指向同一产品。使用方式与数据
Q4: 如何开始使用 GIS Agent?第一次上手应该做什么?
A: 可以先按以下三步开始:- 打开 快速开始。
- 先用一句自然语言描述你的目标。
- 查看生成结果,并继续补充修改要求。
说清数据、说清操作、说清输出。例如:
使用武汉市行政区划和 POI 数据,统计餐饮网点密度,输出专题图并发布为 Web 页面。
Q5: 如何描述需求,才能让 GIS Agent 更容易理解?
A: 建议使用一个固定结构:使用 [数据源],完成 [操作],输出为 [结果]。你可以在这个结构上继续补充:
- 空间范围:例如“武汉市洪山区”。
- 分析目标:例如“统计密度”“缓冲区分析”“三维建模”。
- 输出形式:例如“Web 页面”“专题图”“报告”“可分享链接”。
Q6: 使用 GIS Agent 是否需要自行准备 API Key 或大模型?
A: 不需要。 GIS Agent 目前支持在线使用。用户登录后即可直接使用,系统会自动调度内置能力,无需自行申请和管理 API Key 或额外模型资源。Q7: GIS Agent 在处理中国地理数据方面有何优势?支持哪些坐标系?
A: 主要特点在于本地化适配、坐标支持和数据处理能力。- 坐标系支持: 内置 GIS 时空数据库内核,支持 CGCS2000、北京 54、西安 80 等国内常用坐标系。
- 默认坐标系: 常规 Web 地图与在线成果默认使用 WGS84(EPSG:4326)。
- 坐标转换: 支持根据任务要求转换到其他坐标系,用于叠加分析、服务发布或成果导出。
- 数据理解: 支持中文地理命名规范与行政区划体系相关数据处理。
- 安全合规: 支持满足国内数据处理场景下的安全与合规要求。
Q8: GIS Agent 中的数据从哪里来?
A: GIS Agent 本身不预存空间数据。其数据来源于:- 用户上传: 支持上传 Shapefile、GeoJSON、CSV 等格式的本地数据。
- 指定数据库: 可连接并调用用户指定的时空数据库中的数据(例如 OSM 数据)。
- 在线服务: 支持接入合规的在线地图服务(WMS/WFS)作为数据源。
Q9: 能否对现有数据进行范围裁剪或合并操作?
A: 可以。这是处理大规模数据(如全量 OSM)以提升性能的常见操作。- 操作逻辑: 通过时空数据库对数据按行政区划或其他范围进行裁剪或合并,再将结果发布为矢量瓦片服务(Vector Tile),可提升前端加载速度与业务贴合度。
- 提示词参考: “针对数据库中的 OSM 数据,按‘北京市’行政区划进行裁剪,并发布为矢量瓦片服务。”
Q10: 数据更新频率是怎样的?
A: 数据更新频率取决于所使用的数据源,不同类型差异较大。- 实时数据: 如航班、地震等,通常为秒级或分钟级更新。
- 气象数据: 如雷达、台风等,通常为分钟级或小时级更新。
- 基础地理数据: 多为按需获取或按数据源发布节奏更新。
成果输出与管理
Q11: 使用 GIS Agent 生成的分析成果(地图、报告、文件)保存在哪里?
A: 保存位置取决于使用模式:- 在线使用模式: 所有成果保存在用户的个人项目空间,可通过“我的作品”或“项目列表”进行查看、管理、分享与再编辑。
- 工作空间模式: 若在任务工作空间中运行,生成的文件通常保存在当前工作空间目录
/workspace/sessions/[session-id]/下。
Q12: 生成的报告或地图支持导出哪些格式?可以导出图片吗?
A: 支持,常见导出格式如下:- HTML:可在浏览器中打开并进行交互浏览。
- PNG、JPG:便于分享与汇报。
- GeoJSON、SHP:便于在其他 GIS 软件中继续使用。
- MBTiles:便于离线分发与服务化使用。
- WMS/WFS:可作为在线地图服务发布。
- PDF、Word、Markdown:适合导出分析报告、记录和说明文档。
Q13: 如何离线查看生成结果?
A: 如果成果是导出的 HTML 文件,通常可以直接在浏览器中打开进行离线查看。- 适合离线查看的内容: 页面结构、图层组织、交互框架和本地静态成果。
- 需要注意: 若地图依赖在线底图、在线瓦片或远程接口,离线状态下底图和部分动态数据可能无法正常加载。
Q14: 可以自定义地图样式吗?
A: 可以。建议在需求中明确说明样式要求,GIS Agent 会按描述调整制图表达。 可描述的内容包括:- 颜色方案
- 图标样式
- 标注内容与显示方式
- 图层顺序
- 主题风格,如科技风、简洁风、深色风等
Q15: 如何处理地方独立坐标系或坐标不匹配的数据?
A: GIS Agent 支持坐标处理与数据融合。- 常见做法: 先说明原始数据使用的坐标系,再让 GIS Agent 进行转换、校正或叠加分析。
- 指令示例: “将我上传的‘地块.shp’(北京 54 坐标系)转换到 WGS84 坐标系,并与‘POI数据.csv’进行叠加分析。”
- 补充建议: 如果转换后位置仍不对,可继续补充原始坐标系、来源或参考底图信息。
Q16: GIS Agent 是否支持天地图地理编码与位置纠偏?
A: 支持。GIS Agent 可基于天地图进行地理编码、位置比对和坐标纠偏,适合处理地名定位、坐标偏移和位置校正类任务。- 地名转坐标: 输入地名或地址,例如“武汉黄鹤楼”,可解析为标准经纬度。
- 坐标比对与纠偏: 可对比原始坐标和标准坐标,判断是否存在偏移。
- 位置校正: 对于模糊、错误或偏移明显的点位,可结合地名给出修正结果。
- GPS 设备采集的坐标与地图底图对不上
- 不同坐标系(GCJ-02 / BD-09 / WGS84)混用导致偏移
- 需要从地名获取经纬度用于地图标注
- 校验第三方数据的位置准确性
技术问题排查指南
说明: 本节整理的是常见技术问题的排查方式,侧重提供具体操作路径。模型额度用完、切换模型见文末「模型与用量」。
Q17: 页面预览报错或功能异常
A: 请按以下优先级尝试修复:- 先让 Agent 排查: 将问题现象直接告知 Agent,让其分析日志并尝试修复。
- 切换模型重试: 不同模型能力存在差异,可尝试切换至 Qwen3.7、Xiaomi MiMo 或 DeepSeek 等模型(以实际列表为准)再次执行任务;具体操作见 Q27。
- 提供详细错误日志: 打开应用日志或浏览器控制台(F12),复制红色 JS Error 报错信息反馈给 AI 以引导精准修复。
- 版本回退: 如果修改导致问题,回退到上一个可用版本通常更省时间。
Q18: 成果已生成但页面不显示
A: 此问题多为前端渲染或数据加载异常。- 操作步骤:
- 按 F12 打开浏览器开发者工具。
- 切换到 控制台 (Console) 标签页。
- 复制其中的报错信息(通常是红色错误日志)。
- 将错误日志反馈给 Agent,例如:“控制台报错‘XXX’,请帮我排查页面为什么不显示。”
- 解析: 此方法有助于定位渲染异常、瓦片加载失败或跨域(CORS)等问题。
Q19: 地图显示空白怎么办?
A: 地图空白通常与网络、数据源或空间范围配置有关,可按以下顺序排查。- 常见原因:
- 网络连接异常,导致底图、瓦片或远程数据未加载成功。
- 数据源 API 暂时不可用或返回异常。
- 坐标范围、中心点或缩放层级设置错误,导致地图没有落在正确区域。
- 解决方法:
- 检查网络连接是否正常。
- 确认坐标范围、中心点和缩放层级是否正确。
- 刷新页面后重新加载地图。
- 尝试更换数据源或底图服务。
Q20: 数据加载缓慢怎么办?
A: 该问题通常与数据量、接口响应速度或当前网络环境有关。- 常见原因:
- 查询范围过大,返回数据量过多。
- 外部 API 响应较慢。
- 当前网络带宽受限或连接不稳定。
- 解决方法:
- 缩小查询范围。
- 减少一次性加载的数据量。
- 优先使用缓存数据或已裁剪结果。
- 等待几分钟后重试。
Q21: 3D 效果无法显示怎么办?
A: 3D 场景依赖浏览器图形能力和本机硬件环境,通常与 WebGL 或硬件加速有关。- 常见原因:
- 浏览器不支持 WebGL 或相关能力未正常启用。
- 显卡驱动版本过旧。
- 浏览器硬件加速未开启。
- 解决方法:
- 更新浏览器到最新版本。
- 更新显卡驱动。
- 开启浏览器硬件加速。
- 尝试更换其他现代浏览器。
Q22: 地图或界面出现中文乱码怎么办?
A: 中文乱码通常与字体缺失或文件编码设置有关。- 常见原因:
- 浏览器或页面运行环境缺少可用中文字体。
- 文件编码不是 UTF-8。
- 解决方法:
- 安装或补充可用中文字体。
- 检查相关文件编码是否为 UTF-8。
- 尝试使用支持中文显示更稳定的现代浏览器。
- 可尝试: 在对话中补充以下提示词,引入公共字体库。
- 解析: 该指令会引导前端代码加载 Open Sans 字体,有时可帮助缓解字体缺失导致的显示问题。
Q23: 任务执行时对话栏转圈或卡住不动
A: 需区分情况处理。- 仅对话栏转圈: 这通常是前端显示延迟,任务本身可能已经完成,可先查看页面或继续操作。
- 项目页面无法加载: 请依次尝试:
- 刷新页面。
- 在对话框输入
/唤起工具栏,点击 重启应用。 - 让 Agent 帮你排查,例如输入:“项目没有成功启动,目前无法预览,请帮我检查并修复。”
Q24: 网站卡死或无响应
A: 通常与对话过长或页面一次性加载内容过多有关。- 可先尝试: 刷新页面,然后重新发起对话。
- 后续建议: 通过缩小分析数据的地理范围或复杂度,降低页面负载,减少卡死概率。
Q25: 发送需求后报 “The input is too long” 或 “Range of input length should be [1, 258048]”
A: 这类报错不是需求本身有问题,而是当前对话的上下文长度超出了模型单次可接收的上限。- 典型现象:
- 报错形如
InternalError.Algo.InvalidParameter: The input is too long: the request payload exceeds the maximum message size accepted by the service. - 或
InternalError.Algo.InvalidParameter: Range of input length should be [1, 258048] - 同一条需求反复重发都失败,例如多次提交“成果编制模块的‘导出全部图件’按钮,改成‘导出选中图件’,各个图件应该可选”均无响应。
- 报错形如
- 原因: 长对话会累积历史消息、文件内容和日志,即使本次输入只有一句话,整体请求体积仍然超限。
- 解决方法:
- 手动压缩上下文:在对话框直接输入
/compact并发送,平台会把历史对话压缩为一段摘要,保留核心参数与命令历史,释放 token 空间。 - 压缩后重新发送原始需求,此时通常能正常执行。
- 若
/compact后仍报同样错误,请新开一个对话,并在首条消息中带上关键上下文(模块名、页面、期望行为),必要时附上相关文件路径或截图。
- 手动压缩上下文:在对话框直接输入
- 使用建议: 修改类任务尽量“一个需求一次小步提交”,长任务分段处理,避免在同一个对话里持续累积大量结果与日志。
模型与用量
Q26: 提示“流量/额度用完”或“请求受限”,是限制使用量了吗?
A: 大概率是。先看报错原文,不同提示对应不同处理:
解释:
- “流量/额度”通常限制的是某个模型或某个套餐,不是 GIS Agent 软件本身;换模型或换套餐可以继续。
- 这不等于数据丢失:当前会话记录、已上传文件、已生成代码都在;切换后回复“继续”即可。
- 如果所有模型都提示额度用完,通常是套餐共用额度或账户余额问题,需要换套餐或联系管理员,单换模型解决不了。
Q27: 额度用完时,怎么切换模型?
A: 在对话输入框右下角找到模型胶囊(显示当前模型名,如Qwen3.6-Plus),点开选择另一个可用模型,再回复“继续”。
- 点击模型胶囊(在模式胶囊
Build/Plan右侧)。 - 在“模型”菜单里选择可用模型,例如
Qwen3.7、Xiaomi MiMo、DeepSeek;以实际列表为准。 - 回复“继续”或重述上一条需求;同一会话切换,上下文通常保留。
- 新对话:在发送前先选模型,避免默认模型额度已用完。


- 模型胶囊和模式胶囊是两个不同的按钮:模型决定用哪个大模型,模式(Plan/Build)决定能不能写文件;不要混淆。
- 切换模型不会自动压缩上下文;如果同时报
input is too long,先/compact(Q25)。 - 如果模型列表里没有可用模型,或切换后仍提示额度用完,说明套餐/账户层面受限,需要换套餐或联系管理员。
- 切换模型后如果任务中断,回复“继续”即可;必要时把上一步的目标和验收标准再贴一遍。
使用提示: 若遇到未涵盖的问题,建议在对话中清晰描述现象,包括数据情况、操作步骤和错误提示,Agent 将为您提供定制化解决方案。