메인 콘텐츠로 건너뛰기

​
개요

엔티티는 프로젝트의 콘텐츠에서 자동으로 추출되는 고유명사(인물, 기업, 제품, 장소 등)를 나타냅니다. 각 엔티티는 고유하게 식별되는 레코드로, 모든 데이터 타입에 걸쳐 관련 정보를 연결합니다. 구조화된 엔티티 관리의 중요성에 대해서는 컨셉 개요를 참조하세요.

​
필드

필드타입설명
idstring고유 식별자
namestring엔티티의 주요 명칭
typeEntityType엔티티 타입 분류
aliasesstring[]별칭 / 표기 변형
metadataobject추가 메타데이터
createdAtstring생성 일시 (ISO 8601)
updatedAtstring최종 수정 일시 (ISO 8601)

​
엔티티 타입

타입설명예시
person인물김철수, John Smith
company기업 / 조직삼성전자, Google
product제품 / 서비스iPhone, Slack
place장소서울, Silicon Valley
other기타프로젝트명 등

​
엔티티 간 관계

엔티티 간에 타입이 지정된 관계를 정의할 수 있습니다. 관계 타입의 전체 목록은 다음과 같습니다.
관계설명예시
CEO_OF~의 CEO김철수 -> ABC 주식회사
CTO_OF~의 CTO이영희 -> ABC 주식회사
CFO_OF~의 CFO박민수 -> ABC 주식회사
FOUNDER_OF~의 창업자김철수 -> ABC 주식회사
MEMBER_OF~의 멤버정수진 -> 엔지니어링 팀
WORKS_AT~에 근무정수진 -> ABC 주식회사
PARENT_COMPANY_OF~의 모회사XYZ 홀딩스 -> ABC 주식회사
SUBSIDIARY_OF~의 자회사ABC 주식회사 -> XYZ 홀딩스
LOCATED_IN~에 소재ABC 주식회사 -> 서울
PARTNER_OF~의 파트너ABC 주식회사 -> Beta Inc
COMPETITOR_OF~의 경쟁사ABC 주식회사 -> 라이벌 주식회사
ACQUIRED_BY~에 인수됨스타트업 -> 대기업
INVESTED_IN~에 투자VC 펀드 -> 스타트업

​
별칭 (Alias)

같은 엔티티에 대한 여러 명칭은 별칭으로 관리됩니다. 별칭은 자동 학습되며, 수동으로 추가할 수도 있습니다. 
엔티티: 김철수
├── 별칭: 김 부장
├── 별칭: Cheolsu Kim
└── 별칭: 철수
모든 별칭은 검색 시 매칭되므로, “김 부장”으로 검색해도 “김철수”와 동일한 엔티티를 찾을 수 있습니다.

​
미해결 멘션

자동 추출의 신뢰도가 낮은 경우, 즉시 링크되지 않고 미해결 멘션으로 보류됩니다. 다음 중 하나의 방법으로 해결할 수 있습니다.
  • 기존 엔티티에 링크 — 이미 존재하는 엔티티에 멘션을 연결
  • 새로운 엔티티로 생성 — 새 엔티티로 등록
  • 무시 — 멘션을 무시
이를 통해 잘못된 자동 매칭을 방지하면서 데이터 품질을 유지할 수 있습니다.

​
중복 감지 및 병합

유사한 엔티티(예: “ABC 주식회사”와 “주식회사 ABC”)는 자동으로 감지됩니다. 두 엔티티를 병합하면:
  • 모든 Knowledge 링크가 이전됨
  • 모든 Episode 링크가 이전됨
  • 모든 관계가 보존됨
  • 별칭이 통합됨

​
관련 페이지

엔티티 개요

컨셉 개요 및 유스케이스

Entities API

SDK로 엔티티 관리하기