출력 스키마

위치: 워크플로우 생성 마법사 4단계 — 출력 스키마 분석 결과 extractedData의 구조는 여기서 정의한 스키마를 그대로 따릅니다. Omni가 정한 공통 필드는 없습니다.

두 가지 입력 방식

탭 두 개가 있고 서로 자동 변환됩니다. 한쪽에서 고치면 다른 쪽에 반영됩니다.

탭	언제 쓰나
필드 빌더	필드를 하나씩 쌓아 올릴 때. 타입·형식을 폼으로 고름
JSON Schema 직접 입력	이미 스키마가 있거나 통째로 붙여넣을 때

필드 빌더

필드 추가를 누르면 표에 행이 하나 추가됩니다(별도 모달이 열리지 않습니다).

열	내용
필드 이름	필수. 같은 이름을 중복할 수 없음. 왼쪽 드래그 핸들로 순서를 바꿉니다
타입	아래 6종. 아이콘으로 구분됩니다
형식/제약조건	`string`은 형식, `array`는 최대 크기. 그 외 타입은 비어 있음
설명	AI가 이 필드를 이해하는 근거. 비워도 되지만 넣는 편이 정확도가 높음
작업	`object`·`array`는 하위 속성을 추가하는 +, 모든 행에 삭제

object와 array 행에는 펼침 화살표와 하위 속성 개수 배지가 붙습니다. 화살표를 누르면 그 아래에 하위 필드가 한 단계 들여쓰기되어 펼쳐집니다. 정의된 필드가 없으면 “정의된 필드가 없습니다. ‘필드 추가’ 버튼을 클릭하여 시작하세요”가 표시됩니다. JSON Schema 미리보기를 누르면 지금까지 만든 필드가 JSON Schema로 어떻게 조립되는지 확인할 수 있습니다.

JSON Schema 직접 입력

JSON Schema Draft-07 형식으로 붙여넣습니다. 유효하면 유효한 JSON Schema입니다가 표시됩니다.

출력 스키마 JSON 직접 입력 — JSON 직접 입력 탭 — 유효성 검사 결과가 함께 표시됩니다.

필드 타입

타입	뜻
`string`	텍스트 데이터
`number`	소수점 포함 숫자
`integer`	정수
`boolean`	`true` / `false`
`object`	중첩 객체
`array`	값의 배열

문자열 형식

string 타입에는 형식을 지정할 수 있습니다.

형식	예시
None	제한 없음
Date	`2026-01-15`
Date-Time	`2026-01-15T14:30:00Z`
Time	`14:30:00`
Email	`user@example.com`
URL	`https://www.example.com`
IPv4	`192.168.1.1`
Enum	허용할 값을 하나씩 입력하고 Enter로 추가

배열

배열은 값의 배열과 객체의 배열 둘 다 됩니다.

["value1", "value2", "value3"]
[{ "key": "value" }, { "key": "value" }]

array 타입을 고르면 형식/제약조건 칸에 최대 배열 크기가 들어갑니다. 기본값은 최대: 10입니다.

제약

제약	내용
루트 타입	반드시 `"type": "object"`. 필드는 `properties` 안에
중첩 깊이	최대 2단계(객체 안의 객체까지)
필드 이름	같은 이름 중복 불가
허용 타입	`string` · `number` · `integer` · `boolean` · `object` · `array`

검증 메시지

JSON 직접 입력에서 스키마가 규칙에 어긋나면 아래 메시지가 표시됩니다.

메시지	원인
JSON 구문 오류	JSON 자체가 파싱되지 않음
JSON Schema는 반드시 객체({}) 형태여야 합니다	최상위가 객체가 아님
`"type": "object"`를 포함해야 합니다	루트에 타입 선언이 없음
루트 타입은 반드시 `"object"`여야 합니다	루트 타입이 객체가 아님
최대 중첩 깊이(2단계)를 초과했습니다	3단계 이상 중첩
지원되지 않는 타입	허용 타입 6종 밖의 값
키가 중복되었습니다	같은 필드 이름을 두 번 정의

탭을 전환할 때 JSON에 오류가 있으면 이전 필드 빌더 상태로 복원되고, 유효하지 않은 필드가 있으면 그 필드만 제외됩니다.

설명을 채우세요

각 필드의 description은 AI 에이전트가 그 필드를 어떻게 채울지 판단하는 근거입니다. 데이터 형식과 이 필드가 어떤 서류의 어떤 항목에서 나오는지를 함께 쓰세요.

{
  "registration_number": {
    "type": "string",
    "description": "사업자등록번호 (000-00-00000 형식). 사업자등록증 상단의 등록번호 항목에서 추출합니다."
  }
}

정책 원문·아이템 이름·스키마 설명에서 같은 용어를 쓰는 것이 정확도에 크게 영향을 줍니다 — 워크플로우 만들기.

결과는 봉투로 감싸집니다

정의한 말단 필드는 분석 결과에서 값 대신 value · reasoning · sourceStep 세 키를 가진 객체로 내려옵니다. 중간 객체와 배열 구조는 스키마 그대로입니다.

{
  "company": {
    "name": {
      "value": "주식회사 에이씨엠이 트레이딩",
      "reasoning": "사업자등록증의 법인명 항목에서 확인했습니다.",
      "sourceStep": 1
    }
  }
}

읽는 방법은 분석 결과 읽기에 있습니다.

출력 스키마에 verificationStatus 같은 판정 필드를 직접 정의할 수 있지만, 그것은 사용자 정의 값이며 응답 최상위의 시스템 판정과는 별개입니다. 값 집합을 시스템과 맞춰두면(verified · pending_review · rejected) 후속 분기가 단순해집니다.

개요

프로젝트

워크플로우 설정

프로파일·분석

두 가지 입력 방식

필드 빌더

JSON Schema 직접 입력

필드 타입

문자열 형식

배열

제약

검증 메시지

설명을 채우세요

결과는 봉투로 감싸집니다

​두 가지 입력 방식

​필드 빌더

​JSON Schema 직접 입력

​필드 타입

​문자열 형식

​배열

​제약

​검증 메시지

​설명을 채우세요

​결과는 봉투로 감싸집니다

두 가지 입력 방식

필드 빌더

JSON Schema 직접 입력

필드 타입

문자열 형식

배열

제약

검증 메시지

설명을 채우세요

결과는 봉투로 감싸집니다