diff --git a/suite-developer/TOOLS.md b/suite-developer/TOOLS.md index 2b4fe63..5802754 100644 --- a/suite-developer/TOOLS.md +++ b/suite-developer/TOOLS.md @@ -1,34 +1,23 @@ # TOOLS.md — 套件开发工具与资源 -## 安装 CLI +## CLI ```bash pip install agentgis-cli -``` -(当前可从 Git 仓库安装,未来上 PyPI 后一行命令即可) +# 配置 +agc config set api-key mk_xxxxxxxxxxx -## 配置 - -```bash -agc config set api-key mk_xxxxxxxxxxxxx -``` - -API Key 从 [auth.mercator.cn](https://auth.mercator.cn) 获取。 - -## 日常命令 - -```bash # 初始化新套件 agc init ./my-analysis -# 发布套件(自动处理打包→上传→注册) +# 发布到市场 agc publish ./my-analysis # 测试执行 agc run --inputs '{"expression": "1+1"}' -# 查看市场上已有的技能和套件 +# 查看市场上已有的技能/套件 agc skills list agc suites list ``` @@ -39,34 +28,29 @@ agc suites list |------|------| | 注册 Skill | `POST https://suites.mercator.cn/api/v1/skills` | | 注册 Suite | `POST https://suites.mercator.cn/api/v1/suites` | -| 提交执行 | `POST https://suites.mercator.cn/api/v1/task` | +| 执行任务 | `POST https://suites.mercator.cn/api/v1/task` | | API 文档 | `https://suites.mercator.cn/docs` | ## 套件结构 ``` my-suite/ -├── workflow.yaml # 步骤定义(核心) +├── workflow.yaml # 步骤定义(必填) └── scripts/ - └── run.py # 执行入口 + └── run.py # 执行入口脚本 ``` ## 基础镜像 -所有套件在 `registry.mercator.cn/agentgis/gis-base:latest` 中执行。 -包含:Python 3, GDAL, Shapely, GeoPandas, numpy +所有套件在 gis-base 镜像中执行,包含:Python 3, GDAL, Shapely, GeoPandas ## 参考示例 -- `SuiteHub/hello-world-suite` — 最小模板(查看代码了解 workflow.yaml 写法) -- `SuiteHub/math-add` — 算术相加示例 -- `SuiteHub/buffer-analysis` — GIS 缓冲区分析 +查看 `SuiteHub` 组织下的公开仓库: +- `hello-world-suite` — 最小模板 +- `math-add` — 算术相加 +- `buffer-analysis` — 缓冲区分析 ## 文档 -所有文档在 AgentGIS/docs 仓库的 `03-workflow/` 目录: -- `workflow-spec.md` — workflow.yaml 完整规范 -- `script-dev-guide.md` — 脚本开发指南 -- `skill-dev-guide.md` — 技能开发指南 -- `suite-dev-guide.md` — 套件开发指南 -- `suite-publishing-guide.md` — 发布指南 +公开文档在 `SuiteHub/agent-profiles` 仓库中。