# 医疗工具规范与模拟环境数据（SHP-MED-08-055）

医疗工具的接口规范，配一套可复跑的模拟环境。规范写明用途与非用途、参数与结果模式、权限、前置条件。另有状态机、错误码与可重试性、幂等规则与超时。模拟任务在运行前先声明期望状态、期望输出与期望错误，运行结果与之逐项比对。用于智能体的工具接入、离线联调，以及院内接口准入核对。
所属体系：医疗智能体数据。
实体 19 个：检查点 · 错误分类 · 工具规范 · 参数结构 · 权限范围 · 前置条件 · 数据质量项 · 结果模式 · 复核记录 · 评分方 · 模拟环境 · 模拟运行 · 模拟任务 · 来源沿袭 · 合成样本集 · 工具候选 · 覆盖状态 · 状态机 · 工具版本。
字段 117 个（交付范围内的字段总数）。
可获得的业务字段（示例）：环境性质声明 · 幂等规则 · 非用途 · 用途 · 超时秒数 · 工具类别 · 工具名称 · 生效时间 · 版本状态 · 默认值 · 参数名称 · 必需状态 · 模式定义 · 类型规则 · 单位与取值规则 · 校验规则 · 结果名称 · 结果状态 · 权限校验规则 · 所需权限 · 前置规则 · 起始状态 · 守卫条件 · 目标状态 · 触发 · 错误代码 · 错误条件 · 重试规则 · 可重试性 · 环境状态 · 环境版本 · 快照时间 · 期望错误 · 期望输出 · 期望状态 · 情景类型 · 任务输入 · 任务时间 · 实际错误 · 实际输出 · 实际状态 · 结果可用时间 · 判分明细 · 评分状态 · 检查点快照 · 检查点状态 · 评分器状态 · 评分规则 · 数据集状态 · 输入载荷 · 随机种子 · 复核状态 · 复核时间 · 处理方式 · 问题代码 · 检查点标识 · 任务标识 · 数据性质 · 错误标识 · 工具规范标识 · 参数标识 · 权限标识 · 前置条件标识 · 数据质量项标识 · 结果结构标识 · 复核标识 · 评分方标识 · 环境标识 · 运行标识 · 合成样本标识 · 沿袭标识 · 来源状态 · 合成样本状态 · 候选标识 · 候选类别 · 候选状态 · 覆盖标识 · 技术候选数 · 真实临床环境数 · 真实临床工具轨迹数 · 状态机标识 · 版本标识。
实体关系 3 组：一份工具规范连接参数结构、返回结果结构、权限范围、前置条件、状态转移、错误分类与版本 · 模拟环境与合成样本集连接可复跑的任务输入、检查点与运行记录 · 模拟任务把期望状态、期望输出与期望错误对上实际状态、实际输出与实际错误，并连接评分明细。
数据集组织形式：工具规范清单 ＋ 单一工具文件夹 ＋ 元数据文件；工具文件夹内含参数与结果模式、权限与前置条件、状态机与错误分类；另有模拟任务与运行、检查点与评分器。。
数据量：按项目商定。
字段范围：按项目的数据来源与加工范围商定。
交付与供应方式：数据集交付：清单 CSV／Parquet ＋ 单一对象文件夹 ＋ Meta.jsonl／Parquet；API 调用；Token 计量；数巨有谱可信数据空间连接器合约使用。
数据取得方式：数据资源持有方书面授权。
数据来源机构：医疗机构（含等级医院、社区医院及康复机构、疾控机构）。
数据加工机构：数巨有谱或数据资源持有方。
数据经营机构：数巨有谱（经营权权利人）。
许可：评估与研究使用许可。
更新日期：2026-08-05。

## 样例

一份自产的临床记录查询工具规范。用途：按就诊键与字段白名单读取结构化记录。非用途：不写入病历，不形成诊断处方或执行结论。参数与结果各有可校验的模式。另声明所需权限、前置条件、超时秒数与幂等规则。幂等规则是：同一请求标识与同一规范化输入，得到同一状态和同一响应。状态机逐条列出从就绪到运行、再到成功的迁移及其守卫条件。错误分类给出错误码、触发条件、是否可重试与重试规则。围绕这份规范配三个模拟任务：成功、无效输入、依赖或状态错误。每个任务在运行前写定期望状态、期望输出与期望错误。运行时把三项实际与三项期望逐项比对，并落检查点。

## 使用场景

- 医疗科技企业 · 智能体工具接入｜工具接口的可执行契约｜获得：用途边界、幂等规则与重试策略均已固化的可执行工具契约
- 医疗信息化企业 · 系统集成与联调｜不接入真实业务系统的离线联调环境｜获得：异常分支齐备、输入可重建的离线联调环境
- 医院信息部门 · 智能应用接口准入｜接入前的行为边界核对｜获得：权限、前置条件与超时都可逐条核对的接口准入依据
- 高校与科研机构 · 工具使用与状态机研究｜受控环境下的工具行为实验｜获得：状态覆盖可计算、错误可定向触发的工具行为实验环境

## 常见问题

问：医疗工具规范与模拟环境数据包含哪些内容？
答：医疗工具规范与模拟环境数据（SHP-MED-08-055）给出医疗工具的接口规范，配一套可复跑的模拟环境。规范写明用途与非用途、参数与结果模式、权限与前置条件，另有状态机、错误码与可重试性、幂等规则与超时。

问：工具规范与模拟环境适合做什么？
答：医疗工具规范与模拟环境数据（SHP-MED-08-055）用于智能体的工具接入与离线联调，也可用于院内接口准入前的行为边界核对。模拟任务运行前先声明期望状态、期望输出与期望错误，运行结果与之逐项比对。

问：样例能看到什么？交付形态是什么？
答：公开样例展示医疗工具规范与模拟环境数据（SHP-MED-08-055）的一份工具规范：参数与结果模式、权限与前置条件、状态机与错误分类、模拟任务与检查点。交付为工具规范清单加单一工具文件夹与元数据文件，另支持 API 调用。

问：起订量是多少？可以怎么定制？
答：医疗工具规范与模拟环境数据（SHP-MED-08-055）起订量为 30 份工具规范及配套模拟任务，范围按单一工具类别或全工具类别组合确定。参数与结果模式复杂度、状态机分支数、错误码覆盖范围、模拟情景配比与环境版本可选配。

问：和哪些产品配合使用？
答：医疗工具规范与模拟环境数据（SHP-MED-08-055）是临床工具调用轨迹数据（SHP-MED-08-051）的运行依据，两者可成套取用。模拟环境的输入可用结构化电子病历合成数据（SHP-MED-09-056）。


## 关联数据集

- SHP-MED-08-051 临床工具调用轨迹数据：按本规范运行所产生的调用轨迹
- SHP-MED-08-054 错误恢复与人工接管轨迹数据：错误码与可重试性下游的恢复轨迹
- SHP-MED-09-056 结构化电子病历合成数据：可作为模拟环境输入的合成记录

页面：https://www.shujuyoupu.com/datasets/catalog/products/SHP-MED-08-055/