Skip to main content
이 페이지는 필드 정의만 다룹니다. 응답을 어떤 순서로 읽고 어떻게 해석하는지는 분석 결과 읽기에 있습니다.

엔드포인트

요청

경로 파라미터

응답 구조

응답 필드는 두 갈래입니다.
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


응답 예시

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

상태값 열거형 요약

에러 코드

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