opentrons-integration

# Opentrons 集成 ## 概述 Opentrons 是一个基于 Python 的实验室自动化平台，适用于 Flex 和 OT-2 机器人。编写 Protocol API v2 协议以进行液体处理、控制硬件模块（加热振荡器、热循环仪）、管理实验室器皿，实现自动化移液工作流。 ## 何时使用此技能 在以下场景中使用此技能： - 使用 Python 编写 Opentrons Protocol API v2 协议 - 在 Flex 或 OT-2 机器人上自动化液体处理工作流 - 控制硬件模块（温度、磁力、加热振荡器、热循环仪） - 设置实验室器皿配置和工作台布局 - 实现复杂的移液操作（梯度稀释、板复制、PCR 设置） - 管理吸头使用并优化协议效率 - 使用多通道移液器进行 96 孔板操作 - 在机器人执行前模拟和测试协议 ## 核心能力 ### 1. 协议结构与元数据 每个 Opentrons 协议都遵循标准结构： python from opentrons import protocol_api # 元数据 metadata = { 'protocolName': '我的协议', 'author': '姓名 ', 'description': '协议描述', 'apiLevel': '2.19' # 使用最新的 API 版本 } # 要求 (可选) requirements = { 'robotType': 'Flex', # 或 'OT-2' 'apiLevel': '2.19' } # 运行函数 def run(protocol: protocol_api.ProtocolContext): # 协议命令写在这里 pass **关键要素：** - 从 `opentrons` 导入 `protocol_api` - 定义包含 protocolName, author, description, apiLevel 的 `metadata` 字典 - 可选的 `requirements` 字典用于指定机器人类型和 API 版本 - 实现接收 `ProtocolContext` 作为参数的 `run()` 函数 - 所有协议逻辑都必须放在 `run()` 函数内部 ### 2. 加载硬件 **加载仪器（移液器）：** python def run(protocol: protocol_api.ProtocolContext): # 在特定安装位加载移液器 left_pipette = protocol.load_instrument( 'p1000_single_flex', # 仪器名称 'left', # 安装位: 'left' 或 'right' tip_racks=[tip_rack] # 吸头盒实验室器皿对象列表 ) 常见移液器名称： - Flex: `p50_single_flex`, `p1000_single_flex`, `p50_multi_flex`, `p1000_multi_flex` - OT-2: `p20_single_gen2`, `p300_single_gen2`, `p1000_single_gen2`, `p20_multi_gen2`, `p300_multi_gen2` **加载实验室器皿：** python # 直接在工作台上加载器皿 plate = protocol.load_labware( 'corning_96_wellplate_360ul_flat