본문으로 건너뛰기

값 사전

AI → 시맨틱 레이어 → 값 사전에서 여러 표면형을 하나의 정규값에 연결합니다. 기존 사전은 100개씩 페이지로 나뉘므로 페이지를 이동하기 전에 현재 변경을 저장합니다.

기본 정보와 정규값·표시 라벨·동의어 그리드가 표시된 값 사전 편집기

항목 편집과 저장 경계​

  • 정규값 name과 표시 라벨 label을 입력하고 동의어를 추가합니다.
  • 각 행의 수정일에서 마지막 저장 날짜를 확인합니다. 포인터를 올리면 생성 시각과 수정 시각을 함께 표시합니다.
  • 정규값 이름은 사전 안에서 고유해야 합니다. 중복하면 저장할 수 없습니다.
  • 서로 다른 정규값이 같은 동의어를 가지면 모호성 경고가 나타납니다. 경고는 정규값 이름 중복 오류와 달리 저장을 막지 않습니다.
  • 구조화 그리드와 JSON 모드를 전환할 수 있습니다. JSON 항목은 name, label, synonyms 구조를 사용합니다.

기존 항목은 페이지당 100개씩 불러옵니다. 저장하지 않은 변경이 있으면 검색·페이지 이동과 리소스 이름·설명 저장을 진행할 수 없습니다. 먼저 현재 페이지 저장을 누릅니다.

현재 페이지에서 여러 행을 선택하고 선택 N건 삭제를 누르면 해당 항목을 편집 초안에서 제거합니다. 삭제 결과를 확정하려면 현재 페이지 저장을 눌러야 합니다.

스크린샷 TODO

영역: 값 사전 항목의 선택 체크박스, 선택 N건 삭제, 수정일 열, 값 가져오기·값 내보내기가 함께 보이는 화면.

값 링킹 미리보기​

미리보기에 표면형을 입력하면 일치하는 정규값 후보를 확인합니다. 이 결과는 사전의 문자열 연결만 보여 주며 실제 실행에서 LLM이 선택할 값을 재현하지 않습니다. 저장하거나 색인한 직후에는 새 값이 반영되기까지 시간이 걸릴 수 있습니다.

AI로 동의어 생성​

각 항목에서 AI로 동의어 생성을 실행할 수 있습니다. 동의어가 비어 있는 여러 항목을 선택해 일괄 생성할 수도 있습니다. 생성 결과를 저장하기 전에 중복과 모호한 표면형을 검토합니다.

원시 값 가져오기​

CSV, TSV, TXT, JSON 파일이나 붙여넣은 값을 분석해 사전 초안을 만듭니다.

  • 파일 하나는 최대 50MB입니다.
  • 단일 값 목록, 정규값·라벨 쌍, 이미 분류된 구조를 자동 판별합니다.
  • 값 내보내기로 받은 name, label, synonyms CSV도 다시 읽습니다.
  • 고유 정규값이 500개를 넘으면 높은 카디널리티 경고를 표시합니다.
  • AI 카테고리 분류에는 최대 200개 정규값 표본을 사용합니다.

기존 사전에 반영하기​

방식결과
추가기존 항목을 유지하고 가져온 항목을 더합니다. 같은 정규값은 동의어 병합 / 건너뛰기 중에서 선택합니다.
교체기존 전체 항목을 삭제하고 가져온 항목으로 바꿉니다.

서버 페이지 방식의 기존 사전에서는 미리보기가 현재 페이지와 비교되어도 중복 정책과 교체는 전체 사전에 적용됩니다.

값 CSV로 백업하고 되돌리기​

목록 행의 값 내보내기는 현재 페이지만이 아니라 사전의 전체 항목을 CSV로 저장합니다. 첫 행에는 name, label, synonyms 컬럼이 있으며 동의어는 JSON 배열 문자열로 기록됩니다.

내보낸 CSV를 같은 사전의 값 가져오기에 넣고 교체를 선택하면 전체 항목을 해당 파일 내용으로 되돌립니다. 먼저 미리보기의 항목 수와 중복 경고를 확인합니다.

교체는 전체 사전에 적용됩니다

현재 화면의 100개 항목만 바꾸는 작업이 아닙니다. 기존 전체 항목을 버려도 되는지 확인한 뒤 실행합니다.

자산 정의 가져오기와 다릅니다

이 절차는 값 사전 안의 원시 값을 편집합니다. 값 사전 자산 전체를 JSON으로 옮기려면 가져오기·내보내기를 사용합니다.