fix: 快速入门改为 Agent API 调用方式
This commit is contained in:
+41
-18
@@ -1,33 +1,56 @@
|
|||||||
# 快速入门
|
# 快速入门
|
||||||
|
|
||||||
## 第一步:打开套件市场
|
## 第一步:获取 API Key
|
||||||
|
|
||||||
访问 [https://suites.mercator.cn](https://suites.mercator.cn)。
|
访问 https://auth.mercator.cn,创建 API Key(`mk_` 开头)。
|
||||||
|
|
||||||
市场首页展示平台简介。点击顶部导航栏的「套件」进入套件列表。
|
API Key 是 Agent 与平台交互的唯一凭证。
|
||||||
|
|
||||||
## 第二步:浏览套件
|
## 第二步:浏览套件
|
||||||
|
|
||||||
在套件列表页,你可以:
|
```bash
|
||||||
|
# 列出所有套件
|
||||||
|
curl -s https://suites.mercator.cn/api/v1/suites
|
||||||
|
|
||||||
- **搜索**:按关键词搜索套件名称和描述
|
# 搜索套件
|
||||||
- **浏览**:滚动查看所有已发布的套件
|
curl -s "https://suites.mercator.cn/api/v1/suites/search?q=缓冲区"
|
||||||
- **查看详情**:点击套件名称查看参数说明、输入输出
|
|
||||||
|
|
||||||
## 第三步:登录
|
# 查看套件详情
|
||||||
|
curl -s https://suites.mercator.cn/api/v1/suites/{suite_id}
|
||||||
|
```
|
||||||
|
|
||||||
点击右上角「登录」按钮,跳转到认证中心登录。
|
## 第三步:选择套件
|
||||||
支持账号密码登录或企业微信扫码登录。
|
|
||||||
|
|
||||||
## 第四步:执行套件
|
从列表中筛选符合需求的套件,记录它的 `suite_id` 和参数说明。
|
||||||
|
|
||||||
1. 进入套件详情页
|
## 第四步:提交执行
|
||||||
2. 填写参数(输入文件路径、数值等)
|
|
||||||
3. 点击执行
|
```bash
|
||||||
4. 等待执行完成
|
curl -s -X POST https://suites.mercator.cn/api/v1/suites/{suite_id}/execute \
|
||||||
5. 查看结果
|
-H "Authorization: Bearer ***" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"buffer_distance": 0.5}'
|
||||||
|
```
|
||||||
|
|
||||||
|
返回结果中包含 `task_id`,用这个 ID 查询执行状态。
|
||||||
|
|
||||||
|
## 第五步:查询状态
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -s https://suites.mercator.cn/api/v1/task/{task_id}/status
|
||||||
|
```
|
||||||
|
|
||||||
|
状态:`pending` → `running` → `completed` / `failed`
|
||||||
|
|
||||||
|
## 第六步:获取结果
|
||||||
|
|
||||||
|
任务完成后,从返回结果中读取输出数据。
|
||||||
|
|
||||||
## 前置条件
|
## 前置条件
|
||||||
|
|
||||||
- 需要 **API Key** 或账号密码登录
|
- **API Key**(必须)
|
||||||
- 执行任务需要在本地安装 **GIS Actions**(见本地部署文档)
|
- **GIS Actions** 在本地运行(用于实际执行任务)
|
||||||
|
|
||||||
|
## 数据安全
|
||||||
|
|
||||||
|
**数据永不离开本地。** 你的文件始终在你的机器上处理。
|
||||||
|
|||||||
Reference in New Issue
Block a user