name, description, version
| name |
description |
version |
| tjwater-action-analytics-simulation-analysis-burst-detection |
analytics/simulation-analysis 下 burst-detection 操作技能。 |
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) |
- |
接口说明
| 接口 |
说明 |
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 |
