SuperAPI AI 工具集

jinko-model

智能体与模型

查看项目

更新于 10-16 07:23

技能介绍

用途:该技能用于通过 jinko-sdk 进行 Jinkō 计算模型(QSP/PK-PD)的技术性构建与编辑,聚焦 SDK 机制与模型有效性,不评估生物学合理性。前提是先运行 jinko-sdk-setup 技能完成连接初始化,并确认 SDK 满足其 metadata.requires_sdk 范围;会话码只能交换一次,需在调用本技能的 SDK 进程前重新获取 get_session_code。

主要能力:若已有模型应优先编辑而非新建;仅在需要时用 client.create_empty_model() 在专用文件夹中新建。编辑前需检索模型,检查组件、标签、单位、求解选项与诊断信息,查看 model.get_unit_check(),并设置为 model.set_unit_check("UnitCheckAndConvertAllSpeciesToExtentUnits")(除非经人类明确指示,否则不选其他模式)。所有直接声明的数值(参数公式、隔室体积、物种初始条件)都需带单位;由表达式推导的参数可省略声明单位,并应依据 references/units_static_info.json 与诊断校验非平凡单位。

标签与校验:模型完成前需附加内置平台标签 i::vpop、i::protocol,以及每个适用值输入的证据来源标签 s::knowledge、s::arbitrary 或 s::to-calibrate;不确定的输入留空并上报,构建期间不得使用 s::calibrated。重要时间序列输出加 output。至少一个组件需带 output,否则视为错误;无 i::protocol 或无 i::vpop 应报告为警告。可用 python -m jinko.cli.validate_model_readiness --model-sid cm-... 运行三项检查。带 s::knowledge 的值输入需附可追溯链接。可选科学标签包括 granularity::、phenomenon::、module::、readout::,并各自有指定颜色。

使用方式:优先使用高层 SDK 方法与 model.components.batch(version="...") 修改相关组件;平台标签已存在,勿重建。可查阅 help(type(model)) 或 help(model.simple_solve) 读取方法签名。使用 scripts/create_minimal_model.py 及 python -m jinko.cli.tag_model_components、validate_model_readiness,脚本默认 dry-run,仅加 --apply 才变更。时间转换使用 from jinko.iso8601 import Duration,如 Duration.parse("P1M").to_timedelta()。

限制:技能不负责生物学合理性判断;缺失事实如具体平台支持范围、收费与定价等暂未提供。