# 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" **返回格式**: