实体抽取：让文档长出可确认的知识图谱

1. 确认知识库文档已更新（生成分层树 chunk）
2. 进入 /entity-extract，选择目标文档
3. 点"抽取"，任务化返回后每 2 秒轮询 /extract_runs
4. 等待 run.status 到 success，查看实体/关系计数

{
  "code": 0,
  "data": {
    "run": { "id": "<uuid>", "doc_id": "3", "status": "queued", "entities": 0, "relations": 0, "error": "", "created_at": "..." },
    "task": { "id": "<task_id>", "type": "entity_extract", "status": "queued", "created_by": "u1", "created_at": "..." }
  }
}

{
  "code": 0,
  "data": {
    "runs": [
      { "id": "<uuid>", "doc_id": "3", "status": "success", "entities": 5, "relations": 3, "error": "", "created_at": "...", "finished_at": "..." }
    ],
    "total": 1
  }
}

1. GET /entities?doc_id=3&status=auto 拉待确认实体
2. 确认 销售额 / 订单金额：POST /entities/<id>/confirm
3. 拒绝 金额1000：POST /entities/<id>/reject
4. 再次点抽取，验证人审结论保留、计数只统计新增

// POST /entities/<id>/confirm
{ "code": 0, "data": { "id": "<uuid>", "doc_id": "3", "name": "销售额", "type": "metric", "status": "confirmed", "confidence": 0.9, "uri": "doc://aip/3?chunk=1" } }

// POST /entities/<id>/reject
{ "code": 0, "data": { "id": "<uuid>", "doc_id": "3", "name": "金额1000", "type": "other", "status": "rejected", "confidence": 0.6 } }

1. 前置：在 /entity-extract 完成抽取并确认 sales_amount 实体
2. 在 /chat 输入含实体名/别名的问题并回车
3. 查看响应 rag_channels_used 是否含 entity
4. 或 POST /rag/retrieve 直接验证实体通道命中

{
  "intent": "data_query",
  "confidence": 0.8,
  "rag_channels_used": ["metadata", "knowledge", "entity"],
  "sql_query": "SELECT c.customer_name, SUM(o.sales_amount) FROM orders o JOIN customers c ON o.customer_id = c.customer_id WHERE c.city = '华东区' GROUP BY c.customer_name",
  "sql_explanation": "按销售额口径统计华东区客户的销售金额"
}

实体: sales_amount（类型: metric） 别名: Sales Amount/Sales
属性: {"口径":"订单实付金额"}
上下文: 本月销售额=订单金额-退款金额，指已成交订单的实付金额
来源: doc://aip/3?chunk=2

1. 在 /entity-extract 左侧选择目标文档
2. GET /knowledge/documents/:id/graph 取图数据
3. 前端 ECharts 力导向图渲染节点与边
4. 拖拽浏览，hover 节点看溯源 URI，点击回文档核对原文

{
  "code": 0,
  "data": {
    "nodes": [
      { "id": "<ent_id>", "label": "销售额", "type": "metric", "status": "confirmed" },
      { "id": "<ent_id>", "label": "订单金额", "type": "metric", "status": "confirmed" },
      { "id": "txt_<md5[:12]>", "label": "订单金额-退款金额…", "type": "text" }
    ],
    "edges": [
      { "source": "<ent_id>", "target": "txt_<md5[:12]>", "label": "等于", "confidence": 0.9 }
    ]
  }
}