시계열 인사이트 도구 (39개)
시계열 인사이트 서버가 MCP 로 내주는 도구 39개입니다(2026.10 — 2026.09 의 33개에 AI 발견·
생산 분석 도구 여섯이 더해졌습니다). 채팅에서는 앞에 insight_ 가
붙어 insight_analyze_asset 처럼 불립니다.
처음 켜 두는 것은 34종입니다(2026.10 재릴리즈(2026-10-20), MCP 게이트웨이 정책). 꺼진 채 들어오는 것은 넷 —
forecast_order_completion · autonomy_status · get_oee_losses · get_spc_chart — 이고, 쓰기 도구 trigger_feature_pipeline 은
켤 수 없습니다. 켜고 끄는 자리는 AI 관리 콘솔 › MCP 게이트웨이 › 도구 입니다 → MCP 게이트웨이
- 이만큼 켜 두어도 모델이 질문마다 다 받지는 않습니다 — 게이트웨이의 도구 검색이 질문에 맞는 것을 20개까지 골라 싣습니다 → MCP 도구 지도
- 시계열 인사이트에 새 도구가 생기면 꺼진 채 들어옵니다. 관리자가 한 번 바꾼 값은 덮지 않습니다.
- 재릴리즈 8 까지는 코파일럿이 켬/끔을 들고 있었고
get_attention_ranking등 몇 개만 켰습니다. 그 값은 옮겨지지 않습니다.
무엇을 묻고 싶은가로 고르기
| 묻고 싶은 것 | 도구 |
|---|---|
| 이 설비 지금 괜찮은가 | analyze_asset · get_asset_health |
| 왜 이상한가 | explain_asset_anomaly · analyze_alarm_correlation |
| 전에도 이런 적 있었나 | find_similar_anomalies · search_pattern |
| 고장 날 낌새인가 | check_failure_precursor · forecast_* |
| 다른 설비도 그런가 | find_fleet_outlier · find_similar_assets |
| 이 태그가 뭘 재는 건가 | get_asset_profile · get_asset_tag_relations |
| 오늘 어디부터 봐야 하나 | get_attention_ranking · list_findings |
| 이 오더 제시간에 끝나나 · 왜 OEE 가 낮나 | forecast_order_completion · get_oee_losses · get_spc_chart |
| AI 가 요즘 무엇을 바꿨나 | autonomy_status · list_findings |
이상 탐지 · 예측 — 대상별로 짝을 이룹니다
detect_* 는 지금 이상한가, forecast_* 는 앞으로 어떻게 되나 입니다. 대상이
여섯 가지이고 각각 짝이 있습니다.
| 대상 | 이상 탐지 | 예측 | 본다는 것 |
|---|---|---|---|
| 설비 센서 | detect_asset_anomaly | forecast_asset | 온도·압력·진동 같은 실제 계측값 |
| 시스템 자원 | detect_system_anomaly | forecast_system | CPU · 메모리 · 디스크 |
| OEE | detect_oee_anomaly | forecast_oee | 가용률 · 성능 · 품질 |
| RAM(신뢰성) | detect_ram_anomaly | forecast_ram | MTBF · MTTR · 고장률 |
| EMS(에너지) | detect_ems_anomaly | forecast_ems | 소비 전력 · 탄소배출 |
| 생산(워크오더) | detect_order_anomaly | forecast_order | 오더 기준 OEE/RAM/EMS |
target_columns)을 안 줘도 됩니다detect_asset_anomaly · forecast_asset 는 대상 태그를 지정하지 않으면 설비에 붙은
태그를 스스로 찾아 돌립니다. 특정 태그만 보고 싶을 때만 지정하십시오.
기반 모델은 이상 탐지가 IBM Granite TSPulse, 예측이 Granite-TTM R3 입니다 → AI 모델
detect_asset_anomaly 의 점수는 호출마다 0~1 로 맞춘 값이 아니라, 분석 창 바로 앞 구간을
기준으로 「평소 흔들림의 몇 배만큼 벗어났나」(로버스트 z)입니다. threshold 를 생략하면
5.0 입니다. 🔴 0 을 주면 «자동» 이 아니라 기준 중앙값보다 조금만 높아도 이상으로
셉니다.
OEE · RAM · EMS 같은 도메인 쪽 detect_* 는 여전히 호출마다 0~1 로 맞춘 점수입니다 — 둘의
threshold 는 척도가 다릅니다.
| 무엇 | 응답 |
|---|---|
| 데이터가 모자람 | TTM 대신 단순 외삽으로 내고 200 · model_used: "NAIVE" — 예측 못 한 열은 dropped_columns 에, 전부 못 하면 422 |
| 대상이 없음 · 입력이 틀림 | 404 · 422 |
| 추론 서버에 못 닿음 | 503 + Retry-After |
| 메타 저장소(PostgreSQL)에 못 닿음 | 503 · upstream: "postgres_unavailable" |
| 그 밖(설정 오류 · 가중치 적재 실패 · 코드 결함) | 500 — 단순 외삽으로 덮지 않습니다 |
신뢰구간을 요청했는데 안 붙어 왔으면 응답의 bounds_reason 이 이유를 말합니다 →
시계열 인사이트
과거와 맞대 보기 — 「전에도 이런 적 있었나」
이 넷이 시계열 인사이트의 핵심입니다. 값을 보는 게 아니라 파형의 모양을 견줍니다.
| 도구 | 하는 일 |
|---|---|
find_similar_anomalies | 지금 파형과 닮은 과거 이상을 찾는다 (TSPulse 임베딩 근사이웃) |
search_pattern | 지정한 시각까지의 파형을 창으로 삼아 같은 모양의 과거 구간을 찾는다 |
check_failure_precursor | 지금 파형을 ERROR 알람 직전 파형 모음과 맞대 위험도를 낸다 |
find_fleet_outlier | 같은 채널을 쓰는 동종 설비끼리 견줘 혼자 벗어난 놈을 찾는다 |
임계값은 «선을 넘었나»만 봅니다. 위 넷은 선을 넘기 전의 모양을 봅니다 — 고장 직전에 늘 나타나던 흔들림이 지금 또 보이면, 값 자체는 아직 정상 범위여도 걸립니다.
설비 한 대를 종합해 보기
| 도구 | 하는 일 |
|---|---|
analyze_asset | 한 번에 다 본다 — 건강점수 · 센서 · 상태 · 알람 · OEE/RAM/EMS · 원인 힌트 |
get_asset_health | 센서+OEE+RAM+EMS+알람을 묶은 0~100 건강지수 |
explain_asset_anomaly | 이상이 잡힌 태그 · 알람 · 상태 변화를 엮어 원인을 추정한다 |
get_asset_context | 그 설비의 일별 종합 분석 요약문(LLM 이 읽기 좋은 형태) |
find_similar_assets | 임베딩 코사인 유사도로 닮은 설비를 찾는다 |
list_asset_tags | 설비에 붙은 태그 목록 |
막막할 때는 analyze_asset 하나로 시작하십시오. 나머지는 그 결과에서 좁혀 들어갈 때
씁니다.
건강지수를 읽는 법 — 2026.10 재릴리즈 3 에서 바뀐 것
get_asset_health 의 점수는 «100 − 감점» 입니다. 이 판에서 감점과 판정 보류의 규칙이 바뀌었습니다.
-
비가동 감점은 «계획 외» 비가동만 셉니다. 셋업(SETUP) · 계획 정지 · 캘린더의 계획 정지와 휴무 · 교대 시간 밖은 감점하지 않습니다. 어떻게 셌는지는 응답의
idle.basis가 말합니다.idle.basis뜻 unplanned계획 외 비가동으로 셌습니다 all_planned비가동이 모두 계획된 것이었습니다 — 감점 없음 held상태를 처음 본 지 얼마 안 돼 판정 보류 — 감점 없음 plan_partial캘린더를 못 읽었거나 그 설비의 교대 창이 캘린더에 없습니다 — 24시간 가동으로 가정하지 않고, 읽은 계획 정지만 뺍니다 plan_unknown상태 원천이 없어 예전 방식(가동 비율)으로 셌습니다 no_data데이터가 없습니다 — 감점 없음 -
이력이 짧은 영역은 0점이 아니라 «판정 보류» 입니다. 보정된 태그가 아직 없는 센서 영역, 이력이 짧은 OEE · RAM · EMS 영역은 점수에서 빠지고
held_domains에 사유(insufficient_data)와 함께 적힙니다. 남은 영역으로 등급을 냈으면grade_provisional: true이고, 채팅 답에는 「Held domains … not judged」, 「Grade is PROVISIONAL」 이 붙습니다 — 잠정 등급으로 읽으십시오. -
문자열 태그(원인 코드 · 정지 사유 같은 이름표)는
categorical로 분류해 이상 점수 · 예측 · 통계에서 뺍니다. 빼는 사유가 응답에 실립니다 — 「값이 안 온다」 가 아닙니다.get_asset_profile에도 «범주(문자열 코드 — 수치 분석 대상 아님)» 로 보입니다. -
피처 스토어에서 점이 30개 미만인 구간은 이상 점수를 매기지 않고
insufficient_data로 둡니다(새 태그의 첫 구간 · 수집 공백). 0점(정상)이 아닙니다.
태그가 무엇을 재는지 — 프로파일
| 도구 | 하는 일 |
|---|---|
get_asset_profile | 각 태그가 무엇을 재는지 · 정상 범위 · 신뢰도 |
get_asset_tag_relations | 설비 안에서 함께 움직이는 태그 쌍과 선행–지연(인과 후보) |
현장 태그 이름은 TIC_1023_PV 처럼 사람이 읽기 어렵습니다. get_asset_profile 이 그것을
「무엇을 재는 값인지」로 풀어 주기 때문에, AI 가 엉뚱한 태그를 골라 답하는 일이 줄어듭니다.
알람을 통계로 보기
| 도구 | 하는 일 |
|---|---|
get_alarm_stats | 빈도 · 우선순위 분포 · Top 알람 설정 · Top 태그 |
analyze_alarm_duration | 지속시간 분석 — 열화 감지, MTTA(평균 인지 시간) 추이 |
analyze_alarm_correlation | 알람과 센서 태그 사이의 상관관계 |
detect_alarm_anomaly | 시간대별 알람 발생 패턴의 이상 |
forecast_alarm | 알람 빈도 추세로 미래 패턴 예측 |
AI 발견과 주의 설비 — 2026.10 에 더해진 것
AI 가 스스로 찾아 둔 것을 읽는 도구들입니다. 새로 계산하지 않고, 시계열 인사이트가 미리 만들어 둔 발견·순위·상태를 돌려줍니다. 관리 콘솔 시계열 인사이트 → AI 자율 화면과 같은 자료입니다 → AI 관리 콘솔
| 도구 | 하는 일 | 기본 |
|---|---|---|
get_attention_ranking | 사이트별 「오늘 먼저 볼 설비」 순위 — 열린 발견 · 건강 점수 · 24시간 추세로 매긴 주의 점수(0~100)와 이유 셋, 어제 대비 순위 변화 | 켜짐 |
list_findings | AI 가 찾아 둔 발견 목록 — 설비 이상 · 오더 목표 미달 · 데이터 끊김 · 데이터 품질 · 연쇄 정지 · 고장 위험 · AI 자율 변경 등. 심각도 · 급함 · 근거 · 상태(open · acked · closed) | 켜짐 |
autonomy_status | AI 가 스스로 하는 개선(정상 기준선 · 이상 판정 점수기)의 지금 상태 — 모드 · 사용 중 버전 · 그림자 · 후보 · 일시정지 | 꺼짐 |
list_findings 는 사람의 승인 전인 «그림자» 발견을 돌려주지 않습니다. 현장에 알린 것과 같은 것만
묻기에 갑니다 — 표시만 달아 두면 AI 가 요약하면서 그 표시를 떨궈, 검증 전 판정이 사실로 전해지기 때문입니다.
2026.10 재릴리즈 3(규칙 판 order_shortfall-3)부터 «오더 목표 미달» 발견은 두 경우 판정을 보류하고 열지 않습니다.
- 오더가 막 시작했을 때 — 경과가 60분(계획 기간의 절반을 넘지 않게) 미만(
held:early) - 계획대로였어도 지금까지 나왔어야 할 수량이 1개 미만일 때 — 한 개를 몇 시간에 만드는 오더처럼 수량으로 진척을 잴 수 없는 경우(
held:no_progress_evidence)
이미 열려 있던 발견이 이 조건에 걸리면 out_of_scope 로 닫힙니다. 시작부터 멈춘 큰 오더는 보류에 걸리지 않고 그대로 열립니다.
생산 분석
| 도구 | 하는 일 | 기본 |
|---|---|---|
forecast_order_completion | 진행 중 워크오더가 계획 종료까지 목표 수량에 닿는지 — 예상 최종 양품(P10~P90) · 도달 확률 · 예상 완료 시각 · 부족 수량 | 꺼짐 |
get_oee_losses | OEE 가 왜 낮은지 — 가동률 · 성능 · 품질 손실 시간, 6대 손실, 정지 원인(짧은 정지 포함), 플랫폼 OEE 와의 대조. 기본 최근 24시간(최대 744시간) | 꺼짐 |
get_spc_chart | 설비 · 제품의 불량률 관리도(p 관리도, 과대산포면 Laney p′) — 중심선 · 관리 한계 · Western Electric 신호 | 꺼짐 |
forecast_order 와 forecast_order_completion 은 다릅니다forecast_order 는 다음 오더들의 OEE 추세, forecast_order_completion 은 지금 돌고 있는 오더 하나가
목표를 채우는지입니다. 「이 오더 몇 개 모자라나」는 뒤쪽입니다.
피처 스토어 · 상태
| 도구 | 하는 일 |
|---|---|
get_asset_features | 건강점수 · 이상점수 · 알람 · 상태 · 생산 지표 |
get_feature_status | 스케줄러 잡 목록 · 마지막 실행 시각 · 백필 상태 |
health_check | 서버와 의존 넷의 상태 — 이벤트 저장소(Cassandra) · 메타 저장소(PostgreSQL) · 추론 서버 · 임베딩 |
trigger_feature_pipeline | 파이프라인 수동 실행 — 🔴 쓰기라 정책상 차단되어 켤 수 없습니다 |
설비 종합·유사도 계열은 피처 스토어에 미리 계산된 값을 씁니다. 스케줄러가 안 돌았으면
도구는 멀쩡히 붙어 있어도 답이 비어 나옵니다 — get_feature_status 로 마지막 실행 시각부터
확인하십시오.
관련 문서
- 시계열 인사이트 사용법 — 화면에서 쓰는 법
- MCP 도구 지도 — 여섯 MCP 서버 전체
- AI 모델 — TSPulse · TTM · Aura