SuperAPI AI 工具集

opentrons-app

通用与其它

查看项目

更新于 10-16 04:53

技能介绍

用途:通过 open-computer-use / ocu CLI 或其 MCP 工具操作官方 Opentrons 桌面应用,用于检查机器人连接、健康与校准状态、协议分析与运行日志,而非编写移液逻辑。

主要能力:列出可见应用并定位 Opentrons App;在机器人、协议、设备、校准、运行详情等视图间导航;读取连接状态、健康状态、校准状态、运行日志与警告;查看已导入协议及其分析结果。

使用方式:工具未暴露时先用 ocu -h 确认可用;若应用未运行,请用户自行打开(Windows 与 Linux 上不要假设可代为启动)。调用 list_apps 获取精确应用或进程名,再调用 get_app_state(文本被截断时用 text_limit: 1000 或 "max")。优先使用当前 element_index 与语义操作,仅在无障碍树未暴露目标时使用窗口相对坐标。导航、模态对话框、机器人重连、协议导入或操作失败后需重新读取状态,重大 UI 变化后不得复用旧索引。示例:ocu call list_apps;ocu call get_app_state --args '{"app":"Opentrons","text_limit":1000}';依赖最新元素映射时可用单进程序列 ocu call --calls '[{"tool":"get_app_state","args":{"app":"Opentrons"}},{"tool":"click","args":{"app":"Opentrons","element_index":"REPLACE_WITH_CURRENT_INDEX"}}]',索引须由紧邻的前一次状态推导,不得硬编码。

安全边界:只读操作(列应用、查看状态与日志、浏览视图、审阅协议分析)在用户请求范围内无需额外批准。回零或移动硬件、启动/恢复/取消/停止运行(用户报告正在发生的危险需立即停止除外)、启动各类校准、确认会推进到硬件移动的甲板设置、更新固件或应用、删除协议/运行/机器人/校准数据、导入用户未明确要求的协议,均须事先获得明确批准。批准硬件移动前,需用户确认目标机器人已选中且可物理触及、甲板与显示的耗材/模块/适配器/槽位一致、移液器与吸头符合协议、甲板无障碍且门或安全罩处于要求状态、液体身份/体积/源目标孔已独立复核。不得仅凭 GUI 推断物理甲板正确,不得在未向用户解释的情况下忽略或绕过碰撞、校准、门、固件、耗材或协议分析警告。

协议边界:本技能只操作应用,不生成移液逻辑;需要生成或验证协议时先用 opentrons-machine 或 opentrons-workflow 技能,协议产物与物理设置复核后再回到本技能。

完成报告应包含:所选机器人与连接状态、当前应用界面与运行状态、相关协议名称与分析状态、观察到的警告或不一致、已执行或等待批准的操作、批准操作后的刷新状态。