エンティティ(ノード)
エンティティは名前付きの概念を表します:人物、プロジェクト、技術、組織などです。search_graph によるセマンティック検索のためにベクトルとして埋め込まれます。
エッジ(リレーションシップ)
エッジは2つのエンティティを型付きリレーションシップとオプションのファクトで接続します。双時相モデル
エッジは双時相追跡をサポートします:| フィールド | 用途 |
|---|---|
validAt | 現実世界でファクトが真になった時点 |
invalidAt | ファクトが真でなくなった時点 |
expiredAt | システム内でエッジが置き換えられた時点 |
ファクトの更新
ファクトが変更された場合、update_edge は履歴を保持します:
- 古いエッジが無効化される(
expiredAtとinvalidAtが設定される) - 更新されたファクトと新しい
validAtで新しいエッジが作成される
無効化
代替なくリレーションシップが終了した場合はinvalidate_edge を使用します:
グラフ探索
search_graph は2つの検索戦略を組み合わせます:
- ベクトル検索 — セマンティック類似度で関連するノードとエッジを検索
- グラフ探索 — ヒットしたノードから N ホップ歩いて接続されたエンティティを発見
traverseDepth パラメータで探索の深さを制御します:
| 値 | 動作 |
|---|---|
0 | ベクトル検索のみ、探索なし |
1 | ヒットしたノードの直接の隣接ノードを含む |
2 | 隣接ノードの隣接ノードまで含む |