From 46b5b15d791c7b5c8a852ba60dd734ae3de20cf3 Mon Sep 17 00:00:00 2001 From: Huawei Date: Thu, 9 Jul 2026 07:43:50 +0000 Subject: [PATCH] =?UTF-8?q?fix:=20=E6=B8=85=E9=99=A4=20suite-developer=20?= =?UTF-8?q?=E6=96=87=E4=BB=B6=E4=B8=AD=E7=9A=84=E5=B9=B3=E5=8F=B0=E5=86=85?= =?UTF-8?q?=E9=83=A8=E5=BC=95=E7=94=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- suite-developer/TOOLS.md | 44 +++++++++++++--------------------------- 1 file changed, 14 insertions(+), 30 deletions(-) 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` 仓库中。