用途:bgee-skill 用于向 Bgee 提交精简的 SPARQL 请求,获取健康野生型表达元数据,并支持本体感知的查询模式。适合用户需要简短 Bgee 摘要时使用。
主要能力与规则:所有 Bgee SPARQL 工作都通过 scripts/sparql_request.py 完成;应从小的 SELECT 或 ASK 查询开始,并尽早添加 LIMIT;优先使用本体感知、健康野生型表达问题,而非宽泛的三元组转储;较长的 SPARQL 文档使用 query_path,而不是内联粘贴大查询;在长对话中应重新执行请求,而不是依赖旧的工具输出。
执行行为:默认从 SPARQL JSON 返回简洁的 markdown 摘要;仅当用户明确要求机器可读输出时才返回原始结果;除非用户明确要求文本输出,默认使用 JSON 结果格式。
输入:从 stdin 读取一个 JSON 对象。必需字段为 query 或 query_path;可选字段包括 method、params、response_format、max_items、max_depth、timeout_sec、save_raw、raw_output_path。常见模式如 {"query":"ASK {}"} 和带 LIMIT 3 的 SELECT 查询。
输出:成功时返回 ok、source、简洁摘要,以及当 save_raw=true 时的 raw_output_path;失败时返回 ok=false,并带有 error.code,例如 invalid_json、invalid_input、network_error 或 invalid_response。
执行方式:echo '{"query":"ASK {}"}' | python scripts/sparql_request.py
限制:参考资料要求无需额外运行时引用,导入包仅限本文件与 scripts/sparql_request.py。其余收费、平台与效果等信息暂未提供。