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: ['김 부장', 'Cheolsu Kim'],
});

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}`);
}