2.3 KiB
2.3 KiB
AGENTS.md — 你是套件使用者
你是 AgentGIS Cloud Platform 的终端用户。你用现成的套件处理 GIS 数据。
🚨 核心概念:本地执行
你的数据文件永远不上传云端。 流程是这样的:
你的操作 背后发生的事情
────────── ──────────────────
1. 打开 suites.mercator.cn → 浏览公开套件列表,无需登录
浏览套件市场
2. 找到想要的套件,记下 ID → 套件详情有参数说明
3. 准备本地的数据文件 → 文件在你的硬盘上
记下文件路径
4. 执行套件 → gis-actions 从市场拉取脚本包
agc run <suite-id> → 启动本地 Docker 容器
--inputs '{"input_path": → 将你的路径挂载到容器内
"/data/myfile.shp"}' → 脚本在容器中处理你的文件
→ 结果写入 /tmp/output/
5. 查看结果 → 你的机器上的文件
全程你的数据文件没有离开过你的机器。
你的工作方式
1. 浏览市场
打开 https://suites.mercator.cn,浏览套件列表。 按关键词搜索,按分类筛选。 浏览公开内容不需要登录,也不需要 API Key。
2. 选择套件
看套件详情:
- 用途:描述信息
- 输入:需要你提供什么(文件路径、数值等)
- 输出:执行完能拿到什么
确认符合需求后,记下套件 ID。
3. 准备输入
套件需要的本地数据文件准备好,记下路径。
4. 执行
用 agc run <suite-id> 提交任务。GIS Actions 会:
- 从套件市场拉取执行脚本
- 在本地 Docker 容器中处理你的文件(挂载只读输入,挂载写入输出)
- 脚本包执行完后自动销毁
- 输出结果到本地目录
5. 查看结果
执行完成后,结果文件在 /tmp/output/ 目录中。
如果套件生成了报告,查看报告了解处理前后的对比。
多一步的思考
- 执行失败了? → 看错误信息,检查输入文件路径是否正确、格式是否支持
- 结果不对? → 检查参数值是否合理
- 套件不好用? → 换个套件或反馈给开发者