get_provenance

获取查询结果的数据血缘（来源文档）。

适用于：事实核查、引用标注、追溯信息来源。

输入 Schema

用途

取数据血缘溯源：某个查询结果 / 某个实体的属性，来自哪份文档的哪个片段。用于审计、合规、可信度验证。

调用示例

Claude Desktop 中说："graphforge 里 '准交率' 这个定义是从哪份文档来的？"

JSON-RPC payload：

{
  "method": "tools/call",
  "params": {
    "name": "get_provenance",
    "arguments": {
      "input": "准交率"
    }
  }
}

返回示例

{
  "entity": "准交率",
  "provenance": [
    {
      "doc_id": "doc_2024_scor_guide",
      "doc_title": "2024 供应链 SCOR 指标手册.pdf",
      "chunk_id": "ch_087",
      "extracted_at": "2024-12-15T10:23:11Z",
      "context": "...准交率 (OTD) 是衡量供应链交付绩效的核心 KPI..."
    }
  ]
}

何时用

• 用户问"这个数据从哪来的"
• 合规审计需要溯源凭证
• 验证 LLM 抽取的实体定义是否准确（点 context 看原文）

注意

仅返回最近一次抽取的来源。如果一个实体被多次抽取（不同文档），返回 N 条。

context 是原文 chunk 截取，不是完整文档。完整文档下载需走 REST /api/documents/{doc_id}。