工具及应用场景整理

src/agent/README.agent.md

+# Agent 场景
+
+## 地区设备在线率
+**描述**：查询指定地区设备在线率数据，并进行数据分析和总结
+
+**使用工具**：`RegionRateTool`
+
+**示例问题**：
+- 查询甘肃省2024年1月1日至2024年1月31日的设备在线率数据
+- 查询甘肃省2024年1月的设备在线率数据
+
+## 设备在线率省份排名
+**描述**：查询设备在线率省份排名数据，并进行数据分析和总结
+
+**使用工具**：`RankingRateTool`
+
+
+**提取参数**：
+- `rate_type`：排序类型，用于指定查询的排名类别。1表示省份排名，2表示厂商排名。省份排名识别为1
+
+**示例问题**：
+- 查询设备在线率省份排名数据
+
+## 设备在线率厂商排名
+**描述**：查询设备在线率厂商排名数据，并进行数据分析和总结
+
+**使用工具**：`RankingRateTool`
+
+
+**提取参数**：
+- `rate_type`：排序类型，用于指定查询的排名类别。1表示省份排名，2表示厂商排名。厂商排名识别为2
+
+**示例问题**：
+- 查询各厂商设备排名
+
+## 地区年度在线率月度数据
+**描述**：查询指定地区年度在线率月度统计数据，并进行数据分析和总结
+
+**使用工具**：`RegionRateTool`
+
+**示例问题**：
+- 查询甘肃省2024年各月的设备在线率
+
+## 监测点查询
+**描述**：查询指定地区监测点信息
+
+**使用工具**：`MonitorPointTool`
+
+**示例问题**：
+- 查询甘肃省的监测点信息
+
+
+## 按地区查询监测点信息
+**描述**：查询指定地区监测点信息
+
+**使用工具**：`MonitorPointTool`
+
+**示例问题**：
+- 查询甘肃省的监测点信息
+
+## 按地区灾害类型（滑坡，崩塌，泥石流等）查询监测点信息
+**描述**：查询指定地区指定灾害类型的监测点信息
+
+**使用工具**：`MonitorPointTool`
+
+**示例问题**：
+- 查询甘肃省滑坡的监测点信息
+
+## 按地区威胁人口范围灾害类型（滑坡，崩塌，泥石流等）查询监测点信息
+**描述**：查询指定地区指定威胁人口范围指定灾害类型的监测点信息
+
+**使用工具**：`MonitorPointTool`
+
+**示例问题**：
+- 查询甘肃省威胁人口超过30人以上的滑坡的监测点信息
+
+## 按地区三维模型或者正射影像查询监测点信息
+**描述**：查询指定地区指定三维模型或者正射影像的监测点信息
+
+**使用工具**：`MonitorPointTool`
+
+**示例问题**：
+- 查询甘肃省有三维模型的监测点信息
+
+## 地区设备（设备，滑坡仪，雨量计，裂缝计，gnss基站等传感器类型）数量查询
+**描述**：查询指定地区指定设备的数量
+
+**使用工具**：`MonitorPointTool`
+
+**示例问题**：
+- 查询甘肃省的传感器数量
+
+## 地区处置率数量和占比查询
+**描述**：查询指定地区的处置率数量和占比情况
+
+**使用工具**：`MonitorPointTool`
+
+**示例问题**：
+- 查询2024年4月到5月甘肃省的处置率是多少
+
+## 地区处虚警率数量和占比查询
+**描述**：查询指定地区的虚警率数量和占比情况
+
+**使用工具**：`MonitorPointTool`
+
+**示例问题**：
+- 查询2024年4月到5月甘肃省的虚警率是多少
+
+## 地区预警等级的数量和占比查询
+**描述**：查询指定地区的预警等级数量和占比情况
+
+**使用工具**：`MonitorPointTool`
+
+**示例问题**：
+- 查询2024年4月到5月甘肃省的蓝黄橙红预警分别是多少

src/agent/README.tools.md

+# Agent工具
+
+### 1. RegionRateTool (地区在线率查询工具)
+
+**用途**：查询全国或特定地区设备在线率
+
+**工具名**：`region_online_rate`
+
+**参数**：
+
+- `region_name`: 地区名称（空字符串表示查询全国）
+- `start_time`: 开始时间 (YYYY-MM-DD)
+- `end_time`: 结束时间 (YYYY-MM-DD)
+- `month_required`: 是否按月度查询（默认 False）
+- `device_items`: 监测项集合，多个逗号隔开，支持：滑坡仪、设备、传感器、雨量、地表位移、裂缝、倾角、加速度、土壤含水率、泥水位，默认为空
+- `manufacturer_name`: 设备厂商，默认为空
+
+**查询模式**：
+
+- 普通查询：返回指定时间段的在线率数据
+
+  **调用接口**：`query_rates_sync`："/cigem/getAvgOnlineRate"
+
+  **返回格式**：
+
+- 月度统计查询：当 `month_required=True` 时，返回按月统计的在线率数据
+
+  **调用接口**：
+  
+  **返回格式**：
+
+### 2. RankingRateTool (在线率排名查询工具)
+
+**用途**：查询设备在线率的排名数据
+
+**工具名**：`online_rate_ranking`
+
+**参数**：
+
+- `rate_type`: 排名类型
+   - `1`: 省份排名
+   - `2`: 厂商排名
+
+**子类型**：
+
+1. 省份排名（`_get_province_ranking`）
+
+   返回各省份的在线率排名
+   **调用接口**：`get_ranking_data`："/cigem/getOnlineRateRank"
+
+
+2. 厂商排名（`_get_manufacturer_ranking`）
+
+   返回各厂商的在线率排名
+   **调用接口**：`get_ranking_data`："/cigem/getOnlineRateRank"
+
+**返回格式**：
+
+```typescript
+{
+    'region': region_name,
+    'region_code': code,
+    'rate_data': df.resultdata,
+    'markdown': markdown,
+    'date_range': {
+    'start': start_time,
+    'end': end_time
+    }
+}
+```
+
+### 3. MonitorPointTool (监测点查询工具)
+
+**用途**：查询指定行政区划的监测点信息
+
+**工具名**：`monitor_points_query`
+
+**参数**：
+
+- `key`: 行政区划名称（省/市级别均可,只需要最后一级，空字符串表示查询全国）
+- `start_time`: 开始时间 (YYYY-MM-DD)
+- `end_time`: 结束时间 (YYYY-MM-DD)
+- `disaster_type`: 灾害类型（滑坡、泥石流、地震等）
+- `three_d_model`: 是否需要三维模型
+- `ortho_image`: 是否需要正射影像
+- `disaster_threat_people_range_start`: 灾害威胁人数范围起始值
+- `disaster_threat_people_range_end`: 灾害威胁人数范围结束值
+- `disaster_scale`: 灾害规模（巨型、特大型、大型、中型、小型）
+- `device_required`: 是否需要设备相关信息
+- `device_type`: 设备类型（加速度、位移、温度、湿度、裂缝计等）
+
+
+**调用接口**：`query_points_sync`："/cigem/getMonitorPointAll"
+
+**返回数据格式**：
+
+```typescript
+{
+code: number, // 状态码（200成功，400失败）
+message: string, // 响应消息
+points?: [ // 监测点列表（查询成功时存在）
+{
+"名称": string,
+"位置": string,
+"经度": string,
+"纬度": string,
+"海拔": string,
+"建设单位": string,
+"监测单位": string,
+"监测类型": string
+}
+],
+markdown?: string // markdown格式的表格数据
+}
+```
+
+**错误处理**：
+
+- 区域代码未找到
+- 数据查询权限问题
+- 数据为空
+- API 调用异常
+
+### 4. WarningTool (预警查询工具)
+
+**用途**：查询不同时间段不同地区预警处置和虚警情况，包括处置率、虚警率、蓝黄橙红数数量和占比统计。也支持按月度统计一年内的虚警率，处置率。
+
+**工具名**：`warning_statistics`
+
+**参数**：
+- `start_time`: 开始时间 (YYYY-MM-DD)
+- `end_time`: 结束时间 (YYYY-MM-DD)
+- `region_name`: 地区名称，如果要查询全国数据，请输入空字符串
+- `month_statistics`: 是否按月度查询一年内的统计结果,默认不需要
+
+**查询模式**：
+
+- 普通查询：返回指定时间段的预警处置和虚警情况
+
+  **调用接口**：`query_warning_statistics`："/cigem/getWarningStatistics"
+
+  **返回格式**：
+
+- 月度统计查询：当 `month_statistics=True` 时，返回按月度统计的预警处置和虚警情况
+
+  **调用接口**：`query_warning_month_statistics`："/cigem/getWarningStatistics"
+
+  **返回格式**：