亚马逊AWS官方博客
地理空间 AI 智能体(Code Agent)中国区部署实践
摘要:在农业遥感监测、自然资源调查、城市规划、碳汇核算、保险定损等领域,企业客户日益需要对卫星影像进行快速分析。传统工作流要求 GIS 专业人员编写 Python 代码处理遥感数据,门槛高、周期长、成本大。亚马逊云科技开源项目 sample-geospatial-code-agent(https://github.com/aws-samples/sample-geospatial-code-agent)提供了一套 AI 智能体方案,让非技术用户也能通过自然语言完成专业级遥感分析。该方案采用 Code Agent 架构——LLM 直接生成 Python 脚本执行,中间数据留在内存不回传上下文,相比传统 Tool Agent 在遥感分析场景中速度更快、成本更低。但原项目基于海外区服务生态构建,其底图方案(Google/CARTO 瓦片)和部分托管服务无法在中国区直接运行,需要针对中国区进行适配。
一、背景介绍
在农业遥感监测、自然资源调查、城市规划、碳汇核算、保险定损等领域,企业客户日益需要对卫星影像进行快速分析。传统工作流要求 GIS 专业人员编写 Python 代码处理遥感数据,门槛高、周期长、成本大。亚马逊云科技开源项目 sample-geospatial-code-agent(https://github.com/aws-samples/sample-geospatial-code-agent)提供了一套 AI 智能体方案,让非技术用户也能通过自然语言完成专业级遥感分析。
该方案采用 Code Agent 架构——LLM 直接生成 Python 脚本执行,中间数据留在内存不回传上下文,相比传统 Tool Agent 在遥感分析场景中速度更快、成本更低。
但原项目基于海外区服务生态构建,其底图方案(Google/CARTO 瓦片)和部分托管服务无法在中国区直接运行,需要针对中国区进行适配。
二、解决方案
采用 Amazon ECS + ALB + CloudFront 架构,底图适配天地图(CGCS2000 ≈ WGS-84,无偏移)。适配工作:
- 容器化部署:ECS Fargate + ALB + CloudFront
- 底图适配:天地图 WMTS(CGCS2000 坐标系)
- 地理编码:天地图 API
- LLM 推理:Amazon Bedrock Minimax M2.5
- 凭证管理:敏感凭证统一环境变量注入(ECS 由 Secrets Manager)
底图方案:为什么选择天地图
- 高德/腾讯:GCJ-02,偏移 100-700 米
- 百度:BD-09,二次偏移
- 天地图:CGCS2000 ≈ WGS-84,直接叠加无偏移
三、具体方案实现
3.1 前置条件
3.2 主要代码改造点
Step 1:代码入口(webmain.py 替代 AgentCore)
新增 FastAPI Web 服务入口,实现与 AgentCore 兼容的 API。核心代码:
关键改造点
- load_config():config.json 只存非敏感配置,敏感凭证始终从环境变量读取
- /login:简易用户名密码认证,返回 HMAC 签名 Token(7 天有效期)
- /invocations:SSE 流式推送,Agent 每产生消息即推送前端
- /download/{filename}:Agent 将分析结果拷贝到本地目录,前端通过 HTTP 下载
Step 2:天地图底图配置
修改 MapView.tsx,替换底图为天地图 WMTS:
Step 3:天地图地理编码
修改 satellite_data.py 中的 geocode():
Step 4:配置文件(config.json)
config.json 只存非敏感配置,敏感凭证通过环境变量注入:
3.3 ECS 服务配置
Step 5:构建容器镜像
在中国区 EC2 上构建 Docker 镜像时,默认访问 Debian 官方源和 PyPI 速度极慢(GDAL 安装可能需要 30 分钟以上)。需要替换为国内镜像源:
关键优化点
- 基础镜像:使用 public.ecr.aws 替代 Docker Hub(中国区无法直接访问 registry-1.docker.io)
- apt 镜像源:mirrors.aliyun.com 替代 deb.debian.org,GDAL 安装从 30 分钟降至 1-2 分钟
- pip 镜像源:阿里云 PyPI 镜像,Python 依赖安装提速 5-10 倍
- 多阶段构建:前端(Node.js)和后端(Python)分离构建,最终镜像不含 Node.js 运行时
- uvicorn keep-alive 300s:匹配 ALB idle timeout,避免 SSE 长连接被中途断开
Step 6:创建 Secrets Manager 密钥
敏感凭证存入 Secrets Manager:
Step 7:配置 ecsTaskExecutionRole 权限
ECS Task 启动时需从 Secrets Manager 拉取凭证,必须给 Execution Role 添加权限:
附加到角色:
说明:无此权限 Task 启动报 ResourceInitializationError。Task Role 不需要 SM 权限(凭证已注入为环境变量)。
Step 8:Task Definition
完整 Task Definition JSON(保存为 task-definition.json,通过 aws ecs register-task-definition –cli-input-json file://task-definition.json 注册):
3.4 Agent 代码关键改造
1. System Prompt 增强
原项目 System Prompt 仅两行描述,在使用 Minimax M2.5 等模型时,Agent 无法正确区分 visualize_map_raster_layer(叠加地图)和 visualize_image(仅聊天显示)。增加明确的工具使用规则,确保分析结果正确叠加到地图上。
2. 添加文件系统 Toolkit
strands-code-agent 的 CodeAgent 有严格的 import 白名单,默认不允许 import os、pathlib 等模块。需要显式添加 FILESYSTEM_TOOLKIT,包含 os、pathlib、tempfile、shutil、json、glob 等模块。
3. 大面积自动降采样
原项目对数据下载分辨率无限制,Sentinel-2 默认 10m 分辨率。用户选择大范围多边形时(如 100km×100km),数据量可达数百 MB,导致超时或 OOM。增加自动降采样逻辑,限制最大像素数为 400 万:
3.5 中国区网络时延专项处理
中国区部署面临跨境网络和国内审查两大挑战,需要在多个层面做超时和网络适配:
1. ALB Idle Timeout 调整
默认 60 秒的 idle timeout 对遥感分析场景不够——Agent 执行代码期间可能有 60-180 秒无 SSE 数据发送,ALB 会主动断连。必须调高至 300 秒。
2. 跨境 Bedrock 调用
容器运行在中国区(cn-northwest-1),调用海外 Bedrock(us-east-1)经过公网,延迟 200ms-2s,偶发超时。应对措施:
- uvicorn –timeout-keep-alive 300:保持长连接不被服务端主动关闭
- ECS Task 安全组出站:必须开放 TCP 443(Bedrock endpoint IP 不固定)
- SSE 流式响应:即使中间有等待也能保持 HTTP 连接不被断开
3. 卫星数据跨境下载优化
Element84 STAC API 和 Sentinel-2 COG 数据存储在 us-west-2 S3,从中国区下载速度约 1-5 MB/s。应对措施:
- 自动降采样:限制单次下载数据量不超过约 50MB
- 前端初始 zoom 调高至 8:引导用户选择合理大小的分析区域
- fitBounds 自适应缩放:多边形选中后根据实际大小决定缩放级别,避免用户误画超大范围
4.天地图瓦片多节点负载均衡
天地图 WMTS 服务使用 HTTP 协议,配置 t0-t7 八个节点负载均衡,降低单节点压力。注意 API Key 需设置为“浏览器端”类型,白名单填写 ALB 域名或设为“不限制”。
四、效果展示
[图 1:植被分析 — 输入] |
[图 2:植被分析 — 报告] |
[图 3:植被分析 — 饼图] |
[图 4:水体分析 — 输入] |
[图 5:水体分析 — 报告] |
[图 6:地表温度分析 — 输入] |
[图 7:地表温度分析 — 报告] |
五、总结
本文介绍了将开源项目 sample-geospatial-code-agent 部署到亚马逊云科技中国区的完整实践。核心技术选型:
- 底图方案:天地图 WMTS(CGCS2000 ≈ WGS-84,无偏移),确保遥感影像精确叠加
- 部署架构:ECS Fargate + ALB,容器化交付、弹性伸缩
- 凭证管理:Secrets Manager 注入环境变量,敏感信息不入镜像
- LLM 推理:跨境调用海外区 Bedrock,配合 ALB 300s 超时和 SSE 流式响应保障长连接稳定性
- 中国区网络优化:国内镜像源加速构建、自动降采样控制数据量、多节点负载均衡
通过以上适配,非技术用户可以在中国区通过自然语言完成专业级遥感分析,实现与海外区一致的使用体验。
➡️ 下一步行动:
相关产品:
- Amazon ECS — 完全托管的容器编排服务
- Amazon Bedrock — 用于构建生成式人工智能应用程序和代理的端到端平台
- Amazon Secrets Manager — 密钥管理
- Amazon S3 — 适用于 AI、分析和存档的几乎无限的安全对象存储
- Amazon Fargate — 适用于容器的无服务器计算
相关文章:
- 5 分钟拉起、90 秒自愈、成本 1/8——基于 Firecracker microVM 与 Bedrock AgentCore 的生产级多租户 AI Agent 平台 OpenClaw Pool
- 用 Kiro Skill 打造你的专属 AI 工作流:以会议纪要自动生成为例
- 让 Kiro 和 Claude Code 响应 IM 消息:用 ACP Bridge 打造异步 AI 编程工作流
- 使用Amazon SageMaker Hyperpod Cluster部署whisper模型
- OpenClaw 安全和功能增强实践
六、参考文档
*前述特定亚马逊云科技生成式人工智能相关的服务目前在亚马逊云科技海外区域可用。亚马逊云科技中国区域相关云服务由西云数据和光环新网运营,具体信息以中国区域官网为准。








