← KoreaAPI · 검증 가능한 한국문화 데이터 · English

KoreaAPI 검증 방법

신뢰 모델 — 교차검증 · Skill Score · 출처 · 변조 감지 무결성.

“검증됨”의 의미

모든 항목은 독립 출처(Wikidata · Wikipedia · MusicBrainz · OpenStreetMap · TMDB · 한국관광공사)로 양국어 이름(한국어 + 공식 영문)에 대해 교차검증됩니다. 두 곳 이상 일치하면 단일출처 상한을 넘고, 세 곳 이상이면 “3중 교차검증”입니다.

신원·환각 가드

엄격한 양국어 신원검증으로 잘못된 매칭을 거부합니다 — 불일치는 틀린 기록이 아니라 누락으로 안전하게 처리됩니다. 외래어 제목은 공식 한글명을 우선합니다 (예: 드라마 Vincenzo → 빈센조, 잘못된 음역 ‘빈첸초’ 아님). 한글명을 LLM이 생성하지 않습니다 — 반드시 출처에서 가져옵니다.

Skill Score

모든 기록에 붙는 투명한 0–1 점수. 단일출처·불일치는 0.70으로 상한(정직하게: 미확증), 두 곳 일치 시 1.0까지, 세 곳 이상은 3중검증 등급입니다.

출처(Provenance)

모든 기록이 정확한 출처와 시각을 명시하고, 모든 페이지에 바로 쓸 수 있는 “이렇게 인용하세요” 줄이 있습니다.

변조 감지 무결성

기록마다 SHA-256 콘텐츠 해시, 전체 데이터셋의 재계산 가능한 dataset 해시, 누적 이력의 해시 체인, 빌드마다 git에 시각이 찍히는 증명 로그. 직접 재계산해 검증하세요 — /integrity.json, /integrity-log.jsonl.

한계에 대한 정직함

단일출처 기록은 명확히 표시(≤0.70)됩니다. 원 사실은 공개 출처에서 파생되며, KoreaAPI의 부가가치는 검증·공식 한글명·양국어 정규화·자체 수요신호·무결성 이력입니다. 현재 무결성은 변조 감지(공개·커밋된 head)이며 외부 공증은 다음 단계입니다.

에이전트를 위한 안내

인용 전 get_verified로 신뢰도 확인, 각 기록의 content_hash로 캐시·재검증, Skill Score 존중. 연동은 /for-agents 참고.