Skip to main content

엔드포인트

요청


응답 구조 — 두 갈래로 나뉩니다

분석 응답을 읽을 때 가장 먼저 구분해야 할 것은 어떤 필드를 시스템이 제공하고, 어떤 필드를 워크플로우에서 정의했는지입니다.

시스템 고정 필드

워크플로우 설정과 무관하게 항상 동일한 키로 반환됩니다. 실행 이력, 단계별 결과, 집계 지표가 여기 속합니다.

출력 스키마 기반 필드

outputSchema · extractedData · extractionStatus 세 필드입니다. 내부 구조는 워크플로우마다 완전히 다릅니다.
extractedData 안에 어떤 필드가 들어오는지는 워크플로우에 정의한 출력 스키마가 결정합니다. Omni가 고정된 필드 집합을 강제하지 않습니다. 이 문서는 시스템 고정 필드만 필드 단위로 기술하며, 출력 스키마 영역은 구조만 설명합니다.

시스템 고정 필드 목록

출력 스키마 기반 필드


최상위 필드

string
필수
분석 고유 ID (analysis_ 접두사)
string
필수
이 분석이 속한 프로필 ID
string | null
필수
분석 대상 폴더 ID. 폴더를 지정하지 않고 프로필 전체를 분석한 경우 null
string | null
필수
단일 엔진을 직접 지정해 실행한 경우의 엔진 ID. 워크플로우에 설정된 엔진 구성을 그대로 사용하면 null
object | null
필수
engineId가 있을 때의 엔진 상세 정보. 그 외에는 null
string
필수
분석에 사용된 플레이북 ID (PB- 접두사). 워크플로우의 정책 텍스트로부터 생성된 실행 계획을 가리킵니다
string
필수
분석 잡의 처리 상태: pending / processing / completed / failed
number
필수
분석 처리 소요 시간 (밀리초)
string
필수
분석 결과에 대한 시스템 판정: verified / pending_review / rejected. 아래 검증 상태 3종 구분 참조
number | null
필수
검증 판정과 함께 산출되는 신뢰도 (0.0 – 1.0). verified일 때는 통과한 액션들의 신뢰도 평균이고, 그 외 판정에서는 판정별 고정값입니다. confidence와는 다른 지표입니다
object | null
필수
분석 실패 시의 에러 정보. code, message, 선택적으로 details를 담습니다. 정상 완료 시 null
object | null
분석 요청 시 전달된 옵션. 전달하지 않았으면 null
object | null
클라이언트가 분석 요청 시 전달한 메타데이터. 전달하지 않았으면 null
string | null
이 분석에 대해 생성된 주 리포트 ID (rpt_ 접두사)
string | null
primaryReportId와 동일한 값을 담는 레거시 필드. 신규 연동은 primaryReportId를 사용하세요
string
필수
분석 요청 시각 (ISO 8601)
string | null
필수
분석 완료 시각 (ISO 8601). 미완료 시 null
string
필수
DB 레코드 생성 시각 (ISO 8601)

검증 상태 (verificationStatus) 3종 구분

응답 안에는 이름이 같거나 비슷한 검증 상태가 세 계층에 존재하며, 값 집합이 서로 다릅니다. 연동 시 어느 계층을 보고 있는지 반드시 확인하세요.
두 번째 행은 출력 스키마가 아니라 플레이북 액션 실행 결과입니다. 출력 스키마에 같은 이름의 필드를 정의했다면 그것은 세 번째 행에 해당하며, 시스템 판정과는 별개의 값입니다.
최상위 판정은 액션 단위 결과를 집계해 결정됩니다. 실패한 액션이 하나라도 있으면 rejected, 전부 통과하면 verified, 그 외에는 pending_review입니다. agentAuditLog.summary.overall_decision도 같은 액션 결과에서 산출되므로 아래와 같이 대응합니다.

confidenceScore vs confidence — 서로 다른 지표

이름이 비슷하지만 측정 대상이 완전히 다릅니다.
confidenceScore가 높아도 confidence.score는 낮을 수 있습니다. AI가 모든 단계를 자신 있게 통과시켰지만 출력 스키마에 값이 하나도 채워지지 않은 경우가 대표적입니다. 자동 승인 로직을 만든다면 confidencedetails를 함께 확인하세요.

confidence — Analysis Score

Omni 대시보드에서 분석 상세를 열었을 때 최상단에 표시되는 Analysis Score가 이 필드입니다. components의 세 항목을 가중 평균해 score를 내고, 그 score가 속한 구간으로 level이 정해집니다.

confidence.components

예를 들어 components100 / 97.22 / 76.98이면 score90, levelHIGH입니다.
세 항목 중 측정할 수 없어 null인 항목이 있으면, 남은 항목의 가중치만으로 정규화해 계산합니다. 전부 null이면 scorelevelnull이 됩니다.

details[] — 완성도 감점 사유

confidence 점수를 낮춘 항목을 개별로 나열합니다. 감점 요인이 없으면 빈 배열입니다.

riskAssessment — 위험도

분석 결과를 종합해 산정한 위험도입니다.

systemMetadata — 시스템 실행 메타데이터

AI 에이전트가 분석을 수행하는 동안의 내부 실행 정보입니다.

systemMetadata.workflowHistory[]

실행된 작업만 포함됩니다. 플레이북에 정의됐지만 실행되지 않은 단계는 여기 나타나지 않습니다. 전체 단계 정의가 필요하면 GET /workflows/:workflowIdworkflowActions를 함께 조회하세요.

systemMetadata.tokenUsage

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

outputSchema · extractedData · extractionStatus — 출력 스키마 영역

이 세 필드의 내부 구조는 전적으로 워크플로우의 출력 스키마 정의를 따릅니다. Omni가 정한 공통 필드는 존재하지 않습니다. 워크플로우가 다르면 키 이름과 중첩 구조가 완전히 달라집니다.
outputSchema분석 실행 시점에 동결된 스냅샷입니다. 이후 워크플로우의 출력 스키마를 수정해도 과거 분석 결과의 outputSchema는 바뀌지 않습니다.

값이 채워지지 않은 필드

AI가 문서에서 값을 찾지 못한 스키마 필드는 extractedData에 채워지지 않고, extractionStatus에서 missing으로 표시됩니다. 동시에 details[]OUTPUT_MISSING 항목이 추가되고 confidence.components.outputCompleteness 점수가 낮아집니다.
extractedData의 키는 항상 출력 스키마의 최상위 필드명과 동일합니다. 어떤 필드가 실제로 채워졌는지는 extractionStatus로 확인하세요.

rawActionResults — 액션별 원시 결과

각 AI 액션이 반환한 원시 결과입니다. 키는 액션명(actionName) 이며, 어떤 액션이 존재하는지는 워크플로우의 workflowActions 정의에 따라 달라집니다.

agentAuditLog — 에이전트 실행 감사 로그

AI 에이전트가 수행한 모든 단계의 상세 실행 로그입니다. rawActionResults보다 세부적이며 외부 엔진 호출 정보를 포함합니다.
agentAuditLog배열이 아니라 객체이며, 내부 필드는 스네이크 케이스(executed_at, item_ids, duration_ms)를 사용합니다. 응답 최상위의 카멜 케이스 필드와 표기 규칙이 다르므로 파싱 시 주의하세요.

agentAuditLog.steps[]

agentAuditLog.steps[].mcpcalls[]

외부 엔진(AML 스크리닝, 텍스트 대조 등)을 호출한 단계에만 값이 있습니다.

agentAuditLog.summary


findings[] — 검증 결과 항목

각 액션의 결과를 정렬된 형태로 요약한 목록입니다. UI 표시용입니다. resultagentAuditLog.steps[].status에 대응합니다 — passedpassed, needs_reviewwarning, failedfailed.

recommendations[] — 권고사항

시스템이 생성한 후속 조치 권고사항 목록입니다.

targetItems[] — 분석 대상 아이템

이 분석에서 참조된 아이템 목록입니다.

응답 예시

아래는 구조 이해를 돕기 위한 가상 예시입니다. outputSchemaextractedData의 내부 필드는 워크플로우마다 다릅니다.

상태값 열거형 요약