agent-profiles/suite-user/TOOLS.md

TOOLS.md — 套件使用工具

市场前端

https://suites.mercator.cn

浏览套件、查看详情、提交执行任务。

CLI（可选）

# 安装
pip install agentgis-cli

# 配置 API Key
agc config set api-key mk_xxxxxxxxx

# 执行套件（在市场找到 suite-id 后）
agc run <suite-id> --inputs '{"input_path": "/data/myfile.shp"}'

# 查看套件列表
agc suites list

# 查看套件列表
agc suites list

# 查看执行状态
agc status <task-id>

gis-actions（本地执行器部署）

gis-actions 是套件的本地执行引擎，跑在你的机器上。

前提条件

• Python 3.10+（验证：python3 --version）
• Docker（验证：docker ps）
  • Linux：apt install docker.io 或 yum install docker
  • Windows/Mac：安装 Docker Desktop
• 能访问 registry.mercator.cn（拉取 gis-base 镜像）

安装

# 下载 gis-actions 包
# 或从源码安装
pip install gis-actions

配置

创建 config.json：

{
  "worker": {
    "id": "my-machine-001",
    "capabilities": ["gis-operations"]
  },
  "scheduler": {
    "url": "https://suites.mercator.cn",
    "poll_interval": 5,
    "heartbeat_interval": 30
  },
  "auth": {
    "api_key": "你的 API Key"
  }
}

API Key 从 https://auth.mercator.cn 获取。

启动

python3 -m gis_actions --config config.json

启动后自动连接调度中心，注册自身，开始等待任务。 保持终端开着，或使用进程管理工具（systemd / supervisor）后台运行。

验证是否运行成功

# 查看日志输出，应看到：
# Worker xxx started, polling https://suites.mercator.cn every 5s
# Worker registered successfully

停止

Ctrl+C 停止。脚本包自动清理，不留痕迹。

数据流向

你本地的 SHP/GeoJSON/TIFF 文件
    │
    ▼
gis-actions（你的机器）
    │  ← 从调度中心拉取任务
    │  ← 下载套件脚本包
    │  ← docker run gis-base + 套件脚本
    │  → 结果写入 /tmp/output/
    ▼
结果文件（你的机器）

支持的输入类型

类型	说明	示例
file	本地文件路径	/data/land_use.shp
string	文本	"缓冲区距离: 500"
number	数值	500.0
integer	整数	100
boolean	布尔值	true