샘플 데이터, 스키마, 모델, 결과까지 하나의 보강을 처음부터 끝까지 구성하는 페이지입니다. 그 중심에는 스키마 트리가 있습니다. 드래그 앤 드롭 순서 변경, 인라인 편집, 키보드 탐색, AI 지원 수정 기능을 갖춘 시각적 편집기입니다.
schema 트리를 사용하면 JSON을 직접 작성하지 않고도 enrichment schema를 확인하고 수정할 수 있습니다. 속성은 expertise domain별로 그룹화된 대화형 트리로 표시되므로 어떤 필드가 어떤 전문 영역에 속하는지 한눈에 파악할 수 있습니다. 모든 변경 사항은 실행 취소/다시 실행 기록으로 추적되며 2초 디바운스 후 자동 저장됩니다.
접을 수 있는 섹션으로 전문 영역별로 그룹화된 속성입니다. 그룹화를 켜거나 끌 수 있습니다.
정렬 보기를 끄면 그룹 내에서 또는 그룹 간에 속성을 드래그하여 순서를 변경할 수 있으며, 배치는 스키마에 저장됩니다. 시각적인 드롭 위치 표시가 항목이 놓일 자리를 알려 줍니다.
속성을 클릭하면 트리에서 이름, 유형, 설명 및 예시를 직접 편집할 수 있습니다.
화살표 키로 이동하고 접거나 펼치며, Enter로 편집하고, Delete로 삭제하고, Ctrl+A로 전체를 선택합니다. 실행 취소와 다시 실행은 툴바 버튼으로 제공되며, 스키마를 전환하거나 페이지를 새로 고쳐도 기록은 유지됩니다.
대규모 schema에서 필드를 찾기 위한 텍스트 검색입니다. 속성 이름을 먼저 검색하고, 일치하는 이름이 없으면 설명과 예시로 대체하여 검색합니다. 중첩된 일치 항목은 해당 항목까지 이어지는 경로만 표시하여 드러냅니다.
수동 편집을 위한 전체 기록 스택입니다. AI가 생성한 변경 사항은 실행 취소 항목을 추가하지 않고 대체합니다.
상단의 탭에는 스키마의 명명된 타입이 들어 있습니다. + 버튼은 Object(자체 속성을 가진 중첩 엔티티) 또는 Enum(아무 텍스트 속성이나 가리킬 수 있는 허용 값의 닫힌 목록)을 생성합니다.
SCHEMA와 JSON 옆에 있는 DIAGRAM 뷰는 스키마를 엔터티 다이어그램으로 그립니다 — 이름이 지정된 엔터티는 제목이 있는 카드로, 중첩된 객체는 해당 관계 이름을 딴 일반 카드로 표시하며, 참조(1–1)와 링크(1–N)는 점선으로 연결합니다. 편집 내용을 실시간으로 반영하며, 엔터티 카드를 클릭하면 SCHEMA 뷰에서 열립니다.
편집기의 각 행은 스키마 속성을 나타내며, 주요 특성을 한눈에 확인할 수 있습니다:
중첩된 속성(예: headquarters 아래의 city)은 계층 구조를 나타내기 위해 들여쓰기됩니다. 돋보기 아이콘은 검색 키, 즉 엔티티를 식별하는 데 사용되는 필드를 표시합니다.
값 집합은 텍스트 속성을 고정된 허용 값 목록(상태, 등급, 분류 코드 등)으로 제한합니다. 그러면 enrichment는 그 목록에 없는 값을 반환할 수 없으며, 이렇게 하면 동일한 개념이 실행할 때마다 세 가지 다른 표기로 들어오는 것을 막아 줍니다.
타입 탭에서 +를 누르고 Enum을 선택한 뒤 이름을 지정하세요. 새 탭이 멤버 목록을 엽니다.
값을 추가, 이름 변경, 순서 변경 또는 제거하세요. 이름만으로 의미가 분명하지 않은 멤버에는 메모를 추가하세요.
타입 드롭다운의 값 집합 그룹에서 아무 텍스트 속성의 Type을 해당 값 집합(또는 그 배열)으로 설정하세요.
속성의 Type을 다시 string으로 설정하거나 값 집합을 삭제하세요 — 이를 사용하는 속성은 다시 일반 텍스트 속성이 됩니다.
값 집합은 완전하게 나열할 수 있는 어휘에만 사용하세요. 실제 엔티티에 빠뜨린 값이 필요하면 모델은 문제를 알리는 대신 가장 가까운 잘못된 값을 선택할 수밖에 없습니다 — 따라서 개방형 필드(이름, 설명, 자유 텍스트 카테고리)는 일반 텍스트로 두어야 합니다. 스키마 생성도 같은 이유로 값 집합을 보수적으로 제안하며, 제안된 모든 것은 여기서 편집할 수 있습니다.
속성 행을 클릭하거나 Enter를 눌러 편집 모드로 전환하세요. 편집 모드에서는 다음을 수정할 수 있습니다:
스키마 편집기는 효율적인 편집을 위해 완전한 키보드 기반 워크플로를 지원합니다:
| 단축키 | 작업 |
|---|---|
| Arrow Up / Down | 속성 간을 이동합니다(Shift를 누른 채로 선택 범위 확장) |
| Arrow Left / Right | 선택한 객체를 접거나 펼칩니다 |
| Home / End | 첫 번째 또는 마지막 속성으로 이동 |
| Enter | 선택한 속성의 편집 모드 전환 |
| Delete / Backspace | 선택한 속성 제거 |
| Ctrl+A / Cmd+A | 모든 속성 선택 |
| Escape | 편집 모드를 종료하거나 선택을 해제합니다 |
순서를 직접 바꾸려면 Sorted 토글을 꺼야 합니다. 편집기는 기본적으로 속성을 알파벳순으로 나열하며 이 상태에서는 드래그가 비활성화됩니다 — 보기 설정이 조용히 덮어쓸 수 있는 수동 정렬은 큰 의미가 없기 때문입니다. Sorted를 해제하면 스키마 자체의 배열로 전환되고 드래그가 활성화됩니다. 삽입 위치 표시선이 속성이 놓일 자리를 정확히 보여 주며, 그렇게 만들어진 순서는 스키마와 함께 저장됩니다. 전문 영역 그룹 안에서 또는 그룹 간에 드래그해 영역 지정을 변경할 수 있습니다.
전문 분야 그룹화를 활성화하면 속성을 다른 그룹으로 끌어다 놓을 때 해당 전문 분야 할당이 자동으로 업데이트됩니다. 덕분에 대규모 스키마를 직관적으로 재구성할 수 있습니다 — 필드를 “Financial Analyst”에서 “Regulatory Expert”로 드래그하기만 하면 전문 분야가 그에 따라 업데이트됩니다.
속성 트리 아래의 AI 편집 창에서 자연어로 스키마를 수정할 수 있습니다. “parent_company 참조 추가”와 같은 지시를 입력하면 AI가 기존 구조를 유지하면서 변경 사항을 적용합니다.
생성 또는 편집할 때마다 AI가 클릭 가능한 칩으로 표시되는 5가지 개선 제안을 제공합니다. 제안을 클릭하면 편집 입력란이 자동으로 채워지고 적용됩니다. 제안은 데이터 완전성, 품질, 관계, 국제화 및 도메인별 개선 사항을 다룹니다.
AI 스키마 생성 가이드에서 AI 스키마 편집에 대해 자세히 알아보세요.
속성 이름을 상위 객체의 맥락에서 읽어 보세요. 서로 다른 몇 가지를 물을 수 있습니까? 정확히 하나면 명확합니다. 둘 이상이면 해당 속성에 모호함 배지가 붙습니다. 해석이 대부분 겹치고 예외적인 경우에만 갈리면 황색, 실질적으로 다른 데이터가 나오면 빨간색입니다. 배지에 마우스를 올리면 그 이름이 허용하는 경합 해석과, 그중 하나만을 고정하는 다시 쓴 설명을 확인할 수 있습니다. 상위 항목이 답할 것이 전혀 없는 이름도 표시됩니다. 이 경우 툴팁에는 검토했다가 기각된 해석이 나열되며, 해결책은 이름 변경 또는 삭제입니다. 어떤 설명도 엔티티에 없는 속성을 만들어 줄 수는 없기 때문입니다.
도구 모음의 방패 아이콘은 아직 주석이 없는 속성을 분석하며, 모든 항목에 주석이 달리면 전체 재분석으로 전환됩니다. 각 실행은 요금이 청구되는 소규모 AI 호출입니다.
저장된 스키마에서는 배지가 이름 변경이 아니라 다시 쓴 설명을 제안합니다. 스키마가 이미 운영 중이므로 설명에서 의미를 고정하면 데이터 계약이 그대로 유지되기 때문입니다. 이름을 되풀이하기만 하는 설명은 아무것도 더해 주지 않으며, 해당 속성은 설명이 없는 것과 동일하게 평가됩니다.
속성의 이름을 변경하거나 설명을 편집하면 해당 주석이 삭제됩니다 — 판정이 두 가지 모두를 기준으로 내려졌기 때문입니다. 편집기는 이러한 속성을 강조 표시하고 재검사를 제공합니다.
오버플로 메뉴에서 스키마의 검사를 비활성화하세요 — 배지와 경고가 사라지며, 한 번도 분석되지 않은 스키마에서 다시 활성화하면 검사가 자동으로 실행됩니다.
전체 동작 방식, 즉 두 가지 판정, 각 판정의 근거가 되는 해석, 그리고 스키마가 생성되기 전에는 이름 변경이 해결책이지만 활성화된 후에는 설명이 해결책인 이유는 Ambiguity Check 가이드에서 다룹니다.
스키마 선택기를 사용하면 스키마를 생성, 로드, 고정, 복제, 삭제할 수 있습니다. 스키마는 조직별로 저장되며 모든 팀 구성원이 액세스할 수 있습니다.
변경 사항은 2초 정지 후 자동으로 저장되며, 불필요한 쓰기를 방지하기 위해 콘텐츠 해시 중복 제거를 사용합니다.
자주 사용하는 스키마를 고정하여 선택기 목록 상단에 유지하세요.
원본에 영향을 주지 않고 변경을 실험할 수 있도록 schema 사본을 생성합니다.
삭제된 스키마는 복원할 수 있습니다. 영구 삭제는 별도의 작업입니다.