AnnData 数据检索

要解决什么问题

单细胞与空间转录组等流程里，.h5ad / .zarr 里的 AnnData 往往体积大、结构嵌套（obs、var、X、layers、obsm 等）。在对话里直接「猜」矩阵或元数据既不可靠，也容易把筛选条件搞错。你需要的是：在不自己写完整 scanpy 脚本的前提下，按路径或 URL 查看对象结构、截取一小段原始数据，并对指定列/基因做描述统计。

技能如何工作

本技能通过 MCP 把意图路由到 scripts.tools 里的 API 封装，模型只负责选工具、补参数、整理 result["raw"] 返回。

• get_summary：对本地绝对路径或远程 AnnData 文件做整体摘要。
• view_raw_data：按 attribute（及可选 key）查看原始内容；支持行列切片、columns_or_genes（含 RE* 类 glob）、以及对 DataFrame 属性的 filter_column / filter_operator / filter_value 组合过滤。
• get_descriptive_stats：对属性或嵌套键做 count、mean、std、min、max 等；分类列可开 return_value_counts_for_categorical；也可先按 obs/var 过滤再统计。

典型流程：检查 API 密钥 → 根据用户意图选上表之一 → 缺参时用 AskUserQuestion 补齐 → 用关键字参数调用工具 → 将 API 原始 JSON 整理后展示。

适用边界与注意点

• 必须配置 XBY_APIKEY（小笨羊侧获取）；无密钥时只能向用户索取并 set_api_key，禁止编造或自行搜索替代数据。
• 工具面向「检索与统计」，不负责完整的下游建模、批次校正或发表级 QC 流水线。
• 过滤类参数需成组提供（例如 filter_column 与 filter_operator、filter_value 同时存在），否则应先向用户确认。