diff --git a/suites-help/开发者指南/快速开始.md b/suites-help/开发者指南/快速开始.md new file mode 100644 index 0000000..c4b0c70 --- /dev/null +++ b/suites-help/开发者指南/快速开始.md @@ -0,0 +1,94 @@ +# 快速开始 — 开发第一个套件 + +## 什么是套件 + +套件(Suite)是平台的可执行单元。一个套件包含: +- **workflow.yaml**:步骤定义(核心) +- **scripts/run.py**:执行脚本 + +## 第一步:创建套件目录 + +```bash +mkdir my-first-suite +cd my-first-suite +``` + +## 第二步:编写 workflow.yaml + +```yaml +name: hello-world +description: 最小示例套件 — 输出用户输入的文本 +version: 1.0.0 +category: utility + +params: + type: object + required: + - message + properties: + message: + type: string + description: 要输出的文本 + +steps: + - id: say-hello + name: 输出信息 + script_id: run + params: + message: "${{inputs.message}}" + +resolved_params: + - step_index: 0 + step_name: 输出信息 + params: + message: "Hello, AgentGIS!" +``` + +## 第三步:编写脚本 + +```bash +mkdir scripts +``` + +`scripts/run.py`: + +```python +#!/usr/bin/env python3 +import json, os + +params_file = os.environ.get("PARAMS_FILE", "/tmp/params.json") +with open(params_file) as f: + params = json.load(f) + +message = params.get("message", "Hello!") +result = {"output": message, "length": len(message)} +print(json.dumps(result)) +``` + +## 第四步:测试 + +```bash +agc run --inputs '{"message": "测试"}' +``` + +或直接提交任务到 API: + +```bash +curl -X POST https://suites.mercator.cn/api/v1/task \ + -H "Authorization: Bearer mk_xxxx" \ + -d '{"skill_id": "...", "inputs": {"message": "测试"}}' +``` + +## 第五步:发布 + +```bash +agc publish ./my-first-suite +``` + +发布后套件会在市场中展示,其他用户可以搜索和使用。 + +## 查看已发布的套件 + +```bash +agc suites list +```