SuperAPI AI 工具集

tooluniverse-expression-data-retrieval

数据与分析

查看项目

更新于 10-16 04:03

技能介绍

用途

该技能用于检索基因表达实验与多组学数据集,主要对接 ArrayExpress 和 BioStudies 两个数据库,适合需要查找公开表达谱数据、进行数据复用或整合分析的场景。它强调基因消歧与实验质量评估,并以结构化报告的形式呈现结果。

主要能力

  1. 查询澄清:当基因名有歧义(如 p53 指向 TP53 还是 MDM2 研究)、组织/条件不明确或未指定生物体时,会先向用户提问;对于明确的具体登录号(E-MTAB-、E-GEOD-、S-BSST*)、疾病/组织与生物体组合清晰的查询,或明确平台(RNA-seq、microarray)请求,则跳过澄清。
  2. 基因名解析与消歧:以基因检索时先解析官方标识符,如人类 HGNC、小鼠 MGI,记录常见别名以扩展搜索,并确认物种。
  3. 搜索与检索:调用 ArrayExpress 与 BioStudies 工具进行关键词/物种搜索,并获取实验详情、样本信息、可用文件与研究结构等元数据。提供回退链,例如 ArrayExpress 搜索为空时回退到 BioStudies 搜索,E-GEOD 可能有 BioStudies 镜像。
  4. 结构化报告:输出“数据集检索报告”,包含搜索摘要、数据质量概览、顶部实验详情(登录号、生物体、实验类型、平台、样本数、发布日期、实验设计、样本分组、可用数据文件、质量评估)以及多组学研究、汇总表、推荐建议与数据访问链接。
  5. 质量评估分级:分为高质量(●●●,≥3 个生物学重复、元数据完整、有处理后数据)、中等质量(●●○,2-3 个重复或部分元数据缺失、数据可获取)、低质量(●○○,无重复、元数据稀疏或数据访问有问题)、谨慎使用(○○○,单样本、无重复、平台过时),并要求附上评估理由。
  6. 完整性与错误处理:报告必须包含每项实验的必填字段、搜索摘要与推荐建议;即使为空也需包含多组学研究部分与数据整合说明。针对“未找到实验”“登录号未找到”“文件不可用”“API 超时”等情况给出对应处理方式。

使用方式

通过 ToolUniverse 加载工具后调用相关工具。典型调用包括:arrayexpress_search_experiments(关键词/物种搜索)、arrayexpress_get_experiment_details(完整元数据)、arrayexpress_get_experiment_files(下载链接)、arrayexpress_get_experiment_samples(样本注释)、biostudies_search_studies(多组学搜索)、biostudies_get_study_details(研究元数据)、biostudies_get_study_files(数据文件)、biostudies_get_study_sections(研究结构)。搜索参数方面,ArrayExpress 支持 keywords、species、array、limit;BioStudies 支持 query、limit。技能要求工具调用始终使用英文术语(基因名、组织名、条件描述),仅在英文无结果时回退使用原语言;回复则使用用户语言。

适用场景

包括疾病基因表达数据检索(如查找乳腺癌 RNA-seq 数据)、基因特异性研究检索(如查找小鼠 TP53 表达实验,可包含别名 p53)、具体登录号查询(如获取 E-MTAB-5214 详情)、多组学整合检索(如查找肝病的蛋白质组学与转录组学研究)。

限制

资料未提供该技能的收费、价格、平台支持范围、性能保证或具体数据库覆盖完整度等信息。部分研究可能限制数据下载,报告需注明“文件受提交者限制”。质量评估依赖元数据完整性与样本信息,可能受数据库记录质量影响。API 超时后仅重试一次,并可能标注“元数据检索不完整”。