用途:在固定的 PrimeKG(精准医学知识图谱)CSV 上复现分析、解析特定图谱产物中的实体,并探索已记录的基因、药物、疾病、表型、解剖与通路关联。路径仅支持研究假设,不构成因果、疗效、处方或诊断结论。上游现推荐新工作使用 OptimusKG,本技能仍限于 PrimeKG CSV。
主要能力:search_nodes 按字面、不区分大小写搜索节点,默认最多 20 条,limit=None 取消上限;get_neighbors 合并正反向行,按邻居身份/名称、关系与 display_relation 汇总邻接,保留原始 edge_rows;get_disease_context 返回关联基因、药物、表型与相关疾病,并区分 indication、contraindication、off-label;find_paths 枚举 1 至 2 跳无向关联路径,超过 max_paths(默认 1000)报错。
使用方式:需安装 pandas,从技能目录运行,使 scripts.query_primekg 可导入。先下载并校验 CSV,例如: curl --fail --location --output kg.csv 'https://dataverse.harvard.edu/api/access/datafile/6180620' export PRIMEKG_DATA="$PWD/kg.csv" PRIMEKG_DATA 在模块导入时读取,默认 data/PrimeKG/kg.csv。节点由 (id, type, source) 标识,需从搜索结果传入 node_type 与 node_source;ID 按字符串保留。
限制:助手不做远程图查询,每次公开查询读取整个 CSV,非有界内存图引擎;数据量大或内存有限时建议自建索引本地存储。关系名须用存储中的精确名称,如 protein_protein、drug_protein、disease_protein、indication、contraindication、off-label use、disease_phenotype_positive/negative、disease_disease;无通用 drug_disease、disease_phenotype 或 gwas 关系。表型节点类型为 effect/phenotype。x/y 方向不代表因果,x_source/y_source 仅标识命名空间。不检索临床文本、文献、置信度或当前批准状态。缺失边表示未知而非阴性。引用 Chandak 等 Scientific Data 10, 67 (2023)。