用途:该技能面向 Opentrons Flex 与 OT-2 机器人,用 Python 的 Protocol API v2 编写实验室自动化协议,覆盖移液流程与硬件模块控制,并支持在机器人执行前进行模拟测试。
主要能力: 协议结构:从 opentrons 导入 protocol_api,定义 metadata(protocolName、author、description、apiLevel,建议用最新稳定版本)与可选 requirements(robotType、apiLevel),在 run(protocol) 内编写逻辑。 硬件加载:用 protocol.load_instrument 加载单/多通道移液器(Flex 如 p1000_single_flex,OT-2 如 p300_single_gen2);load_labware 加载耗材(Flex 槽位 A1-D3,OT-2 为 1-11);load_adapter 加载适配器;load_module 加载温控、磁力、加热振荡(heaterShakerModuleV1)、热循环(thermocyclerModuleV2)等模块。 移液操作:支持 pick_up_tip、aspirate、dispense、drop_tip、return_tip,以及 transfer、distribute、consolidate、mix、air_gap、blow_out、touch_tip;可通过 flow_rate 调整流速。 位置访问:按名称(plate['A1'])、索引 wells()、行 rows()、列 columns()、wells_by_name() 取孔,并用 top()、bottom()、center() 及 z 偏移定位。 模块控制:温控模块 set_temperature/await_temperature/deactivate;磁力模块 engage(height_from_base)/disengage;加热振荡模块设定温度、转速、锁存器开合;热循环模块开合盖、设盖温与块温、execute_profile 执行 PCR 循环;还提及读板器 read(wavelengths=[...])。 液体追踪:define_liquid 与 load_liquid 标注孔内液体,load_empty 标记空孔。 流程控制:pause、delay、comment、home、is_simulating 判断,Flex 支持 set_rail_lights。 常用模式:串行稀释、板复制、PCR 配置等。
限制与注意事项:资料建议始终指定 API 级别、为耗材加有意义标签、确认吸头数量充足、先用模拟测试再上机、必要时加暂停等待人工干预、用液体追踪便于校验、合理选择 new_tip 以省吸头、对粘稠或易挥发液体调整流速;常见问题包括吸头不足、耗材碰撞、体积超限、模块未响应、移液不准、模拟失败等。更详细 API 见技能目录 references/api_reference.md,示例模板见 scripts/ 目录。