모델 설명(XAI)
개요
이 화면은 무엇인가요?
이 화면에서는 모델 설명(XAI) 데이터를 등록하고 관리합니다. 시각화유형(WATERFALL, FORCE_PLOT, BEESWARM, DEPENDENCE 등)별로 분류할 수 있습니다.
누가 사용하나요?
- 데이터사이언티스트: 모델 설명(XAI) ML 모델 개발, 학습 관리
- MLOps엔지니어: 모델 설명(XAI) 모델 배포, 운영 관리
- AI엔지니어: 모델 설명(XAI) 모델 학습, 성능 최적화
언제 사용하나요?
- 신규 모델 설명(XAI) 데이터를 등록할 때
- 기존 모델 설명(XAI) 정보를 수정하거나 이력을 확인할 때
주요 기능
- 등록·조회: 모델 설명(XAI) 데이터의 신규 등록 및 목록 조회
- 유형별 분류: 설명기법(SHAP , LIME , ANCHORS 등)별 분류 및 필터
- 파일 첨부: 관련 문서·이미지 업로드 및 관리
- 감사 추적: 데이터 변경 이력 자동 기록
업무 흐름에서의 위치
입력 항목 가이드
| 항목 | 설명 | 필수 | 입력 예시 |
|---|---|---|---|
| 설명코드 | 고유 식별 코드 | ✅ | EXPLANATION--001 |
| 예측결과ID | 관련 데이터 선택 | 목록에서 선택 | |
| 모델ID | 관련 데이터 선택 | 목록에서 선택 | |
| 설명기법 | 식별하기 쉬운 이름 | ✅ | SHAP / LIME / ANCHORS |
| 피처중요도 | 피처중요도 | JSON 형식 입력 | |
| SHAP값URL | SHAP값URL | 텍스트 입력 | |
| LIME세그먼트 | LIME세그먼트 | JSON 형식 입력 | |
| 반사실데이터 | 반사실데이터 | JSON 형식 입력 | |
| 전역설명여부 | 식별하기 쉬운 이름 | 예 / 아니오 | |
| 신뢰도점수 | 신뢰도점수 | 숫자 입력 (소수점 가능) | |
| 계산시간(ms) | 계산시간(ms) | 숫자 입력 | |
| 시각화유형 | 분류 구분 | WATERFALL / FORCE_PLOT / BEESWARM | |
| 시각화URL | 시각화URL | 텍스트 입력 | |
| 생성일시 | 해당 날짜/시각 | ✅ | 2026-03-17 09:00 |
| 생성자ID | 담당자 선택 | 목록에서 선택 | |
| 설명 | 식별하기 쉬운 이름 | 자유 텍스트 입력 |
자주 묻는 질문 (FAQ)
모델 설명(XAI) 데이터를 대량으로 등록하려면 어떻게 하나요?
CSV 가져오기 기능을 사용합니다. 먼저 CSV 내보내기로 템플릿을 다운로드한 후, 템플릿에 맞춰 데이터를 입력하고 CSV 가져오기로 일괄 등록합 니다.
실무 시나리오
신규 모델 설명(XAI) 등록
상황: 새로운 모델 설명(XAI) 데이터를 등록해야 합니다.
처리 순서:
- 설명코드를 입력하여 신규 데이터를 생성합니다
- 시각화유형을
WATERFALL으로 선택합니다 - 설명기법을(를) 입력합니다
- 생성일시을(를) 입력합니다
- 저장하여 등록을 완료합니다
참고: 데이터 구조
테이블: dt_model_explanations
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
explanation_code | 설명코드 | VARCHAR | *필수 |
prediction_id | 예측결과ID | UUID | |
model_id | 모델ID | UUID | |
explanation_method | 설명기법 | SHAP / LIME / ANCHORS / COUNTERFACTUAL / INTEGRATED_GRADIENTS / ATTENTION_MAP | *필수 |
feature_importances | 피처중요도 | JSONB | |
shap_values_url | SHAP값URL | VARCHAR | |
lime_segments | LIME세그먼트 | JSONB | |
counterfactual_data | 반사실데이터 | JSONB | |
global_explanation | 전역설명여부 | BOOLEAN | |
confidence_score | 신뢰도점수 | DECIMAL | |
computation_time_ms | 계산시간(ms) | INT | |
visualization_type | 시각화유형 | WATERFALL / FORCE_PLOT / BEESWARM / DEPENDENCE / HEATMAP | |
visualization_url | 시각화URL | VARCHAR | |
created_at | 생성일시 | TIMESTAMP | *필수 |
created_by | 생성자ID | UUID | |
description | 설명 | TEXT |