高效使用建议
本文面向实际使用场景，总结更适合 GIS Agent 的提示词结构、数据源选择和问题排查方法。 本文提供 GIS Agent 高效使用的核心策略，旨在帮助用户掌握结构化提示词撰写与数据源择优原则，以实现精准、高效的 GIS 工作流自动化。一、精准指令：提示词的三种高效模式
与 GIS Agent 协作，核心在于通过结构化指令降低歧义。我们推荐以下三种清晰、务实的提示词使用模式。1.1 需求描述模板：数据源 + 操作 + 输出
这是最基础也是最核心的模式。清晰的指令应遵循 “数据源描述 → 具体操作 → 输出格式” 的黄金结构。 标准公式：使用 [数据源] 进行 [操作]，输出为 [格式]，并可追加 [后续动作]。
示例：
使用新一代时空数据库中的OSM 数据，裁剪出武汉市行政区范围，发布为矢量瓦片服务并保存结果。价值解读： 此结构确保任务从数据调用到成果产出的完整链路一次成型，避免 Agent 自行猜测或执行多余步骤。
1.2 迭代修正模式：描述现象 → 获得反馈 → 明确指令
当输出结果不尽如人意时，与其重新组织复杂指令，不如采用“现象描述”模式，让 Agent 自行诊断并给出修正方案。 应用流程：- 现象描述：直接告诉 Agent “地图上的标注字体太小，看不清楚”。
- 接受建议：Agent 通常会分析原因（如默认样式问题）并提出修改建议（如调整标注图层样式）。
- 执行修正：根据建议，下达明确的样式修改指令。
1.3 过程存档模式：关键节点触发结果固化
对于耗时较长的复杂分析流程，可在关键步骤后使用存档指令，将中间成果或完整操作链固化，便于追溯与复用。 典型指令：“将当前地图服务发布的所有参数和结果存档。” “导出本次空间分析的全过程日志。”核心价值：这不仅是一次性任务的记录，更是可复用、可审计的知识资产沉淀。
二、数据择优：优先使用新一代时空数据库
核心建议：在执行任何空间数据处理任务前，明确指定并优先选用新一代时空数据库作为数据源。这是保障处理效率、结果一致性与服务性能的首要原则。2.1 为何必须优先指定？
- 性能与架构优势：新一代时空数据库为海量时空数据进行了深度优化，其内置的时空索引与计算引擎，相比传统文件或旧版数据库，在执行空间查询、裁剪、分析等操作时，性能有数量级提升。
- 避免默认歧义：不指定数据源时，Agent 可能调用测试数据、过时数据或默认路径下的文件，导致处理结果不一致，甚至任务失败。明确指定是从源头控制流程质量。
- 服务发布优化：直接基于新一代数据库发布的地图服务（尤其是矢量瓦片），在服务生成速度、前端渲染效率和动态查询能力上均有显著优势。
2.2 如何正确使用？
1. 在提示词中首位声明： 在“需求描述模板”中，将数据源部分放在最前。
正确示例：“使用新一代时空数据库中的OSM POI数据，统计北京市各区餐饮网点密度，并生成专题图。”
2. 结合空间范围控制：
处理全球或全国数据时，应优先进行空间裁剪，仅发布业务所需范围，这是提升性能的关键实践。
优化指令：“使用新一代时空数据库的全球地形数据，裁剪出青藏高原区域，并生成地形晕渲图发布为栅格瓦片服务。”
3. 利用其高级特性：
新一代数据库支持实时数据接入、版本管理、时空回溯等高级功能。在涉及动态数据或历史对比的分析中，直接利用这些特性可简化流程。
进阶示例：“基于新一代时空数据库的传感器实时数据流，创建过去24小时内PM2.5浓度的热力图动画服务。”
遵循此原则，你将从数据源端获得最佳的性能起点与结果保障。
三、结果优化与异常排查
3.1 页面异常快速修复流程
当遇到地图加载失败、分析报错等问题时，遵循以下四步法可高效解决：- 现象直述：直接向 Agent 描述问题，如“行政区划图层无法点击查询”。
- 提供错误信息：打开浏览器开发者工具（F12），将 Console 面板中的红色报错信息完整复制给 Agent。
- 尝试模型切换：不同 AI 模型（如 Qwen、Kimi）在代码生成与问题诊断上各有侧重，切换模型后重试可能直接解决问题。
- 回退至稳定版本：若当前项目版本更新后出现异常，最快捷的方式是直接回退到上一个工作正常的版本。
3.2 地图服务发布优化
- 底图服务：测试阶段可使用内置密钥快速接入天地图等公有服务。正式项目务必申请专属密钥，以防公共密钥限流影响服务稳定性。
- 地形服务：发布原始 DEM 栅格数据视觉效果平淡。最佳实践是预先生成地形晕渲图（山体阴影），再将其发布为栅格瓦片，能极大增强地形的立体感和视觉层次。
- 瓦片选型：
- 矢量瓦片：适用于需要高度交互、动态样式修改、属性查询的场景。
- 栅格瓦片（晕渲图）：适合作为静态、高性能的背景底图。
- 组合使用：采用“栅格底图（地形/影像）+ 矢量业务图层”的模式，兼顾视觉效果与交互灵活性。
四、过程管理与进阶支持
4.1 上下文与对话管理
- 对话轮数：平台设有单次对话轮数上限（通常为100轮），达到后提示“继续”即可延长。对于超长任务，合理使用“过程存档”分段进行。
- 自动上下文压缩：当对话上下文接近满载时，平台会自动压缩，保留核心参数与命令历史，不影响后续操作，无需手动干预。
4.2 精准问题反馈技巧
- 截图圈选：对于界面显示、布局等问题，截图后使用工具的圈选修改功能，选中问题元素并描述，可实现像素级精准定位。
- 寻求官方支持：若经上述步骤问题仍存，可通过 主菜单 → 帮助 → 问题反馈 提交工单。请附上详细的操作步骤、错误日志及问题截图，以便技术团队快速定位。