Entity 콘텐츠 관리

Entity의 언어별 제목, 요약, 본문과 이미지를 편집하고 Entity 간 연결을 관리합니다. 홈페이지와 AI가 같은 콘텐츠를 참조하게 합니다.

제공 완료 확인

같은 Entity를 참조하는 홈페이지와 AI에서 변경한 내용이 조회되는지 확인합니다. 언어별 내용과 상하위 연결도 확인합니다.

다른 항목과의 구분

고객에게 설명할 사실과 콘텐츠를 관리합니다. AI의 역할과 응답 규칙은 프롬프트 템플릿 관리에서 다룹니다. 콘텐츠 저장이 별도 승인 절차나 버전 복원을 제공한다는 뜻은 아닙니다.

Entity 연결과 참조 범위 정하기

[blocked]

EntityEdge가 표현하는 포함 또는 참조 관계를 관리한다.

시작 조건과 입력

대상 조직과 시험 기록을 확인하세요.

이 작업에 사용할 값

entry_url, organization_id, record_id

커맨드 시퀀스

text

open "$entry_url" && snapshot -i
click "$entity_row" && snapshot -i
get text body
click "$relationship_field" && snapshot -i
click "$entity_option" && snapshot -i
reload && snapshot -i
get text body

open "$entry_url" && snapshot -i
click "$entity_row" && snapshot -i
get text body
click "$relationship_field" && snapshot -i
click "$entity_option" && snapshot -i
reload && snapshot -i
get text body

ref 대상과 확인할 결과

#	커맨드 / ref	대상과 확인 기준
1	`click` `$entity_row`	관계를 편집할 Entity 기록
2	`get text`	출발 Entity ID와 연결할 대상 ID를 읽으세요.
3	`click` `$relationship_field`	편집할 관계 필드
4	`click` `$entity_option`	대상 ID가 일치하는 Entity 항목
5	`reload`	같은 Entity 기록을 다시 읽으세요.
6	`get text`	저장된 관계의 출발과 대상 및 방향을 대조하세요.

결과 확인

원본 기록과 이번에 정한 기준이 일치합니다.

중단 후 다시 시작하기

같은 ID의 원본 값을 다시 읽고 중단한 지점부터 확인하세요.

[blocked]

Entity와 연결의 역할

Entity는 한 항목의 이름과 내용을 저장하고 EntityEdge는 부모와 자식의 연결을 저장합니다. 하나의 항목이 여러 부모 아래에서 사용될 수 있습니다. 같은 사실을 다른 곳에 보여 주려는 이유만으로 Entity를 복사하지 마세요.

[blocked]

연결과 순서 편집

콘텐츠의 하위 항목에서 연결할 자식을 선택하고 순서를 정하세요. 순서는 연결마다 다르므로 같은 자식을 서로 다른 위치에 보여 줄 수 있습니다. 자신으로 되돌아오는 순환 연결은 만들 수 없습니다.

[blocked]

홈페이지와 AI 참조

같은 Entity를 홈페이지 섹션과 AI 참조 범위에서 사용할 때 실제 표시와 답변을 각각 확인하세요. 연결이 있다는 사실만으로 모든 화면이 그 항목을 표시하는 것은 아닙니다. 화면의 참조 설정과 AI의 접근 범위를 함께 확인합니다.

[blocked]

연결의 한계

내용 포함 관계와 상품 구매 조건은 구분하세요. 콘텐츠 연결만 추가했다고 고객에게 제품이 활성화되거나 접근 권한이 부여되지는 않습니다. 연결을 삭제하는 작업과 Entity 자체를 삭제하는 작업도 구분합니다.

Entity 콘텐츠와 번역 수정하기

[blocked]

예약 안내 문구를 예로 들어 콘텐츠를 수정하고, 한국어와 영어의 저장 결과를 확인합니다.

시작 조건과 입력

수정할 Entity를 하나로 특정하고 승인된 언어별 문구를 준비하세요.

이 작업에 사용할 값

entry_url, entity_label, description_ko, description_en

커맨드 시퀀스

text

open "$entry_url" && snapshot -i
click "$entity_row" && snapshot -i
fill "$description_ko_input" "$description_ko" && press 'Tab' && snapshot -i
fill "$description_en_input" "$description_en" && press 'Tab' && snapshot -i
click "$close" && snapshot -i
reload && snapshot -i
click "$entity_row" && snapshot -i
get value "$description_ko_input"
get value "$description_en_input"

open "$entry_url" && snapshot -i
click "$entity_row" && snapshot -i
fill "$description_ko_input" "$description_ko" && press 'Tab' && snapshot -i
fill "$description_en_input" "$description_en" && press 'Tab' && snapshot -i
click "$close" && snapshot -i
reload && snapshot -i
click "$entity_row" && snapshot -i
get value "$description_ko_input"
get value "$description_en_input"

ref 대상과 확인할 결과

#	커맨드 / ref	대상과 확인 기준
1	`click` `$entity_row`	수정할 Entity의 이름이 있는 행
2	`fill` `$description_ko_input`	설명 한국어 입력
3	`press`	한국어 입력에서 포커스를 옮기세요.
4	`fill` `$description_en_input`	설명 영어 입력
5	`press`	영어 입력에서 포커스를 옮기세요.
6	`click` `$close`	닫기 버튼
7	`reload`	같은 Entity 목록을 새로 읽으세요.
8	`click` `$entity_row`	같은 Entity의 이름이 있는 행
9	`get value` `$description_ko_input`	설명 한국어 입력의 값을 예상값과 대조하세요.
10	`get value` `$description_en_input`	설명 영어 입력의 값을 예상값과 대조하세요.

결과 확인

두 언어의 입력값이 각각 저장되어 있습니다. 홈페이지와 AI 반영은 별도 절차에서 확인합니다.

중단 후 다시 시작하기

다시 시작할 때 같은 ID의 현재 값을 읽으세요. 이미 맞게 저장된 설정은 유지하고 다른 값만 수정합니다.

예약 변경 안내가 달라졌다면 홈페이지 문구와 AI가 참고할 정보를 함께 점검해야 합니다. 각각에 다른 문장을 남겨 두면 고객이 어디서 문의하느냐에 따라 서로 다른 안내를 받을 수 있습니다. 같은 안내를 여러 곳에서 사용할 때는 그 내용을 담은 Entity를 찾아 수정합니다.

이 문서는 이미 등록된 Entity의 한국어와 영어 설명을 바꾸는 방법을 안내합니다. 예시에서는 막연하게 적혀 있던 예약 변경 안내에 연락 기한을 덧붙입니다. 아래 문구와 영상 속 조직은 사용법을 보여 주기 위한 시험 자료입니다. 실제 운영 정책은 조직에서 정한 내용을 사용하세요.

수정 전: 예약 변경은 담당자에게 문의하세요.

수정 후: 예약 변경은 방문 전날까지 담당자에게 문의하세요.

수정을 마치면 같은 Entity를 다시 열어 두 언어의 문장이 저장되었는지 확인합니다. 홈페이지 표시와 AI 답변은 그다음에 따로 확인합니다. Entity에 저장되었다는 사실만으로 모든 화면에 같은 내용이 표시되었다고 판단하지 마세요.

[blocked]

수정할 내용을 먼저 정하세요

Entity는 서비스 설명, 운영 시간, 예약 안내처럼 제품에서 함께 참조할 콘텐츠를 담는 항목입니다. 한국어와 영어의 문장은 같은 Entity 안에서 각각 관리합니다. 이 예시처럼 안내의 사실이 바뀌었다면 Entity의 설명을 수정하는 것이 출발점입니다.

AI가 어떤 말투로 답할지, 답을 모를 때 어떻게 행동할지는 프롬프트 템플릿에서 관리합니다. 실제 판매 가격을 바꿀 때는 상품과 옵션의 조건을 수정해야 합니다. Entity에 가격 설명을 적는 것과 구매에 적용되는 가격을 바꾸는 것은 별개의 작업입니다.

수정하기 전에 현재 조직이 맞는지 확인하세요. 같은 안내를 여러 홈페이지 섹션이나 AI에서 사용하는 경우에는 공통으로 적용할 변경인지도 확인해야 합니다. 특정 지점에만 적용되는 정책이라면 공유 중인 설명을 먼저 바꾸지 말고 Entity의 연결 범위를 확인하세요.

이전 문구를 다시 참고할 필요가 있다면 변경 전에 별도로 보관하세요. 콘텐츠 편집 화면에는 이 문서에서 사용할 승인 이력이나 버전 복원 절차가 없습니다.

어떤 필드를 고쳐야 하나요?

콘텐츠 상세에는 이름과 언어별 문구가 함께 있습니다. 안내 문장 하나를 바꾸는 작업이라면 설명만 수정하면 됩니다. 항목을 다시 만들거나 이름까지 바꿀 필요는 없습니다.

화면의 필드	이 작업에서의 용도	예시
이름	콘텐츠 목록에서 항목을 구분할 때 사용합니다.	문서 시험 콘텐츠
레이블	언어별 표시 이름을 관리합니다.	예약 안내 / Booking information
슬로건	짧은 제목이나 강조 문구를 관리합니다.	방문 전에 확인하세요 / Before your visit
설명	고객에게 안내할 내용을 언어별로 관리합니다. 이번에 수정할 필드입니다.	예약 변경 기한과 연락 방법

홈페이지에서는 섹션 설정에 따라 필드를 다르게 표시할 수 있습니다. 설명을 수정했는데 화면의 제목을 바꾸고 싶었던 경우라면, 먼저 그 섹션이 어떤 필드를 사용하는지 확인하세요. 레이블이 없는 경우 이름이 대신 표시되는 화면도 있으므로 이름에 고객에게 보여서는 안 되는 메모를 넣지 마세요.

[blocked]

한국어 설명 수정하기

1. 콘텐츠에서 수정할 항목을 여세요

왼쪽 메뉴에서 콘텐츠를 선택합니다. 목록에서 수정할 Entity의 이름을 찾아 선택하세요. 영상에서는 문서 시험 콘텐츠를 엽니다. 실제 작업에서는 조직이 사용 중인 항목을 선택하면 됩니다.

상세 패널의 이름과 현재 설명을 읽고 수정할 항목이 맞는지 확인하세요. 비슷한 이름의 항목이 여럿이라면 홈페이지나 AI에 연결된 항목인지 먼저 확인해야 합니다. 이름이 같다는 이유로 같은 콘텐츠라고 판단하지 마세요.

2. 설명의 한국어 입력란을 수정하세요

상세 패널에서 설명의 한국어 입력란을 찾습니다. 이 예시에서는 기존 문장을 다음과 같이 바꿉니다.

예약 변경은 방문 전날까지 담당자에게 문의하세요.

기존 설명에 연락처나 다른 안내가 함께 있다면 필요한 부분만 수정하세요. 위 예시를 그대로 붙여 넣어 나머지 내용을 지우지 않도록 주의합니다.

3. 입력란 밖으로 이동해 자동 저장을 마치세요

입력을 마쳤으면 다른 입력란을 클릭하거나 Tab 키를 누르세요. 현재 콘텐츠 편집 화면은 입력란에서 벗어날 때 변경 사항을 자동으로 저장합니다. 별도의 저장 버튼을 찾을 필요는 없습니다.

입력 오류나 저장 실패 메시지가 나타났다면 다음 작업으로 넘어가기 전에 원인을 확인하세요. 오류가 보이지 않더라도 저장 여부는 마지막에 항목을 다시 열어 확인합니다.

[blocked]

영어 설명도 같은 뜻으로 맞추세요

한국어 문장을 고친 다음에는 설명의 영어 입력란을 확인합니다. 한국어와 영어는 각각의 값이므로 두 입력란을 모두 검토하세요. 이 예시의 영어 문장은 다음과 같습니다.

Contact the team by the day before your visit to change a booking.

영어 문장을 입력한 뒤에도 입력란 밖으로 이동해 저장합니다. 영어 안내를 사용하지 않는 조직이라면 이 예시를 위해 운영하지 않는 언어를 추가할 필요는 없습니다.

번역을 검토할 때는 단어보다 고객이 이해할 조건을 비교하세요. 한국어는 “방문 전날까지”인데 영어가 “방문 전에”라면 연락 기한이 달라집니다. 전화번호, 금액, 시간과 고유명사도 각 언어에서 같은 대상을 가리키는지 확인합니다.

실제 화면으로 확인하기

아래 32초 영상은 시험 조직에서 한국어와 영어 설명을 수정한 뒤, 항목을 다시 열어 저장 결과를 확인하는 과정입니다. 영상 없이 진행할 수 있도록 필요한 동작과 확인 방법을 본문에도 적었습니다.

[blocked]

다시 열어 저장 값과 소비 화면 확인하기

같은 Entity를 다시 열어 확인하기

상세 패널의 닫기를 선택하세요. 콘텐츠 목록을 새로 고친 다음, 방금 수정한 항목을 다시 엽니다. 한국어와 영어 설명에 새 문장이 남아 있어야 합니다.

이 예시에서는 한국어에 “방문 전날까지”가, 영어에 “by the day before your visit”가 있는지 확인하면 됩니다. 두 문장이 남아 있으면 Entity의 편집과 저장은 확인한 것입니다. 위 영상도 여기까지 검증합니다.

이 콘텐츠를 사용하는 곳에서 확인하기

홈페이지에 연결된 Entity라면 해당 페이지를 새로 열고 한국어와 영어 화면을 각각 확인하세요. 수정한 문장이 표시되는지, 문장 길이가 달라져 잘리거나 읽기 어려워지지 않았는지 살펴봅니다. 표시할 Entity나 필드가 다르다면 홈페이지 구성과 Entity 연결을 확인하세요.

AI가 참조하는 Entity라면 연결된 시험 채널에서 “예약을 변경하려면 언제까지 연락해야 하나요?”라고 질문합니다. 답변이 새 정책과 일치하는지 확인하세요. 영어 안내도 운영한다면 “What is the deadline for changing my booking?”처럼 같은 뜻의 질문으로 검토합니다.

홈페이지와 AI가 모두 이 Entity를 사용하는 조직이라면 두 곳을 확인해야 검토가 끝납니다. 한쪽만 사용하는 조직은 그쪽만 확인하면 됩니다. 영상은 Entity 저장 과정을 보여 주며, 외부 홈페이지 반영이나 실제 AI 응답까지 확인한 영상은 아닙니다.

결과가 예상과 다를 때

다시 열었는데 이전 문장이 나옵니다

수정했던 항목과 지금 연 항목이 같은지 먼저 확인하세요. 맞는 항목이라면 입력란을 벗어난 뒤 저장 오류가 표시되는지 확인합니다. 해결되지 않으면 현재 조직, 항목 이름, 수정 시각과 오류 문구를 지원 담당자에게 전달하세요. 반복해서 새 Entity를 만들면 어떤 항목을 사용하는지 더 헷갈릴 수 있습니다.

Entity는 바뀌었지만 홈페이지 문구는 그대로입니다

해당 섹션이 같은 Entity의 설명을 사용하는지 확인하세요. 다른 Entity나 슬로건을 표시하는 섹션이라면 설명을 바꿔도 그 문구는 달라지지 않습니다. 연결이 맞는데도 이전 문장이 계속 보이면 확인한 페이지 주소와 언어를 함께 전달하세요.

한국어는 맞는데 영어가 다릅니다

영어 입력란에 새 문장이 저장되었는지 확인한 다음, 홈페이지의 현재 언어를 확인하세요. 번역이 비어 있을 때의 표시 방식은 사용하는 화면에서 확인해야 합니다. 한국어가 정상이라는 사실만으로 영어도 검토를 마친 것은 아닙니다.

AI가 계속 이전 정책으로 답합니다

시험한 계정이 이 Entity를 참조하는지 확인하세요. 프롬프트 템플릿에 이전 정책을 별도로 적어 두었다면 새 Entity 내용과 충돌하는지도 살펴봅니다. 원인을 구분하려면 실제 질문과 답변, 시험 시각을 함께 남겨 주세요.