SuperAPI AI 工具集

alphagenome

智能体与模型

查看项目

更新于 10-22 08:39

技能介绍

用途

本技能封装 AlphaGenome(DeepMind 的序列到功能模型)与 AlphaGenome Atlas(2026-09-08 发布,对 GRCh38 全部约 90 亿单核苷酸变异做的一次预计算)的查询与打分流程。适用于变异影响排序、机制归因、组织特异性轨道解析,以及 Atlas 未覆盖的变异(indel、小鼠、自定义评分器)的在线预测。

主要能力

  • Atlas 查询:按 AVI 分数排序,输出 avi_raw、avi_cdf_quantile、avi_tail_quantile、avi_phred、avi_top_percent、top_feature 与全部 18 项归因;--with-tracks 可附最强轨道信息与门户链接;单条、VCF、可信集或 ≤1 kb 区间均可输入。
  • 轨道级机制解析:按 scorer(RNA_SEQ、DNASE、CHIP_TF、SPLICE_SITE_USAGE 等)和 ontology CURIE(如 UBERON:0001157 结肠)返回每变异×轨道(RNA_SEQ 等再按基因)的 raw_score 与 quantile_score。
  • 模型打分:score_variants.py 对 Atlas 未收录变异打分,默认 12 个推荐差异评分器,--include-active 增加 7 个活动评分器,单请求最多 20 个;支持小鼠与 16 kb–1 Mb 窗口。
  • 预测与突变扫描:predict_variant 输出 REF/ALT 轨道值,score_ism_variants 做饱和突变扫描。
  • 门户深链:atlas_link.py 离线生成变异、位点、基因的 Atlas 门户链接。

使用方式

安装与鉴权:

uv pip install alphagenome
export ALPHAGENOME_API_KEY="..."
cd skills/alphagenome/scripts
python atlas_query.py scorers

坐标约定:变异为 1-based chr:pos:ref>alt,区间为 1-based 闭区间(SDK 的 genome.Interval 为 0-based 半开,脚本会转换);仅支持 GRCh38,Atlas 键为 chr:pos:alt,REF 由参考序列隐含,REF/ALT 颠倒或 GRCh37 坐标会静默返回错误记录,使用前需对照 FASTA 校验 REF;不接受 rsID;需带 chr 前缀,MT 写作 chrM。

典型命令:

python atlas_query.py avi --variant chr22:36201698:A>C
python atlas_query.py avi --input candidates.vcf --min-phred 20 -o avi.tsv
python atlas_query.py scores --variant chr22:36201698:A>C --scorers RNA_SEQ DNASE --ontology UBERON:0001157 -o colon.tsv
python score_variants.py --input indels.vcf --scorers RNA_SEQ SPLICE_SITE_USAGE --ontology UBERON:0001157
python atlas_link.py variant chr22:36201698:A>C --biosample "colon" --modalities RNA_SEQ,DNASE,CHIP_TF

Python 中通过 alphagenome.atlas.atlas.create 调用 query_variant/query_interval,返回 AnnData;query_interval 按 32 bp 分块返回每碱基 3 个 SNV,窗口建议约 1 kb。

适用场景

hg38 SNV 快速排序与机制初筛;区分剪接/编码机制(MERGED_SPLICING、ALPHAMISSENSE 居首)与调控机制(MAX_ABS_DNASE、MAX_ABS_CHIP_TF、MAX_ABS_RNA_SEQ 居首);在特定组织轨道上解释效应;对 indel 或小鼠变异做按需打分。

限制

  • Atlas 目前仅 GRCh38 SNV,indel 与参考 N 碱基未评分;仅覆盖人与小鼠。
  • 无法看到反式效应、非多腺苷酸化 RNA(如 RNU4-2)、训练中缺失的细胞类型、蛋白层面后果(AVI 中折叠了 AlphaMissense)、RNA 结构与 miRNA 生物学、二倍体剂量、发育时间。
  • 配额按 key 且未公开;瞬时 RESOURCE_EXHAUSTED/UNAVAILABLE 会重试(5 次,退避至 60 s)。
  • 访问层级:AVI 分数可 Tabix 下载(宽松许可);特征归因与剪接分数为非商业下载;其余原始轨道分数仅 API 且非商业;商业 API 访问“即将推出”。
  • 客户端为 Apache-2.0,模型权重与输出受 DeepMind 条款约束;仅限研究与理论建模,输出不得用于训练其他模型、诊断流程或医疗决策。

解读要点

报告需同时给出 raw score 与 quantile/Phred,并标注 scorer、轨道、biosample CURIE 与基因;quantile >0.99 但 |raw| <0.1 属安静区域伪影;无符号评分器(SPLICE_、POLYADENYLATION、CONTACT_MAPS、_ACTIVE)无方向;建议按区域或应用选阈值,而非全基因组单一阈值。引用 Avsec et al., Nature 649:1206 (2026) 与 Atlas 报告(Cheng, Taylor, Nicolaisen, Pan, Bycroft, Perino, Ward et al., 2026)。