メインコンテンツへスキップ

​
概要

エンティティは、プロジェクトのコンテンツから自動的に抽出される固有名詞（人物、企業、製品、場所など）を表します。各エンティティは一意に識別されるレコードであり、すべてのデータタイプにまたがる関連情報を結びつけます。構造化されたエンティティ管理の重要性についてはコンセプト概要をご覧ください。

​
フィールド

フィールド型説明
idstring一意の識別子
namestringエンティティの主要名称
typeEntityTypeエンティティタイプの分類
aliasesstring[]別名・表記揺れ
metadataobject追加のメタデータ
createdAtstring作成日時（ISO 8601）
updatedAtstring最終更新日時（ISO 8601）

​
エンティティタイプ

タイプ説明例
person人物山田太郎、John Smith
company企業・組織株式会社ABC、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ファンド -> スタートアップ

​
エイリアス（別名）

同じエンティティに対する複数の名称はエイリアスとして管理されます。エイリアスは自動学習されるほか、手動で追加することも可能です。 
エンティティ: 山田太郎
├── エイリアス: 山田さん
├── エイリアス: Taro Yamada
└── エイリアス: 太郎
すべてのエイリアスは検索時にマッチするため、「山田さん」で検索しても「山田太郎」と同じエンティティが見つかります。

​
未解決のメンション

自動抽出の信頼度が低い場合、即座にリンクされず未解決のメンションとして保留されます。以下のいずれかの方法で解決できます。
  • 既存のエンティティにリンク — 既存のエンティティにメンションを関連付ける
  • 新しいエンティティとして作成 — 新規エンティティとして登録する
  • 無視 — メンションを却下する
これにより、誤った自動マッチングを防ぎながらデータの品質を維持できます。

​
重複検出とマージ

類似したエンティティ（例: 「株式会社ABC」と「ABC株式会社」）は自動的に検出されます。2つのエンティティをマージすると：
  • すべてのKnowledgeリンクが移行される
  • すべてのEpisodeリンクが移行される
  • すべての関係が保持される
  • エイリアスが統合される

​
関連ページ

エンティティの概要

コンセプト概要とユースケース

Entities API

SDKでエンティティを管理する