用途:该技能通过脚本向 NCBI Datasets v2 接口提交精简请求,获取 assembly、genome、taxonomy 及相关元数据摘要。
主要能力:所有 Datasets v2 调用统一使用 scripts/ncbi_datasets.py;REST 路径相对于 https://api.ncbi.nlm.nih.gov/datasets/v2 显式给出;默认返回简洁的 markdown 摘要,仅在用户明确要求机器可读输出时返回原始 JSON 或文本;支持通过 save_raw=true 保存完整原始响应并报告文件路径。
使用方式:从 stdin 读取一个 JSON 对象。必填字段 path;可选字段包括 params、record_path、response_format、max_items、max_depth、timeout_sec、save_raw、raw_output_path。示例命令:echo '{"path":"genome/taxon/9606/dataset_report","params":{"page_size":10},"record_path":"reports","max_items":10}' | python scripts/ncbi_datasets.py。常见路径模式如 genome/taxon/9606/dataset_report、genome/accession/GCF_000001405.40/dataset_report、taxonomy/taxon/9606。
输出:成功返回 ok、source、path 元数据,以及精简记录、精简摘要或 text_head;失败返回 ok=false 及 error.code、error.message。
限制与规则:优先使用有针对性的元数据路径,避免宽泛无过滤的拉取;长对话中应重新发起请求,而非依赖较早的工具输出;工具预览中显示的 ... 属于界面截断,不是请求内容本身;运行时无需额外引用,导入包仅限本文件与 scripts/ncbi_datasets.py。