analyze_data
ChatGPTK-water 물정보 수자원 데이터 분석 — 추이(trend), 기간 비교(compare, 예: 작년 대비), 상관(correlation), 통계(statistics), 댐-하류 영향(dam_downstream), 호우 시 수문 연쇄(event_chain). 이럴 때 사용: "작년 대비 어때", "추이가 어떻게 변했나", "월별 평균", "방류가 하류에 얼마나 영향 주나", "비 온 뒤 저수율·방류가 어떻게 움직였나". 사용하지 말 것: 단순 현재 수치 조회(hdaps_get_timeseries·get_kdm_data). 미래 예측은 어떤 유형으로도 하지 않는다. (EN) Analyze water data: trend, period comparison, correlation, statistics, dam-downstream impact.
get_basin_water_status
ChatGPTK-water 물정보 유역(대권역) 물 보유량 브리핑 — 총저수량·가중 저수율과 작년·최근 10년 평균 대비 증감을 1회 호출로 계산. 이럴 때 사용: "한강수계 물 사정", "낙동강 저수 상황 작년보다 어때", "전국 유역별 물 보유량" 등 유역·수계·전국 단위 질문. 댐을 하나씩 조회해 더하지 말 것. 사용하지 말 것: 특정 댐 1곳(hdaps_get_timeseries) · 댐별 저수율 순위(list_dam_storage). 가중 저수율 = Σ저수량÷Σ총저수용량 (댐별 저수율의 단순평균이 아님). 다목적·생공전용댐만 집계하고 홍수조절 전용댐은 평시 저수율 0~수%가 정상이라 제외한다. 응답의 산식·커버리지 필드를 반드시 함께 안내할 것 — 집계에서 빠진 댐이 있다. (EN) Basin-level water storage briefing with year-ago and 10-year-normal comparison.
get_connected_stations
ChatGPTK-water 물정보 연결 관측소 조회 — 댐과 연결된 상류·하류 수위관측소를 한 번에 반환 (상류+하류 통합). 이럴 때 사용: 댐 주변 하천 관측망 전체를 한눈에 볼 때. (EN) Upstream and downstream stations connected to a dam, in one call.
get_downstream_stations
ChatGPTK-water 물정보 하류 관측소 조회 — 댐 방류의 영향을 받는 하류 수위관측소 목록. 물흐름 네트워크 기준, 거리·도달시간 포함. 이럴 때 사용: "○○댐 방류하면 어디 수위가 오르나", 하류 영향 범위 확인. 응답에 좌표·거리(dist_km)·방류량별 도달시간 범위가 담기고 흐름 모식도 위젯이 첨부된다. 부분명(예: "소양")은 부분일치 댐으로 해석되며 응답의 dam_name이 실제 해석 결과다. (EN) Downstream stations affected by a dam's discharge.
get_kdm_data
ChatGPTK-water 물정보 수질·기상·댐 장기 이력 조회 — 수질(BOD·COD·pH·DO·TOC), 기상(기온·습도·풍속), 수년~수십년 이력. 이럴 때 사용: "○○댐 수질 어때", "서울 기온", 댐의 장기 이력·연도별 비교. 사용하지 말 것: 댐·수위·우량의 실시간 수치(hdaps_get_timeseries가 더 빠르고 정확하다). ⚠ 응답의 모든 시각·날짜는 이미 KST — 시간대 변환 금지. site_name만 주면 시설을 자동 검색해 기본 항목을 반환한다. days로 기간, time_key로 단위(h_1·d_1·mt_1)를 조정. "작년·지난 10년 이맘때와 비교"는 include:["comparison"] 1회로 답한다(same_day_by_year) — 해마다 나눠 조회하지 말 것. 분석·모델링용 파일 요청에는 기간을 지정해 조회한 뒤 응답 note의 export URL(CSV·Parquet)을 그대로 안내할 것 — 일별은 수십년도 수초 내 반환. (EN) Water quality, weather, and long-term dam history from KDM; English facility/item names accepted.
get_tap_water_route
ChatGPTK-water 물정보 우리 동네 수돗물 공급 경로 — 행정동의 취수장 → 정수장 → 배수지(최대 3계통), 공급 정수장 수질(탁도·잔류염소·pH), 수도요금·유수율(전국 대비), 근처 다목적댐을 1회 호출로 반환. 이럴 때 사용: "우리 동네 수돗물 어디서 와?", "○○동 정수장·배수지", "○○동 수돗물 수질" 등 동네 단위 수돗물 질문. 사용하지 말 것: 하천·호소 수질(get_kdm_data·get_water_quality_trend) · 현재 단수 여부(이 자료에 없다). 행정동·법정동 이름으로 찾는다 — 시군구를 함께 주면 정확하다(예: "대전 대덕구 회덕동"). 여러 곳이 걸리면 고르지 않고 후보를 준다(ambiguous) — 사용자에게 시군구를 물을 것. ⚠ 수질은 판정하지 말고 측정 시점(실시간/월간 법정검사)을 함께 전할 것 — water_quality.notes의 ⚠ 경고(오래된 값·갱신 멈춤)는 수치보다 먼저 전한다. 근처 댐은 원수 댐이 아니다. 계통은 가뭄기초조사 기준(연 1회)이다. (EN) Tap-water supply route (intake → treatment plant → service reservoir) and plant water quality for a Korean administrative dong.
get_upstream_stations
ChatGPTK-water 물정보 상류 관측소 조회 — 댐 유입에 영향을 주는 상류 수위관측소 + 댐 유역의 우량관측소 목록 (K-water 공식 소관 관측망 기준). 이럴 때 사용: 상류 관측망 파악, 유입 영향 분석. "○○댐 유역에 비 얼마나 왔나"는 이 도구로 우량관측소를 찾은 뒤 hdaps_get_timeseries(facility_type=rainfall)로 조회할 것. 부분명(예: "소양")은 부분일치 댐으로 해석되며 응답의 dam_name이 실제 해석 결과다. (EN) Upstream water-level and basin rainfall stations for a dam.
get_water_quality_trend
ChatGPTK-water 물정보 수질측정소 장기 추이 해석 — 연간 중앙값·계절성·5년 단위 비교를 1회 호출로 계산. 이럴 때 사용: "○○ 수질 좋아졌나", "최근 10년 수질 추이", "여름에 수질이 나빠지나" 등 여러 해에 걸친 변화·계절성 질문. 사용하지 말 것: 최신 수질값 1건(get_kdm_data facility_type=water_quality) · 댐 수위·저수율. 연간 대표값은 중앙값이다(강우·조류 스파이크가 연 대표값을 끌어당기지 않게 평균을 쓰지 않음). 진행 중인 연도는 계절 편향 때문에 5년 비교에서 제외된다. ⚠ 응답의 산식·한계를 반드시 함께 안내할 것 — TOC 관측 개시 시점은 지점마다 다르고, 국내 하천/호소 생활환경기준은 먹는물·WHO 가이드라인과 다른 체계다. (EN) Long-term water quality trend: annual medians, seasonality, 5-year comparison.
hdaps_get_timeseries
ChatGPTK-water 물정보 실시간 시계열 조회 — 댐·수위관측소·우량관측소의 저수율·저수위·유입량·방류량·수위·유량·강우량. 10분~1일 단위 실측. 이럴 때 사용: "○○댐 저수율", "○○ 수위 지금 어때", "최근 24시간 유입량 추이" 등 특정 시설의 현재값·기간 추이. 사용하지 말 것: 예보·전망(이 서버는 실측만 제공) · 여러 댐 저수율 비교(list_dam_storage를 1회 호출) · 수질(get_kdm_data). ⚠ 응답의 모든 시각은 이미 한국표준시(KST) — UTC로 간주하거나 시간대 변환 금지. 기간: 미지정 시 최근 3시간(10분 단위). 단 저수율·저수량 등 완만 항목만 물으면 최근 7일(1시간)로 자동 확장. "지금 저수율?"처럼 현재값 1건만 필요하면 detail="latest"를 함께 보낼 것 — 자동 확장을 건너뛰어 응답이 작고 빠르다(제보 #17: 단순 최신값 요청에 181건이 오던 문제). 지역명도 그대로 넣을 수 있다 — name="울산"·"전북"·"울산 남구"처럼 시·도나 시·군·구를 주면 그 지역 관측소를 시·군·구가 고루 들어가게 골라 지점별 값으로 답한다(지역 평균은 관측소 밀도에 좌우되어 단일 수치로 주지 않는다). "울산 비 왔어?" 같은 질문에 시설명을 되묻지 말고 이렇게 조회할 것. "최근 N시간"에는 recent_hours=N을 쓸 것. 특정 구간은 start_date/end_date(YYYYMMDD) — 사용자에게 "직접 조회해달라"고 되묻지 말고 그 파라미터로 재호출할 것. 7일 초과 구간은 서버가 KDM 일단위로 자동 전환한다. ⚠ interval은 힌트일 뿐 실제 간격은 날짜 범위로 결정된다(1일 이하 10분, 1~7일 1시간). 다만 "일별"·"날짜별" 요청에는 interval="1d"를 지정하면 K-water 공식 일자료를 반환한다 — 원천의 하루는 01:00~24:00이다. 공식 일자료가 없는 날·항목만 원자료를 집계하며, 그 사실은 daily_source(official/aggregated/mixed)와 aggregated_days로 알린다. ⚠ "왜 이 시각까지만 있나요?" 류 질문에는 추측(반영 지연 등)하지 말고 이 도구를 즉시 재호출해 as_of를 다시 확인할 것. 항목명은 list_measurements로 확인. 미지정 시 시설 유형별 기본 항목이 반환된다. 분석·모델링용 파일 요청에는 기간을 지정해 조회한 뒤 응답 note의 export URL(CSV·Parquet)을 그대로 안내할 것. (EN) Near-real-time timeseries for Korean dams and gauging stations; English facility/item names accepted.
list_dam_storage
ChatGPTK-water 물정보 댐 저수율 일괄 조회 — 여러 댐의 최신 저수율을 1회 호출로. 전국 또는 지정 목록. 이럴 때 사용: "전국 댐 저수율", "저수율 낮은/높은 댐", "○○댐과 △△댐 비교" 등 댐이 2곳 이상인 질문. 이때 hdaps_get_timeseries를 댐마다 반복 호출하지 말고 반드시 이 도구를 1회 호출할 것. 사용하지 말 것: 특정 댐 1곳의 추이·상세(hdaps_get_timeseries). 요약은 두 값을 함께 준다: 단순평균 저수율(댐별 산술평균 — 댐 크기 미반영)과 물량가중 저수율(Σ저수량÷Σ총저수용량, get_basin_water_status와 같은 산식). 한쪽을 "평균 저수율"로 뭉뚱그리지 말 것. 모든 시각은 KST(~10분 딜레이). 범위: K-water 관할 댐(농업용 저수지·발전 조정지 제외). (EN) Latest storage rate for multiple dams in one call.
list_dams
ChatGPTK-water 물정보 전국 댐·보 순위·목록·제원(정적 정보) — 저수용량·높이·길이·유역면적·준공년도. 이럴 때 사용: "가장 큰 댐", "댐 순위", "○○댐 몇 위", "○○댐 제원", "세종보 제원", "금강 보 목록"(basin="금강"). 사용하지 말 것: 실시간 저수율(list_dam_storage 또는 hdaps_get_timeseries). 이 도구는 제원만 제공한다. 범위: K-water 관할 주요 댐(다목적·용수·홍수조절)과 보 22곳 — 발전전용댐(한수원)·농업용 저수지 미포함이므로 답변에 이 범위를 함께 안내할 것. 각 행의 kind로 댐(dam)과 보(weir)를 구분한다. 보는 하천 횡단 구조물이라 저수용량 순위(rankings)에서는 제외되고 목록·제원 조회에만 나온다. 부분명(예: "소양")은 부분일치하는 첫 댐으로 해석되며, 응답의 dam.site_name·match_type이 실제 해석 결과다. (EN) Dam rankings, specs and lists; English dam/basin names accepted.
list_measurements
ChatGPTK-water 물정보 측정항목 조회 — 특정 시설이 제공하는 측정 항목과 단위 목록. 예: 댐이면 저수율·저수위·유입량·방류량. 이럴 때 사용: "○○댐은 뭘 볼 수 있나", 항목명이 확실하지 않아 조회 전에 확인할 때. (EN) List available measurement items and units for a facility.
search_catalog
ChatGPTK-water 물정보 시설 검색 — 댐·보·수위관측소·우량관측소·수질측정소·기상관측소(전국 4,795곳). 이럴 때 사용: "○○ 지역에 어떤 관측소가 있나", 정확한 시설명을 모를 때, 시설 목록이 필요할 때. 보(洑) 목록은 query="보"·"금강 보"·"4대강 보" 또는 facility_type="weir"로 조회한다 (세종보·공주보 등 22곳). 유역(대권역) 단위로도 조회한다 — query="한강 유역"·"낙동강 수계"·"금강 권역" (5대권역: 한강·낙동강·금강·섬진강·영산강). 유역 저수 현황(총저수량·저수율)은 get_basin_water_status를 쓴다. 더 좁은 중권역(전국 108개)으로도 조회한다 — query="금호강 중권역"·"섬진강댐 유역"처럼 중권역 이름에 "중권역"/"유역"을 붙이거나 코드를 그대로 준다(4자리=중권역·8자리=표준유역·10자리=집수구역). 이름만 주면(예: "금호강") 같은 이름의 시설이 우선이고 유역은 대안으로 안내한다 — 응답의 catchment_axis.answered_by를 볼 것. 지역명에 유형어를 붙여도 된다 — query="영천시 수질측정망"·"대전 우량관측소"·"경상도 댐"처럼 쓰면 유형어를 떼어 해당 유형으로 조회하고, 무엇을 떼고 어떤 유형으로 봤는지 message로 밝힌다. 0건이면 서버가 대신 한 번 더 찾아 둔다 — 같은 이름의 다른 유형은 found_other_types, 요청한 유형의 가장 가까운 시설은 nearest_of_type(거리 포함)에 있다. 유형을 빼고 재검색하지 말고 이 필드를 볼 것. ⚠ nearest_of_type은 대체값이 아니다 — 다른 지점의 값을 질의한 시설의 값으로 쓰지 말 것(강우는 특히 국지성이 크다). 사용하지 말 것: 실시간 수치 조회(hdaps_get_timeseries 또는 get_kdm_data를 직접 호출). (EN) Search Korean water facilities incl. river weirs; English/romanized names accepted.
submit_feedback
ChatGPTK-water 물정보 서비스 피드백 접수·조회 — 답변 품질 평가(rating: good/bad), 오류·개선 제보(comment), 그리고 이전 제보의 처리 상태·운영팀 답변 확인(ref_code). ⚠ 사용자가 명시적으로 피드백·평가·오류신고 의사를 밝힌 경우에만 호출할 것 — 임의·자동 호출 금지. 대화 내용을 통째로 넣지 말고 사용자가 말한 요지만 전달할 것. 개인정보(연락처·이메일)는 입력하지 않도록 안내 (reporter_name은 사용자가 이름을 밝힐 때만). 접수 성공 시 응답의 접수코드(ref_code, 예: FB-1932E-AB087)를 사용자에게 그대로 알려주고 보관하도록 안내할 것. "지난번 제보 어떻게 됐나"류 질문에는 사용자에게 접수코드를 물어 ref_code로 전달할 것 — ⚠ 코드를 절대 추측·생성하지 말 것(틀린 코드는 다른 사람의 제보를 열 수 있다). 코드를 모르면 새 피드백으로 접수할 것. ref_code와 comment를 함께 주면 같은 건에 후속 의견이 추가되고, ref_code만 주면 상태·답변만 조회한다. 운영팀 답변은 요약하지 말고 사용자에게 그대로 전달할 것. (EN) Submit or follow up on feedback: quality rating, issue report, or status/reply lookup by reference code.
