华为云用户手册

URI PUT /v1/{project_id}/eihealth-projects/{eihealth_project_id}/project-tracker 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 eihealth_project_id 是 String 医疗智能体 平台项目ID，您可以在 EIHealth 平台单击所需的项目名称，进入项目设置页面查看“项目编号”。 最小长度：1 最大长度：128

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/data-traces 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 医疗智能体平台项目ID，您可以在EIHealth平台单击所需的项目名称，进入项目设置页面查看“项目编号”。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128

请求示例 创建一个分子生成任务 { "num_trials" : 10000, "weak_constraints" : [ { "name" : "mw", "type" : "range", "range" : [ 100, 600 ] }, { "name" : "nhet", "type" : "range", "range" : [ 0, 15 ] }, { "name" : "fsp3", "type" : "range", "range" : [ 0.07317, null ] }, { "name" : "qedmean", "type" : "maximize" }, { "name" : "sascore", "type" : "minimize", "quantiles" : [ 0.1, 0.9 ] }, { "name" : "3b2dce64-c244-11ed-acf5-0255ac100017", "type" : "range", "range" : [ 0.2, 0.5 ] } ], "initial_dataset" : [ "c1ccccc1", "C1CCCCC1" ], "custom_props" : [ { "id" : "3b2dce64-c244-11ed-acf5-0255ac100017", "prop_definition" : { "id" : "c4c07032d1934671a0dfe3bd10416eea", "name" : "custom_prop_name", "type" : "numerical", "description" : "custom_prop_description" } } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户 token 表3 请求Body参数 参数 是否必选 参数类型 描述 num_trials 否 Integer 生成分子数量 strong_constraints 否 Array of 表4 objects 强约束集合 weak_constraints 否 Array of 表4 objects 弱约束集合 num_expected 否 Integer 期望最大返回条目数（排序后取Top） initial_dataset 否 Array of strings 初始化分子集合 binding_site 否 表6 object 结合位点 custom_props 否 Array of 表8 objects 用户已开启的自定义属性集合 表4 MoleculeConstraint 参数 是否必选 参数类型 描述 name 否 String 属性名称 type 是 String 属性约束类型 枚举值： bool range struct minimize maximize bool 否 Boolean 属性约束类型bool的参数 range 否 Array of numbers 属性约束类型range的参数 struct 否 表5 object 结构约束参数 quantiles 否 Array of numbers 属性约束类型minimize和maximize的参数 最小值：0.0 最大值：1.0 表5 StructureConstraintParams 参数 是否必选 参数类型 描述 structs 是 Array of strings 子结构SMILES exclusive 是 Boolean 是否排除子结构 operator 否 String 多个子结构之间的逻辑关系 缺省值：or 枚举值： or and 表6 BindingSite 参数 是否必选 参数类型 描述 protein 否 String 蛋白质3D结构，使用gzip压缩然后转base64格式 最小长度：1 最大长度：10000000 bounding_box 否 表7 object 结合口袋，包含口袋中心位置和尺寸大小 表7 BoundingBox 参数 是否必选 参数类型 描述 center 否 Array of numbers 口袋中心坐标。 x, y, z轴的坐标 size 否 Array of numbers 口袋尺寸大小。x, y, z轴的大小 最小值：1.7 最大值：500 表8 CustomProp 参数 是否必选 参数类型 描述 id 是 String 自定义属性的ID（API侧） 最小长度：1 最大长度：64 prop_definition 否 表9 object 属性定义的元信息 表9 PropDefinition 参数 是否必选 参数类型 描述 id 否 String 属性业务侧ID 最小长度：1 最大长度：128 name 否 String 属性名称 最小长度：1 最大长度：32 type 否 String 属性类型 枚举值： binary numerical description 否 String 属性具体描述信息 最小长度：0 最大长度：256 value_range 否 表10 object 属性有效值域区间 optimal_range 否 表10 object 属性最优值域区间 warning_range 否 表10 object 属性欠佳值域区间 style 否 String 模型参数呈现类型 枚举值： number probability confidential_interval 否 Boolean 模型推理是否呈现置信区间 表10 ValueRange 参数 是否必选 参数类型 描述 lower 否 Number 值域下限 lower_inclusive 否 Boolean 是否包含值域下限 upper 否 Number 值域上限 upper_inclusive 否 Boolean 是否包含值域上限

响应示例 状态码： 200 ADMET成功响应 { "ab": "base", "acute_toxicity_rule": 0, "alarm_nmr_rule": 0, "ames": 0.000004555075065582059, "aquatic_toxicity_rule": 0, "bace": 0.7276865839958191, "bbb_penetration": 0.7105281352996826, "bbbp": 0.8388334512710571, "bms_rule": 0, "caco_2_permeability": 1.6074275970458984, "carcinogencity": 0.6126266121864319, "check_alphascreen_gst_fhs": 0, "chelator_rule": 0, "cl": 1.489494800567627, "cl_std": 3.0314340591430664, "dense": 0.668, "dili": 0.9996542930603027, "esol": -2.342970371246338, "esol_std": 2.670086622238159, "f20": 0.9999995231628418, "f30": 0.9999735355377197, "faf_drugs4_rule": 0, "fdamdd": 0.5130584836006165, "freesol_std": 4.852236270904541, "fsp3": 1, "fu": 0.7917574644088745, "fu_std": 1.7218350172042847, "genotoxic_carcinogenicity_rule": 0, "golden_triangle_rule": false, "gsk_rule": true, "h-ht": 0.27191320061683655, "herg_blockers": 0.00007402851042570546, "hia": 0.8719885349273682, "hiv": 0.005348484497517347, "igc50_std": 1.7592569589614868, "logs": -2.6434288024902344, "logs_std": 0.3384721577167511, "maxring": 0, "mdck": -0.00004775416891789064, "mr": 11.348000000000003, "mw": 30.07, "npscore": 0.025, "pfizer_rule": false, "pgp_inhibitor": 1.4114744040227833e-8, "pgp_substrate": 0.9981564879417419, "pka": 10.02965259552002, "pka_std": 1.854716420173645, "ppb": 0.27514201402664185, "ppb_std": 1.5638395547866821, "qedmean": 0.373, "sascore": 2.748, "scscore": 1.4448203850917012, "skin_sensitization": 0.4587304890155792, "skin_sensitization_rule": 0, "sr_are": 0.004388807807117701, "sr_atad5": 0.000014169700079946779, "sr_hse": 0.0010032267309725285, "sr_mmp": 0.015672488138079643, "sr_p53": 0.000005944234089838574, "surechembl_rule": "0,", "t12": 0.6137365102767944, "tpsa": 0, "vd": 0.6327598690986633, "vd_std": 1.8924747705459595, "veber_rule": true, "vol": 45 }

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/project-tracker 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 eihealth_project_id 是 String 医疗智能体平台项目ID，您可以在EIHealth平台单击所需的项目名称，进入项目设置页面查看“项目编号”。 最小长度：1 最大长度：128

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限， 获取Token 接口响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 smiles 是 String 分子SMILES表达式 最小长度：1 最大长度：200

响应示例 状态码： 200 分子优化任务查询成功响应 { "status" : "finished", "result" : { "name" : "87ba6b54-2288-4a5d-90a2-3db01c22a9d2", "num_rounds" : 10, "num_expected" : 1000, "num_strong_constraints" : 0, "num_weak_constraints" : 5, "custom_props" : [ { "id" : "3b2dce64-c244-11ed-acf5-0255ac100017", "prop_definition" : { "id" : "c4c07032d1934671a0dfe3bd10416eea", "name" : "custom_prop_name", "type" : "numerical", "description" : "custom_prop_description" } } ], "prop_names" : [ "formula", "ab", "acute_toxicity_rule", "bace", "3b2dce64-c244-11ed-acf5-0255ac100017", "3b2dce64-c244-11ed-acf5-0255ac100017_std" ], "original" : { "smiles" : "c1ccccc1", "props" : [ "C6H6", "base", 0, 0.128335, 0.43, 0.28 ] }, "result" : [ { "smiles" : "c1ccccc1", "num_fulfilled_weak_constraints" : 3, "similarity" : 0.8, "score" : 0.388029, "props" : [ "C6H6", "base", 0, 0.128335, 0.43, 0.28 ] }, { "smiles" : "C1CCCCC1", "num_fulfilled_weak_constraints" : 2, "similarity" : 0.6, "score" : 0.304194, "props" : [ "C6H12", "base", 0, 0.163034, 0.43, 0.28 ] } ], "weak_constraints" : [ { "name" : "mw", "type" : "range", "range" : [ 100, 600 ] }, { "name" : "nhet", "type" : "range", "range" : [ 0, 15 ] }, { "name" : "fsp3", "type" : "range", "range" : [ 0.07317073170731707, null ] }, { "name" : "qedmean", "type" : "maximize" }, { "name" : "sascore", "type" : "minimize", "quantiles" : [ 0.1, 0.9 ] } ], "strong_constraints" : [ { "name" : "mw", "type" : "range", "range" : [ 100, 600 ] } ], "binding_site" : { "protein" : "H4sIAK8LamMC/3MM8fdVAANDBQU/IOUY7KfgqKBgYgEVNdAzMDACMfRMTAwUFIyN9EwsDUFcAyDPQA+mDgz8AHV0WkpOAAAA", "bounding_box" : { "center" : [ 1.3, 23.4, -14.5 ], "size" : [ 10.0, 10.0, 10.0 ] } } }}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 异步任务的状态：等待中、运行中、已完成、失败 枚举值： waiting running finished failed task_data OptimizationTaskData object 分子优化任务的请求体 result OptimizationResult object 分子优化任务的返回结果 表4 OptimizationTaskData 参数 参数类型 描述 smiles String 分子SMILES表达式 num_trials Integer 生成分子数量 strong_constraints Array of MoleculeConstraint objects 强约束集合 weak_constraints Array of MoleculeConstraint objects 弱约束集合 num_expected Integer 期望最大返回条目数（排序后取Top） binding_site BindingSite object 结合位点 custom_props Array of CustomProp objects 用户已开启的自定义属性集合 表5 OptimizationResult 参数 参数类型 描述 name String 任务名 最小长度：1 最大长度：128 smiles String 分子SMILES表达式 num_rounds Integer 总生成轮数 num_trials_per_round Integer 每轮生成数量 num_expected Integer 期望条目数 num_strong_constraints Integer 强约束数量 num_weak_constraints Integer 弱约束数量 prop_names Array of strings 分子ADMET属性名列表 original PlainMoleculeItem object 先导小分子的ADMET属性 result Array of OptimizationResultItem objects 分子优化结果条目 strong_constraints Array of MoleculeConstraint objects 强约束集合 weak_constraints Array of MoleculeConstraint objects 弱约束集合 binding_site BindingSite object 结合位点 custom_props Array of CustomProp objects 用户已开启的自定义属性集合 表6 PlainMoleculeItem 参数 参数类型 描述 smiles String 分子SMILES表达式 props Array of objects 分子ADMET属性值列表 表7 OptimizationResultItem 参数 参数类型 描述 smiles String 分子SMILES表达式 props Array of objects 分子ADMET属性值列表 similarity Number 分子与初始分子的相似度 num_fulfilled_weak_constraints Integer 分子所满足的弱约束数量 score Number 分子的打分 表8 MoleculeConstraint 参数 参数类型 描述 name String 属性名称 type String 属性约束类型 枚举值： bool range struct minimize maximize bool Boolean 属性约束类型bool的参数 range Array of numbers 属性约束类型range的参数 struct StructureConstraintParams object 结构约束参数 quantiles Array of numbers 属性约束类型minimize和maximize的参数 最小值：0.0 最大值：1.0 表9 StructureConstraintParams 参数 参数类型 描述 structs Array of strings 子结构SMILES exclusive Boolean 是否排除子结构 operator String 多个子结构之间的逻辑关系 缺省值：or 枚举值： or and 表10 BindingSite 参数 参数类型 描述 protein String 蛋白质3D结构，使用gzip压缩然后转base64格式 最小长度：1 最大长度：10000000 bounding_box BoundingBox object 结合口袋，包含口袋中心位置和尺寸大小 表11 BoundingBox 参数 参数类型 描述 center Array of numbers 口袋中心坐标; x, y, z轴的坐标 size Array of numbers 口袋尺寸大小; x, y, z轴的大小 最小值：1.7 最大值：500 表12 CustomProp 参数 参数类型 描述 id String 自定义属性的ID（API侧） 最小长度：1 最大长度：64 prop_definition PropDefinition object 属性定义的元信息 表13 PropDefinition 参数 参数类型 描述 id String 属性业务侧ID 最小长度：1 最大长度：128 name String 属性名称 最小长度：1 最大长度：32 type String 属性类型 枚举值： binary numerical description String 属性具体描述信息 最小长度：0 最大长度：256 value_range ValueRange object 属性有效值域区间 optimal_range ValueRange object 属性最优值域区间 warning_range ValueRange object 属性欠佳值域区间 style String 模型参数呈现类型 枚举值： number probability confidential_interval Boolean 模型推理是否呈现置信区间 表14 ValueRange 参数 参数类型 描述 lower Number 值域下限 lower_inclusive Boolean 是否包含值域下限 upper Number 值域上限 upper_inclusive Boolean 是否包含值域上限

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 异步任务的状态：等待中、运行中、已完成、失败 枚举值： waiting running finished failed task_data CpiTaskData object CPI任务的请求体 result CpiResult object CPI任务的返回结果 表4 CpiTaskData 参数 参数类型 描述 header String 蛋白质FASTA标题 最小长度：0 最大长度：128 fasta String 蛋白质FASTA序列 最小长度：4 最大长度：2048 smiles_list Array of strings 分子SMILES表达式列表 threshold Float 打分阈值，分值必须大于该阈值才会返回 num_results Integer 期望最大返回条目数（排序后取Top） custom_props Array of CustomProp objects 用户已开启的自定义属性集合 表5 CpiResult 参数 参数类型 描述 header String 蛋白质FASTA标题 fasta String 蛋白质FASTA序列 prop_names Array of strings 分子ADMET属性名列表 result Array of CpiResultItem objects 返回CPI的模型结果 custom_props Array of CustomProp objects 用户已开启的自定义属性集合 表6 CpiResultItem 参数 参数类型 描述 smiles String 分子SMILES表达式 props Array of objects 分子ADMET属性值列表 score Number 分子与蛋白质的打分 表7 CustomProp 参数 参数类型 描述 id String 自定义属性的ID（API侧） 最小长度：1 最大长度：64 prop_definition PropDefinition object 属性定义的元信息 表8 PropDefinition 参数 参数类型 描述 id String 属性业务侧ID 最小长度：1 最大长度：128 name String 属性名称 最小长度：1 最大长度：32 type String 属性类型 枚举值： binary numerical description String 属性具体描述信息 最小长度：0 最大长度：256 value_range ValueRange object 属性有效值域区间 optimal_range ValueRange object 属性最优值域区间 warning_range ValueRange object 属性欠佳值域区间 style String 模型参数呈现类型 枚举值： number probability confidential_interval Boolean 模型推理是否呈现置信区间 表9 ValueRange 参数 参数类型 描述 lower Number 值域下限 lower_inclusive Boolean 是否包含值域下限 upper Number 值域上限 upper_inclusive Boolean 是否包含值域上限

响应示例 状态码： 200 CPI任务查询成功响应 { "status" : "finished", "result" : { "header" : "T1030 BibA, 273 residues", "fasta" : "DQELGKQSRRSQDIIKSLGFLSSDQKDILVKSISSSKDSQLILKFVTQATQLNNAESTKAKQMAQNDVALIKNISPEVLEEYKEKIQRASTKSQVDEFVAEAKKVVNSNKET", "custom_props" : [ { "id" : "3b2dce64-c244-11ed-acf5-0255ac100017", "prop_definition" : { "id" : "c4c07032d1934671a0dfe3bd10416eea", "name" : "custom_prop_name", "type" : "numerical", "description" : "custom_prop_description" } } ], "prop_names" : [ "formula", "ab", "acute_toxicity_rule", "bace", "3b2dce64-c244-11ed-acf5-0255ac100017", "3b2dce64-c244-11ed-acf5-0255ac100017_std" ], "result" : [ { "smiles" : "c1ccccc1", "score" : 0.388029, "props" : [ "C6H6", "base", 0, 0.128335, 0.43, 0.28 ] }, { "smiles" : "C1CCCCC1", "score" : 0.304194, "props" : [ "C6H12", "base", 0, 0.163034, 0.43, 0.28 ] } ] }}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户 token 表3 请求Body参数 参数 是否必选 参数类型 描述 header 否 String 蛋白质FASTA标题 最小长度：0 最大长度：128 fasta 是 String 蛋白质FASTA序列 最小长度：4 最大长度：2048 smiles_list 是 Array of strings 分子SMILES表达式列表 threshold 否 Float 打分阈值，分值必须大于该阈值才会返回 num_results 否 Integer 期望最大返回条目数（排序后取Top） custom_props 否 Array of CustomProp objects 用户已开启的自定义属性集合 表4 CustomProp 参数 是否必选 参数类型 描述 id 是 String 自定义属性的ID（API侧） 最小长度：1 最大长度：64 prop_definition 否 PropDefinition object 属性定义的元信息 表5 PropDefinition 参数 是否必选 参数类型 描述 id 否 String 属性业务侧ID 最小长度：1 最大长度：128 name 否 String 属性名称 最小长度：1 最大长度：32 type 否 String 属性类型 枚举值： binary numerical description 否 String 属性具体描述信息 最小长度：0 最大长度：256 value_range 否 ValueRange object 属性有效值域区间 optimal_range 否 ValueRange object 属性最优值域区间 warning_range 否 ValueRange object 属性欠佳值域区间 style 否 String 模型参数呈现类型 枚举值： number probability confidential_interval 否 Boolean 模型推理是否呈现置信区间 表6 ValueRange 参数 是否必选 参数类型 描述 lower 否 Number 值域下限 lower_inclusive 否 Boolean 是否包含值域下限 upper 否 Number 值域上限 upper_inclusive 否 Boolean 是否包含值域上限

请求示例 创建一个CPI任务 POST https://{endpoint}/v1/{project_id}/task/cpi{ "header" : "T1030 BibA, 273 residues", "fasta" : "DQELGKQSRRSQDIIKSLGFLSSDQKDILVKSISSSKDSQLILKFVTQATQLNNAESTKAKQMAQNDVALIKNISPEVLEEYKEKIQRASTKSQVDEFVAEAKKVVNSNKET", "smiles_list" : [ "c1ccccc1", "C1CCCCC1" ], "custom_props" : [ { "id" : "3b2dce64-c244-11ed-acf5-0255ac100017", "prop_definition" : { "id" : "c4c07032d1934671a0dfe3bd10416eea", "name" : "custom_prop_name", "type" : "numerical", "description" : "custom_prop_description" } } ]}

响应示例 状态码： 200 分子生成任务查询成功响应 { "status" : "finished", "result" : { "name" : "87ba6b54-2288-4a5d-90a2-3db01c22a9d2", "num_rounds" : 10, "num_expected" : 1000, "num_strong_constraints" : 0, "num_weak_constraints" : 5, "custom_props" : [ { "id" : "3b2dce64-c244-11ed-acf5-0255ac100017", "prop_definition" : { "id" : "c4c07032d1934671a0dfe3bd10416eea", "name" : "custom_prop_name", "type" : "numerical", "description" : "custom_prop_description" } } ], "prop_names" : [ "formula", "ab", "acute_toxicity_rule", "bace", "3b2dce64-c244-11ed-acf5-0255ac100017", "3b2dce64-c244-11ed-acf5-0255ac100017_std" ], "result" : [ { "smiles" : "c1ccccc1", "num_fulfilled_weak_constraints" : 3, "score" : 0.388029, "props" : [ "C6H6", "base", 0, 0.128335, 0.65, 0.88 ] }, { "smiles" : "C1CCCCC1", "num_fulfilled_weak_constraints" : 2, "score" : 0.304194, "props" : [ "C6H12", "base", 0, 0.163034, 0.65, 0.88 ] } ], "initial_dataset_size" : 2, "weak_constraints" : [ { "name" : "mw", "type" : "range", "range" : [ 100, 600 ] }, { "name" : "nhet", "type" : "range", "range" : [ 0, 15 ] }, { "name" : "fsp3", "type" : "range", "range" : [ 0.07317, null ] }, { "name" : "qedmean", "type" : "maximize" }, { "name" : "sascore", "type" : "minimize", "quantiles" : [ 0.1, 0.9 ] } ], "strong_constraints" : [ { "name" : "mw", "type" : "range", "range" : [ 100, 600 ] } ], "binding_site" : null }}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 异步任务的状态：等待中、运行中、已完成、失败 枚举值： waiting running finished failed task_data GenerationTaskData object 分子生成任务的请求体 result GenerationResult object 分子生成任务的返回结果 表4 GenerationTaskData 参数 参数类型 描述 num_trials Integer 生成分子数量 strong_constraints Array of MoleculeConstraint objects 强约束集合 weak_constraints Array of MoleculeConstraint objects 弱约束集合 num_expected Integer 期望最大返回条目数（排序后取Top） initial_dataset Array of strings 初始化分子集合 binding_site BindingSite object 结合位点 custom_props Array of CustomProp objects 用户已开启的自定义属性集合 表5 GenerationResult 参数 参数类型 描述 name String 任务名 最小长度：1 最大长度：128 num_rounds Integer 总生成轮数 num_expected Integer 期望条目数 num_strong_constraints Integer 强约束数量 num_weak_constraints Integer 弱约束数量 prop_names Array of strings 分子ADMET属性名列表 result Array of GenerationResultItem objects 分子生成结果条目 initial_dataset_size Integer 初始化数据集的分子条目数 strong_constraints Array of MoleculeConstraint objects 强约束集合 weak_constraints Array of MoleculeConstraint objects 弱约束集合 binding_site BindingSite object 结合位点 custom_props Array of CustomProp objects 用户已开启的自定义属性集合 表6 GenerationResultItem 参数 参数类型 描述 smiles String 分子SMILES表达式 props Array of objects 分子ADMET属性值列表 num_fulfilled_weak_constraints Integer 分子所满足的弱约束数量 score Number 分子的打分 表7 MoleculeConstraint 参数 参数类型 描述 name String 属性名称 type String 属性约束类型 枚举值： bool range struct minimize maximize bool Boolean 属性约束类型bool的参数 range Array of numbers 属性约束类型range的参数 struct StructureConstraintParams object 结构约束参数 quantiles Array of numbers 属性约束类型minimize和maximize的参数 最小值：0.0 最大值：1.0 表8 StructureConstraintParams 参数 参数类型 描述 structs Array of strings 子结构SMILES exclusive Boolean 是否排除子结构 operator String 多个子结构之间的逻辑关系 缺省值：or 枚举值： or and 表9 BindingSite 参数 参数类型 描述 protein String 蛋白质3D结构，使用gzip压缩然后转base64格式 最小长度：1 最大长度：10000000 bounding_box BoundingBox object 结合口袋，包含口袋中心位置和尺寸大小 表10 BoundingBox 参数 参数类型 描述 center Array of numbers 口袋中心坐标; x, y, z轴的坐标 size Array of numbers 口袋尺寸大小; x, y, z轴的大小 最小值：1.7 最大值：500 表11 CustomProp 参数 参数类型 描述 id String 自定义属性的ID（API侧） 最小长度：1 最大长度：64 prop_definition PropDefinition object 属性定义的元信息 表12 PropDefinition 参数 参数类型 描述 id String 属性业务侧ID 最小长度：1 最大长度：128 name String 属性名称 最小长度：1 最大长度：32 type String 属性类型 枚举值： binary numerical description String 属性具体描述信息 最小长度：0 最大长度：256 value_range ValueRange object 属性有效值域区间 optimal_range ValueRange object 属性最优值域区间 warning_range ValueRange object 属性欠佳值域区间 style String 模型参数呈现类型 枚举值： number probability confidential_interval Boolean 模型推理是否呈现置信区间 表13 ValueRange 参数 参数类型 描述 lower Number 值域下限 lower_inclusive Boolean 是否包含值域下限 upper Number 值域上限 upper_inclusive Boolean 是否包含值域上限

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 operation String 是否开启资源配额限制 枚举值： OPEN CLOSE settings UserSettingDto object 更新用户请求体 表4 UserSettingDto 参数 参数类型 描述 job_quota Integer 允许同时运行的作业数 最小值：1 最大值：100 job_timeout Integer 作业执行超时时长，单位天 最小值：1 最大值：60 cpu_quota Integer 作业的CPU资源配额，单位核 最小值：1 最大值：1024 mem_quota Integer 作业的内存资源配额，单位GB 最小值：1 最大值：1024 projects_per_user Integer 用户可创建项目数配额 最小值：0 最大值：20 缺省值：2

请求示例 更新用户设置，设置开启资源配额限制，设置作业配额为10，作业超时时长为1天，CPU的核数配额为50，内存的配额为128GB，用户可创建的项目数为2 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/users/{user_id}/settings{ "operation" : "OPEN", "settings" : { "job_quota" : 10, "job_timeout" : 1, "cpu_quota" : 50, "mem_quota" : 128 }}

响应示例 状态码： 200 OK { "maximum" : { "value" : 17, "row_number" : 102, "column_name" : "Mpro", "row_name" : "AZD-5991" }, "minimum" : { "value" : 17, "row_number" : 102, "column_name" : "Mpro", "row_name" : "AZD-5991" }}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 operation 是 String 是否开启资源配额限制 枚举值： OPEN CLOSE settings 是 UserSettingDto object 更新用户请求体 表4 UserSettingDto 参数 是否必选 参数类型 描述 job_quota 是 Integer 允许同时运行的作业数 最小值：1 最大值：100 job_timeout 是 Integer 作业执行超时时长，单位天 最小值：1 最大值：60 cpu_quota 是 Integer 作业的CPU资源配额，单位核 最小值：1 最大值：1024 mem_quota 是 Integer 作业的内存资源配额，单位GB 最小值：1 最大值：1024 projects_per_user 否 Integer 用户可创建项目数配额 最小值：0 最大值：20 缺省值：2

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 maximum ExtremumDto object study作业最值信息 minimum ExtremumDto object study作业最值信息 表4 ExtremumDto 参数 参数类型 描述 value Double 最值 row_number Long 最值所在的行数 column_name String 最值所在的列名 row_name String 最值所在的行名

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/studies/{study_id}/jobs/{job_id}/extremum 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 医疗智能体平台项目ID，您可以在EIHealth平台单击所需的项目名称，进入项目设置页面查看“项目编号”。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 study_id 是 String study_id 最小长度：1 最大长度：128 job_id 是 String study作业id 最小长度：1 最大长度：128

请求示例 创建一个分子优化任务 POST https://{endpoint}/v1/{project_id}/task/optimization{ "smiles" : "c1ccccc1", "num_trials" : 10000, "weak_constraints" : [ { "name" : "mw", "type" : "range", "range" : [ 100, 600 ] }, { "name" : "nhet", "type" : "range", "range" : [ 0, 15 ] }, { "name" : "fsp3", "type" : "range", "range" : [ 0.07317073170731707, null ] }, { "name" : "qedmean", "type" : "maximize" }, { "name" : "sascore", "type" : "minimize", "quantiles" : [ 0.1, 0.9 ] }, { "name" : "3b2dce64-c244-11ed-acf5-0255ac100017", "type" : "range", "range" : [ 0.2, 0.5 ] } ], "binding_site" : { "protein" : "H4sIAK8LamMC/3MM8fdVAANDBQU/IOUY7KfgqKBgYgEVNdAzMDACMfRMTAwUFIyN9EwsDUFcAyDPQA+mDgz8AHV0WkpOAAAA", "bounding_box" : { "center" : [ 1.3, 23.4, -14.5 ], "size" : [ 10.0, 10.0, 10.0 ] } }, "custom_props" : [ { "id" : "3b2dce64-c244-11ed-acf5-0255ac100017", "prop_definition" : { "id" : "c4c07032d1934671a0dfe3bd10416eea", "name" : "custom_prop_name", "type" : "numerical", "description" : "custom_prop_description" } } ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户 token 表3 请求Body参数 参数 是否必选 参数类型 描述 smiles 是 String 分子SMILES表达式 num_trials 否 Integer 生成分子数量 strong_constraints 否 Array of MoleculeConstraint objects 强约束集合 weak_constraints 否 Array of MoleculeConstraint objects 弱约束集合 num_expected 否 Integer 期望最大返回条目数（排序后取Top） binding_site 否 BindingSite object 结合位点 custom_props 否 Array of CustomProp objects 用户已开启的自定义属性集合 表4 MoleculeConstraint 参数 是否必选 参数类型 描述 name 否 String 属性名称 type 是 String 属性约束类型 枚举值： bool range struct minimize maximize bool 否 Boolean 属性约束类型bool的参数 range 否 Array of numbers 属性约束类型range的参数 struct 否 StructureConstraintParams object 结构约束参数 quantiles 否 Array of numbers 属性约束类型minimize和maximize的参数 最小值：0.0 最大值：1.0 表5 StructureConstraintParams 参数 是否必选 参数类型 描述 structs 是 Array of strings 子结构SMILES exclusive 是 Boolean 是否排除子结构 operator 否 String 多个子结构之间的逻辑关系 缺省值：or 枚举值： or and 表6 BindingSite 参数 是否必选 参数类型 描述 protein 否 String 蛋白质3D结构，使用gzip压缩然后转base64格式 最小长度：1 最大长度：10000000 bounding_box 否 BoundingBox object 结合口袋，包含口袋中心位置和尺寸大小 表7 BoundingBox 参数 是否必选 参数类型 描述 center 否 Array of numbers 口袋中心坐标; x, y, z轴的坐标 size 否 Array of numbers 口袋尺寸大小; x, y, z轴的大小 最小值：1.7 最大值：500 表8 CustomProp 参数 是否必选 参数类型 描述 id 是 String 自定义属性的ID（API侧） 最小长度：1 最大长度：64 prop_definition 否 PropDefinition object 属性定义的元信息 表9 PropDefinition 参数 是否必选 参数类型 描述 id 否 String 属性业务侧ID 最小长度：1 最大长度：128 name 否 String 属性名称 最小长度：1 最大长度：32 type 否 String 属性类型 枚举值： binary numerical description 否 String 属性具体描述信息 最小长度：0 最大长度：256 value_range 否 ValueRange object 属性有效值域区间 optimal_range 否 ValueRange object 属性最优值域区间 warning_range 否 ValueRange object 属性欠佳值域区间 style 否 String 模型参数呈现类型 枚举值： number probability confidential_interval 否 Boolean 模型推理是否呈现置信区间 表10 ValueRange 参数 是否必选 参数类型 描述 lower 否 Number 值域下限 lower_inclusive 否 Boolean 是否包含值域下限 upper 否 Number 值域上限 upper_inclusive 否 Boolean 是否包含值域上限

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 Accept 是 String 值为application/octet-stream,application/json;charset=utf-8。

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/studies/{study_id}/jobs/{job_id}/3d-structure 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 医疗智能体平台项目ID，您可以在EIHealth平台单击所需的项目名称，进入项目设置页面查看“项目编号”。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 study_id 是 String study_id 最小长度：1 最大长度：128 job_id 是 String study作业id 最小长度：1 最大长度：128 表2 Query参数 参数 是否必选 参数类型 描述 ligand 是 String 配体名称 最小长度：1 最大长度：200 receptor 是 String 受体名称 最小长度：1 最大长度：200

响应示例 状态码： 200 OK { "count" : 1, "jobs" : [ { "id" : "78dfce53-0303-4b46-a....", "workflow_job_id" : "78dfce53-0303-4b46-a....", "name" : "study-job", "status" : "RUNNING", "template_id" : "24dfce53-0303-4b46-a....", "database_name" : "demo-database", "database_id" : "4f7fce53-0303-4b46-a....", "relative_path" : "/docking-summary", "output_file_type" : "csv", "workflow_name" : "docking-summary", "label" : "small-molecular-chemicals", "create_time" : "2021-02-22T07:07:41Z", "update_time" : "2021-02-22T07:07:41Z" } ]}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Integer 作业总数 jobs Array of StudyJobRsp objects 作业列表 表4 StudyJobRsp 参数 参数类型 描述 id String study作业id workflow_job_id String workflow作业id name String 作业名称 status String 作业状态 template_id String 生成study作业结果的模板id database_name String study作业结果的数据库实例名称 database_id String study作业结果的数据库实例id relative_path String 生成study作业结果的文件的相对路径 output_file_type String 生成study作业结果的文件的类型 workflow_name String 使用的workflow名称 label String 使用的workflow标签 create_time String 作业创建时间 update_time String 作业更新时间

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/studies/{study_id}/jobs 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 医疗智能体平台项目ID，您可以在EIHealth平台单击所需的项目名称，进入项目设置页面查看“项目编号”。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 study_id 是 String study_id 最小长度：1 最大长度：128

请求示例 创建药筛作业，指定已创建的流程作业id、数据库模板id、数据库名称、生成结果的相对路径、输出文件类型 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/studies/{study_id}/jobs{ "workflow_job_id" : "fce1376b-72f9-4d15-9....", "template_id" : "e1ae25a0-070b-41ca-a....", "database_name" : "demo-database", "relative_path" : "docking-summary", "output_file_type" : "csv"}

URI POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/studies/{study_id}/jobs 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 医疗智能体平台项目ID，您可以在EIHealth平台单击所需的项目名称，进入项目设置页面查看“项目编号”。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 study_id 是 String study_id 最小长度：1 最大长度：128