1. lkm-openapi
literature-sage
  • lkm-openapi
    • 搜索知识:对科学命题/研究问题等进行召回
      POST
    • 搜索推理链:对文献推理过程进行召回
      POST
    • 查询论文对应的完整知识图谱
      POST
    • 查询命题对应的推理链
      GET
    • 批量查询:按知识节点 ID 列表取详情
      POST
    • 问题反馈
      POST
  1. lkm-openapi

查询命题对应的推理链

GET
/claims/{id}/reasoning
这个接口用于查询单条 claim 的支撑推理链。给定一个 claim global ID,返回这条 claim 为什么成立、由哪些推理步骤和前提支撑。适合在搜索结果、论文图谱或 Agent 分析中,对某条结论继续查看“为什么这么说”。
如果还没有 claim ID,需要先从其他接口拿到。按关键词或语义找 claim:先用 /search。按相似推理过程找 claim:先用 /reasoning/search。按论文查看完整 paper-level graph:用 /papers/graph。
新调用方建议统一传 format: "graph"。graph 结构更适合前端可视化、Agent 消费和跨接口对齐。不建议新客户端继续依赖旧的 factors 响应结构。

claim ID 怎么拿#

本接口 path 里的 id 是 LKM 的全局 claim ID。
ID 通常形如 gcn_654cd35dcb814a0c。
可以从 /search 返回的 data.variables[].id 获取。
也可以从 /reasoning/search?format=graph 或 /papers/graph 返回的 conclusion 节点里获取 global_id。
不要传 graph 节点本地 ID。
例如 paper:812382516051705856::conclusion_3 是图内部节点 ID,不是本接口需要的 claim ID。
把这类 ID 直接传给本接口,通常会返回 290004 claim not found。
建议只对有推理链的 conclusion 调用。
优先选择 role = conclusion 且 has_reasoning = true 的 claim。
如果对 premise、weak point 或没有推理链的 claim 调用,可能返回 290008。

format 怎么用#

推荐传 format: "graph"。
返回 data.reasoning_chains[].graph.nodes 和 graph.edges。
结构与 /reasoning/search?format=graph、/papers/graph 更一致。
论文元数据在每条 reasoning chain 的 paper 字段里,不依赖顶层 data.papers。
不传 format,或传非 graph 值,会返回旧结构。
链内主要是 factors 和 motivating_questions。
旧结构只建议历史客户端继续使用。
新调用方建议统一迁移到 format: "graph"。

响应怎么看#

先看业务码。
HTTP 状态通常是 200,业务是否成功看响应体里的 code。
code = 0 表示找到 claim,并且返回了推理链。
再看顶层数据。
data.claim 是被查询的 claim 本身。
data.total_chains 是该 claim 可返回的推理链总数。
data.reasoning_chains 是推理链列表,数量受 max_chains 限制。
format: "graph" 下,每条 reasoning chain 通常包含以下字段。
paper:这条推理链所属论文的元数据。
graph:推理链图谱,包含 nodes 和 edges。
addressed_problems:论文或该链试图回答的问题背景。
open_questions:论文留下的开放问题或未来工作。
source_package:来源论文包标识,通常形如 paper:<数字>。
graph 是主要消费对象。
graph.nodes 是推理链中的节点。
graph.edges 是节点之间的关系边。

graph 节点和边#

常见节点类型。
kind: "conclusion" 表示被解释的结论节点,通常对应传入的 claim。
kind: "reasoning_steps" 表示支撑结论的推理步骤,通常包含 steps 数组。
kind: "highlight" 表示正向亮点、关键证据或支持性观察。
kind: "weak_point" 表示弱点、限制、风险或需要审慎看待的前提。
kind: "subproblem" 表示驱动该结论的子问题或研究动机。
常见边类型。
type: "concludes" 通常表示 reasoning_steps 节点指向 conclusion。
type: "highlight_of" 表示某个 highlight 是某个 reasoning_steps 的正向亮点或支持性观察。
type: "weakpoint_of" 表示某个 weak point 指向它所约束或削弱的 reasoning_steps。
type: "subproblem_of" 表示某个 subproblem 指向它驱动的 conclusion。
type: "previous_conclusion_of" 表示前序结论与当前结论或推理单元之间的上下文/前置关系。
注意不要误读内部参数。
edge 上可能有 p1、p2 等数值字段。
这些是模型/图谱内部参数,不要直接当作用户侧可信度展示。

常见错误#

没有推理链:290008。
表示 claim 存在,但没有 supporting reasoning。
返回时 data.claim 仍可能存在,data.reasoning_chains 通常为空。
常见于 premise、weak point、普通 claim,或搜索结果里 has_reasoning = false 的 claim。
ID 不存在:290004。
表示 claim 不存在。
常见原因是传错 ID 类型,例如把 paper:...::conclusion_... 当成 claim ID。
本接口应传 gcn_... 这种全局 claim ID。
参数错误:290002。
表示入参错误。
常见原因是 sort_by 非法;目前只支持 comprehensive 和 recent。
查询超时:290009。
表示查询超时,可以稍后重试。
查询异常:290001。
表示其他查询错误,可以重试一次。
如果仍失败,建议检查 claim ID 来源。
鉴权错误:2000。
表示未授权,通常是请求头缺少有效 accessKey。

使用建议#

搜索页或列表页。
优先只给 has_reasoning = true 的 conclusion 提供“查看推理链”入口。
对没有推理链的 claim,可以隐藏入口或展示“暂无推理链”。
详情页或 Agent 流程。
推荐统一传 format: "graph"。
前端图谱展示直接消费 graph.nodes 和 graph.edges。
Agent 或后处理流程优先读取 claim、reasoning_chains[].graph、paper、addressed_problems、open_questions。
渲染和解释时注意语义。
reasoning_steps.steps 建议作为 reasoning_steps 节点详情展示,不需要默认拆成多个主图节点。
不要把所有边都理解成“支持”;highlight_of 是正向信息,weakpoint_of 是限制或风险,subproblem_of 是问题背景。
不要把 p1、p2 当作用户侧可信度直接展示。

请求参数

Path 参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://open.bohrium.com/openapi/v1/lkm/claims//reasoning?max_chains=undefined&sort_by=undefined&format=graph' \
--header 'accessKey;' \
--header 'Authorization: Bearer 5cc6462133d64251bf6ab64815c0e9xx'

返回响应

🟢200
application/json
业务错误,按响应体 code / msg 分类
Bodyapplication/json

示例
{
    "code": 0,
    "data": {
        "claim": {
            "id": "gcn_73e13bb548f847bd",
            "type": "claim",
            "content_hash": "f48701b3a133906ec509f04a7bf5ec204fcbde8ab6e5707884666944c0cbf62b"
        },
        "reasoning_chains": [
            {
                "source_package": "paper:811072288316194817",
                "paper": {
                    "id": "811072288316194817",
                    "doi": "10.1107/s0108270189005913",
                    "publication_id": "13682",
                    "publication_name": "Acta Crystallographica Section C Crystal Structure Communications _ Acta Crystallogr C",
                    "zh_title": "含二价金属阳离子的 Chevrel 相中的结构相变。II. 低温下三斜晶系 EuMo₆S₈ 和 BaMo₆S₈ 的结构精修",
                    "en_title": "Structural phase transitions in Chevrel phases containing divalent metal cations. II. Structure refinement of triclinic EuMo6S8 and BaMo6S8 at low temperature",
                    "authors": "F. Kubel | K. Yvon",
                    "publication_date": "1990-2-15",
                    "available_online": "",
                    "cover_date_start": "1990-02-15",
                    "area": "Geoscience",
                    "research_categories": "",
                    "keywords": "",
                    "created_at": "2022-12-17T19:11:44+08:00"
                },
                "addressed_problems": [
                    {
                        "id": "paper:811072288316194817::problem",
                        "global_id": "gcn_ef0207f7ee444015",
                        "content": "In divalent-cation Chevrel phase sulfides $MMo_{6}S_{8}$ with $M = \\mathrm{Eu}$ or $\\mathrm{Ba}$, the low-temperature rhombohedral-to-triclinic phase transition had been recognized, but the triclinic structures themselves were not yet established by single-crystal refinement. At the time of this work, room-temperature rhombohedral parameters were available from earlier single-crystal and powder studies, whereas the low-temperature triclinic structures had only been reported from powder diffraction. That left the atomic-level geometry of the distorted $Mo_{6}$ clusters, the associated changes in $Mo$--$Mo$, $Mo$--$S$, $M$--$S$, and $S$--$S$ distances, and the magnitude of the lattice discontinuity at the transition insufficiently resolved. Because these compounds show structural phase transitions linked to electronic behavior, the lack of accurate low-temperature single-crystal data limited quantitative assessment of how small structural distortions relate to the transition, to the metallic-to-nonmetallic change in $\\mathrm{EuMo}_{6}S_{8}$, and to the structural mechanism possibly involved in pressure-induced superconductivity. The situation was further complicated by experimental difficulties at low temperature: some crystals split during the transition, and earlier powder measurements showed discrepancies that were plausibly caused by stoichiometric differences, leaving the true structural changes uncertain.",
                        "keywords": [
                            "Chevrel phase sulfides",
                            "low-temperature structural transition",
                            "single-crystal refinement",
                            "triclinic distortion",
                            "atomic-level bond changes"
                        ],
                        "metadata": {
                            "keywords": [
                                "Chevrel phase sulfides",
                                "low-temperature structural transition",
                                "single-crystal refinement",
                                "triclinic distortion",
                                "atomic-level bond changes"
                            ]
                        }
                    }
                ],
                "open_questions": [
                    {
                        "id": "paper:811072288316194817::open_question",
                        "global_id": "gcn_264c1bf8027141cf",
                        "content": "Several scientifically meaningful issues remain unresolved after these refinements. The low-temperature deformation interval appears broader in $\\mathrm{BaMo}_{6}S_{8}$ than in $\\mathrm{EuMo}_{6}S_{8}$, but the authors note that this comparison may not be genuine because the europium data come from a single crystal whereas the barium data come from powder measurements, so the relative breadth of the triclinic deformation as a function of temperature is not fully settled. The discrepancy between the present low-temperature lattice parameters and earlier powder-diffraction values for $\\mathrm{EuMo}_{6}S_{8}$ and $\\mathrm{BaMo}_{6}S_{8}$ is attributed to possible stoichiometric differences, but the paper does not determine the exact compositional origin of those differences. Attempts to refine the triclinic low-temperature structures of $\\mathrm{CaMo}_{6}S_{8}$ and $\\mathrm{SrMo}_{6}S_{8}$ failed because the crystals broke up during the phase transition, leaving the low-temperature structures of these related compounds unresolved. Finally, although the structural changes are argued to be sufficient to explain the electronic transition in $\\mathrm{EuMo}_{6}S_{8}$ and are likely connected to pressure-induced superconductivity, the paper does not provide a direct electronic-structure calculation or experimental proof of the superconducting mechanism under pressure."
                    }
                ],
                "graph": {
                    "nodes": [
                        {
                            "id": "paper:811072288316194817::conclusion_8_subproblem",
                            "type": "question",
                            "kind": "subproblem",
                            "content": "The relation between pressure, structural stability, and superconductivity in the europium compound remained unresolved because the low-temperature phase transition itself had to be characterized before any mechanism could be proposed. Earlier observations showed superconductivity under pressure, but the structural route by which pressure might favor that state was not established. A structural refinement that quantifies the low-temperature distortion was therefore needed to support an interpretation in which suppressing the transition enables superconductivity.",
                            "global_id": "gcn_806326daa86749bb"
                        },
                        {
                            "id": "paper:811072288316194817::conclusion_8",
                            "type": "claim",
                            "kind": "conclusion",
                            "title": "Literature-based inference linking superconductivity under pressure to suppressed transition",
                            "content": "Literature reports of superconductivity in EuMo6S8 under applied pressure (for example Chu et al., 1981; Harrison et al., 1981) together with the documented pressure dependence of the lattice-transformation temperature suggest that the emergence of superconductivity under pressure is likely associated with suppression of the rhombohedral-to-triclinic structural phase transition.",
                            "order": 8,
                            "global_id": "gcn_73e13bb548f847bd",
                            "metadata": {
                                "keywords": [
                                    "pressure-induced superconductivity",
                                    "structural transition suppression",
                                    "EuMo6S8",
                                    "phase transition mechanism",
                                    "electronic state"
                                ],
                                "narrative": "Conclusion 8 — that pressure-induced superconductivity in EuMo6S8 is likely connected to suppression of the structural transition — is explicitly speculative in the paper: it is consistent with the known pressure dependence of Tl and with literature reports of superconductivity (cited), but the authors present no direct high-pressure structural or concurrent transport data to establish causality (P7). Consequently the claim is a plausible conjecture meriting follow-up, not a conclusion established by the present refinements."
                            },
                            "priors": [
                                {
                                    "id": "gcn_73e13bb548f847bd::extract_paper_811072288316194817",
                                    "value": 0.3,
                                    "source_id": "extract_paper_811072288316194817",
                                    "created_at": "2026-05-19T02:35:15.256172+00:00"
                                }
                            ]
                        },
                        {
                            "id": "paper:811072288316194817::P7",
                            "type": "claim",
                            "kind": "weak_point",
                            "title": "Linking pressure-induced superconductivity to suppressed transition lacks direct evidence here",
                            "content": "The inference that superconductivity observed in EuMo6S8 under applied pressure is likely due to suppression of the rhombohedral-to-triclinic structural phase transition is based on the known pressure dependence of the lattice-transformation temperature and on literature reports of pressure-induced superconductivity, but this study does not present any pressure-dependent structural measurements (for example unit-cell parameters or phase identification under pressure) or concurrent electronic measurements that would directly demonstrate that suppression of the triclinic distortion produces the superconducting state.\n      Chu, C. W. et al. (1981). Phys. Rev. Lett. 46, 276-279.",
                            "global_id": "gcn_ab7a8eded1034563",
                            "metadata": {
                                "failure_mode": "If direct evidence that pressure suppresses the triclinic distortion prior to the onset of superconductivity is absent or the two phenomena are not causally linked in the present samples (i.e., the body claim fails), then conclusion 8 becomes speculative: the association between pressure-driven suppression of the transition and superconductivity would be an unproven hypothesis rather than a supported mechanism, reducing the conclusion to a plausible suggestion that requires dedicated high-pressure structural-electronic studies.",
                                "refs": [
                                    {
                                        "text": "Chu, C. W. et al. (1981). Phys. Rev. Lett. 46, 276-279.",
                                        "type": "citation"
                                    }
                                ],
                                "weak_types": [
                                    "causal",
                                    "external"
                                ],
                                "weakness_reason": "The paper cites prior observations of superconductivity under pressure and notes that Tl is pressure-dependent, but invoking that suppression of the structural transition as the operative mechanism requires either concurrent high-pressure structural and transport measurements or theoretical work linking the structural degree of freedom to the superconducting pairing; neither is supplied here, so the causal chain remains hypothetical."
                            },
                            "priors": [
                                {
                                    "id": "gcn_ab7a8eded1034563::extract_paper_811072288316194817",
                                    "value": 0.2,
                                    "source_id": "extract_paper_811072288316194817",
                                    "created_at": "2026-05-19T02:35:15.256072+00:00"
                                }
                            ]
                        },
                        {
                            "id": "lfac_ce735ddf60705845",
                            "type": "factor",
                            "kind": "reasoning_steps",
                            "subtype": "noisy_and",
                            "global_id": "gfac_5f0e934a9c9f40b0",
                            "steps": [
                                {
                                    "reasoning": "The structural transition in $\\mathrm{EuMo}_{6}S_{8}$ is the key low-temperature instability, and the refined structure shows that the low-temperature distortion is small enough to account for the electronic change. This establishes that suppression of the structural transition is a plausible way to alter the electronic state.",
                                    "step_id": "1"
                                },
                                {
                                    "reasoning": "Earlier observations showed superconductivity in $\\mathrm{EuMo}_{6}S_{8}$ under pressure, but the mechanism linking pressure to that superconductivity was not established without knowing how pressure affects the structural transition.",
                                    "step_id": "2"
                                },
                                {
                                    "reasoning": "If pressure suppresses the rhombohedral-to-triclinic phase transition, then the low-temperature structural distortion that is associated with the non-metallic state would be avoided. The paper uses this structural logic to interpret the appearance of superconductivity under pressure.",
                                    "step_id": "3"
                                },
                                {
                                    "reasoning": "Thus the appearance of superconductivity in $\\mathrm{EuMo}_{6}S_{8}$ under pressure is likely due to suppression of the rhombohedral-to-triclinic structural phase transition.",
                                    "step_id": "4"
                                }
                            ]
                        }
                    ],
                    "edges": [
                        {
                            "type": "subproblem_of",
                            "source": "paper:811072288316194817::conclusion_8_subproblem",
                            "target": "paper:811072288316194817::conclusion_8"
                        },
                        {
                            "type": "weakpoint_of",
                            "source": "paper:811072288316194817::P7",
                            "target": "lfac_ce735ddf60705845",
                            "p1": 0.2,
                            "p2": 0.1
                        },
                        {
                            "type": "concludes",
                            "source": "lfac_ce735ddf60705845",
                            "target": "paper:811072288316194817::conclusion_8"
                        }
                    ]
                }
            }
        ],
        "total_chains": 1
    }
}
修改于 2026-06-18 08:23:29
上一页
查询论文对应的完整知识图谱
下一页
批量查询:按知识节点 ID 列表取详情
Built with