44 lines
2.2 KiB
Markdown
44 lines
2.2 KiB
Markdown
---
|
||
name: tjwater-action-analytics-simulation-analysis-burst-detection
|
||
description: analytics/simulation-analysis 下 burst-detection 操作技能。
|
||
version: 3.0.0
|
||
---
|
||
|
||
# burst-detection Action Skill
|
||
|
||
## 简介
|
||
负责 `analytics/simulation-analysis` 场景下 `burst-detection` 的具体接口调用。
|
||
|
||
## 子模块索引 (渐进式引导)
|
||
- 当前为叶子节点，直接使用下方接口目录。
|
||
|
||
## 接口目录
|
||
| Method | Path | Summary | Required Params | Optional Params |
|
||
|---|---|---|---|---|
|
||
| POST | `/api/v1/burst-detection/detect/` | 执行爆管检测 | data (body) | - |
|
||
| GET | `/api/v1/burst-detection/schemes/` | 查询爆管检测方案列表 | network (query) | query_date (query) |
|
||
| GET | `/api/v1/burst-detection/schemes/{scheme_name}` | 获取爆管检测方案详情 | network (query), scheme_name (path) | - |
|
||
|
||
- 覆盖方法：`GET, POST`
|
||
|
||
## 接口说明
|
||
|
||
| 接口 | 说明 |
|
||
|---|---|
|
||
| `POST /detect/` | 基于压力观测数据执行爆管检测分析。使用异常检测算法（隔离森林 IsolationForest）识别压力时间序列中的异常，判定为潜在爆管事件。请求体支持列式字典、逐时刻对象数组、二维数组三种格式的压力数据，可指定数据来源（monitoring 监测 / simulation 模拟）。 |
|
||
| `GET /schemes/` | 获取指定管网的所有爆管检测方案列表，可通过 query_date 按日期筛选。 |
|
||
| `GET /schemes/{scheme_name}` | 获取指定名称的爆管检测方案详细配置信息，包含传感器节点、算法参数等。 |
|
||
|
||
## 请求体关键字段（POST /detect/）
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|---|---|---|
|
||
| `network` | str | 管网名称（数据库名） |
|
||
| `observed_pressure_data` | dict/list/null | 压力观测数据，支持列式字典 `{sensor_id: [values]}` 或逐行数组 |
|
||
| `points_per_day` | int | 每天数据点数，默认1440 |
|
||
| `mu` | int | 异常值检测参数，默认100 |
|
||
| `iforest_params` | dict/null | 隔离森林算法参数，可选 |
|
||
| `scada_start` / `scada_end` | datetime/null | 从SCADA数据库查询的时间范围 |
|
||
| `sensor_nodes` | list/null | 指定传感器节点，null为全部 |
|
||
| `data_source` | str | 数据来源：`monitoring`（监测）或 `simulation`（模拟），默认monitoring |
|