Entities API

const client = new NdxClient({
  apiKey: process.env.NEURADEX_API_KEY,
  projectId: 'your-project-id',
});

// Entities APIにアクセス
const entities = await client.entities.list();
const entity = await client.entities.create({
  canonicalName: '山田太郎',
  type: 'person',
});

// 全エンティティを取得
const result = await client.entities.list();
console.log(`エンティティ数: ${result.total}`);

// 人物のみ
const people = await client.entities.list({ type: 'person' });

// 検索
const results = await client.entities.list({ search: '山田' });

const entity = await client.entities.get('entity-id');

console.log(`名前: ${entity.canonicalName}`);
console.log(`タイプ: ${entity.type}`);
console.log(`エイリアス: ${entity.aliases.map(a => a.alias).join(', ')}`);

const entity = await client.entities.create({
  canonicalName: '山田太郎',
  type: 'person',
  aliases: ['山田さん', 'Taro Yamada'],
});

console.log(`作成: ${entity.id}`);

const updated = await client.entities.update('entity-id', {
  canonicalName: '山田太郎（部長）',
});

await client.entities.delete('entity-id');

const alias = await client.entities.addAlias('entity-id', '太郎');

await client.entities.removeAlias('entity-id', 'alias-id');

const relations = await client.entities.getRelations('entity-id');

// 発信（このエンティティから他へ）
for (const rel of relations.outgoing) {
  console.log(`${rel.relationType} → ${rel.targetEntity.canonicalName}`);
}

// 受信（他からこのエンティティへ）
for (const rel of relations.incoming) {
  console.log(`${rel.sourceEntity.canonicalName} → ${rel.relationType}`);
}

const relation = await client.entities.addRelation(
  'person-entity-id',
  'company-entity-id',
  'works_for'
);

const result = await client.entities.getKnowledges('entity-id');

for (const k of result.knowledges) {
  console.log(`${k.knowledgeTitle}: "${k.mentionText}"`);
}

const result = await client.entities.getTopics('entity-id');

for (const t of result.topics) {
  console.log(`${t.topicTitle}: "${t.mentionText}"`);
}

const result = await client.entities.getEpisodes('entity-id');

for (const e of result.episodes) {
  console.log(`"${e.mentionText}" in episode`);
}

const pairs = await client.entities.findSimilar();

for (const pair of pairs) {
  console.log(`類似: ${pair.entity1.canonicalName} ↔ ${pair.entity2.canonicalName}`);
  console.log(`スコア: ${pair.similarity}`);
}

const result = await client.entities.merge({
  keepEntityId: 'entity-1',
  mergeEntityId: 'entity-2',
});

console.log(`マージ完了:`);
console.log(`- エイリアス: ${result.mergedAliases}件`);
console.log(`- Knowledge: ${result.migratedKnowledges}件`);
console.log(`- Episode: ${result.migratedEpisodes}件`);

const graph = await client.entities.getGraph();

console.log(`ノード数: ${graph.nodes.length}`);
console.log(`エッジ数: ${graph.edges.length}`);

// ノード
for (const node of graph.nodes) {
  console.log(`${node.canonicalName} (${node.type})`);
}

// エッジ
for (const edge of graph.edges) {
  console.log(`${edge.source} --${edge.relationType}--> ${edge.target}`);
}