# 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"

  **返回格式**: