메인 콘텐츠로 건너뛰기
이 페이지는 필드 정의만 다룹니다. 응답을 어떤 순서로 읽고 어떻게 해석하는지는 분석 결과 읽기에 있습니다.

엔드포인트

요청

경로 파라미터

응답 구조

응답 필드는 두 갈래입니다.
extractedData에 어떤 필드가 들어오는지는 워크플로우의 출력 스키마가 결정합니다. Omni가 공통 키를 강제하지 않습니다. 다만 말단 필드의 값은 항상 같은 모양의 봉투(value · reasoning · sourceStep)로 감싸집니다.

최상위 필드


confidence 분석 점수

대시보드 분석 상세 최상단에 표시되는 점수입니다.

confidence.components

null인 항목이 있으면 남은 항목의 가중치로 정규화합니다. 전부 null이면 score와 level도 null입니다.

details 감점 사유

confidence 점수를 낮춘 항목을 개별로 나열합니다. 감점 요인이 없으면 빈 배열입니다. reasonCode는 확장 가능한 열거형입니다. 현재 값과 해석 방법은 분석 결과 읽기를 참조하세요.

riskAssessment

riskScore 산정

액션 단위 판정 결과만으로 계산됩니다. 문서 내용이나 추출 결과는 반영되지 않습니다.
기본값이 25이므로 riskScore는 25보다 낮아질 수 없습니다. 모든 액션이 통과하면 정확히 25(low)입니다. 표의 low 범위가 0–25인 것은 등급 경계일 뿐, 실제로 0–24가 나오지는 않습니다.
riskFactors에는 실패한 액션마다 {액션명} verification failed가, 검토 필요 액션이 있으면 {개수} action(s) need manual review가 한 줄로 들어갑니다.

systemMetadata

systemMetadata.outputFormatting

extractedData를 읽기 전에 이 status부터 분기해야 합니다. 분기 방법은 분석 결과 읽기에 있습니다.

systemMetadata.workflowHistory

실행된 작업만 포함됩니다. 전체 단계 정의는 GET /workflows/:workflowId의 workflowActions에 있습니다.

systemMetadata.tokenUsage

tokenUsagePerWorkId는 작업 ID를 키로, 위와 같은 구조를 값으로 갖습니다.

rawActionResults

액션이 반환한 조립 전 원시 결과입니다. 키는 액션명이며, 어떤 액션이 있는지는 워크플로우의 workflowActions 정의를 따릅니다.

rawActionResults.{actionName}.mcpResults[]

agentAuditLog.steps[].mcpcalls[]와 같은 호출을 액션 기준으로 정리한 목록입니다. 최상위와 같은 카멜 케이스를 씁니다.

agentAuditLog

steps와 summary 두 키를 가진 객체입니다.
agentAuditLog는 배열이 아니라 객체이고, 내부 필드는 스네이크 케이스(work_id · executed_at · duration_ms)를 씁니다. 최상위 필드의 카멜 케이스와 표기 규칙이 다릅니다.

agentAuditLog.steps

agentAuditLog.steps[].mcpcalls[]

agentAuditLog.summary


findings

result는 agentAuditLog.steps[].status를 UI용으로 바꾼 값입니다(needs_review → warning).

recommendations

targetItems


artifacts 생성 파일

분석 중 엔진이 만든 파일 목록입니다. 대시보드 Info 탭의 생성 파일 영역이 이 배열을 그립니다. 지금은 AML 엔진(AML Search - Person · AML - Business)이 매칭 한 건마다 근거 PDF를 하나씩 만듭니다. 매칭이 0건이면 파일이 없으므로 빈 배열입니다. 대시보드의 한 줄 설명(조회 대상 · 임계치 · 생년월일 기준 · 조회 결과 · 매칭 수)은 이 필드들을 이어 붙인 것입니다. 값이 없는 필드는 그 조각을 뺍니다.
근거 PDF를 받아도 크레딧은 조회 1회분 그대로입니다. 파일 수에 따라 늘지 않습니다 — 크레딧이 차감되는 방식.

verdict 조회 결과

매칭된 대상의 위험도로 정해집니다. 같은 조회에서 나온 파일이라도 대상마다 다를 수 있습니다.
artifacts[].verdict는 파일 하나의 조회 결과입니다. 분석 전체 판정인 최상위 verificationStatus와는 다른 값입니다. NO_HIT은 매칭이 0건일 때의 값이라 파일이 만들어지지 않으므로 실제로는 거의 오지 않지만, 열거형에 있으니 처리해 두세요.
2026-10-22 18:12(KST) 이전에 실행한 분석은 매칭별 위험도가 저장되어 있지 않아, 같은 조회에서 나온 파일이 모두 그 조회의 가장 높은 위험도 기준으로 같은 값을 가집니다. matchCount는 예전 분석도 생년월일 매칭으로 뺀 건을 제외한 수로 내려옵니다.

dobMatching 값

Step에 고정한 옵션의 생년월일 매칭 값입니다. AML Search - Person에만 있습니다. off가 아니면 생년월일 정보가 없는 매칭은 결과에서 빠지고, 뺀 수가 dobExcluded에 남습니다. off는 생년월일을 조회에 쓰지 않으므로 dobExcluded가 없습니다.

artifactOmissions

조회 한 번에 만드는 파일은 점수 상위 50건까지입니다. 매칭이 50건을 넘은 조회마다 원소가 하나씩 생기고, 대시보드의 상한 배너가 이 값을 그립니다.

artifactFailures

상한 안에 들었는데 파일을 받지 못한 조회마다 원소가 하나씩 생깁니다. 서버는 일시적인 오류면 조회당 4분 안에서 최대 3번 다시 받고, 그래도 받지 못한 수를 여기에 남깁니다. 받지 못한 파일은 artifacts[]에 행이 없으며, 분석을 다시 실행하면 새로 받습니다.

생성 파일 내려받기

downloadUrl 앞에 호스트만 붙여 GET으로 호출합니다. downloadUrl이 이미 /v1로 시작하므로 Base URL(…/v1)을 붙이면 /v1이 두 번 들어갑니다. 경로 안의 숫자는 내부 좌표이니 직접 만들지 말고 응답 값을 그대로 쓰세요.

예시

개인 한 명을 임계치 90 · 생년월일 ±2년으로 조회한 경우입니다. 생년월일 정보가 없는 9건을 빼고 매칭 62건이 남았고, 상한 50건 중 1건을 받지 못했습니다. artifacts에는 받은 파일 49개 중 2개만 실었습니다.

응답 예시

실제 응답은 훨씬 깁니다. 아래 예시는 최상위 키를 모두 담되, 배열·중첩 객체는 대표 항목 하나씩만 실었습니다.

상태값 열거형 요약

에러 코드

공통 에러(400 요청 검증 · 401 인증 · 403 권한 · 500 서버 오류)는 API 개요를 참조하세요.