[ PROMPT_NODE_26944 ]
Opentrons Integration API 参考
[ SKILL_DOCUMENTATION ]
# Opentrons Python 协议 API v2 参考
## 协议上下文方法
### 实验室器皿管理
| 方法 | 描述 | 返回值 |
|--------|-------------|---------|
| `load_labware(name, location, label=None, namespace=None, version=None)` | 在工作台上加载器皿 | Labware 对象 |
| `load_adapter(name, location, namespace=None, version=None)` | 在工作台上加载适配器 | Labware 对象 |
| `load_labware_from_definition(definition, location, label=None)` | 从 JSON 加载自定义器皿 | Labware 对象 |
| `load_labware_on_adapter(name, adapter, label=None)` | 在适配器上加载器皿 | Labware 对象 |
| `load_labware_by_name(name, location, label=None, namespace=None, version=None)` | 替代加载方法 | Labware 对象 |
| `load_lid_stack(load_name, location, quantity=None)` | 加载盖子堆叠 (仅限 Flex) | Labware 对象 |
### 仪器管理
| 方法 | 描述 | 返回值 |
|--------|-------------|---------|
| `load_instrument(instrument_name, mount, tip_racks=None, replace=False)` | 加载移液器 | InstrumentContext |
### 模块管理
| 方法 | 描述 | 返回值 |
|--------|-------------|---------|
| `load_module(module_name, location=None, configuration=None)` | 加载硬件模块 | ModuleContext |
### 液体管理
| 方法 | 描述 | 返回值 |
|--------|-------------|---------|
| `define_liquid(name, description=None, display_color=None)` | 定义液体类型 | Liquid 对象 |
### 执行控制
| 方法 | 描述 | 返回值 |
|--------|-------------|---------|
| `pause(msg=None)` | 暂停协议执行 | None |
| `resume()` | 暂停后恢复 | None |
| `delay(seconds=0, minutes=0, msg=None)` | 延迟执行 | None |
| `comment(msg)` | 在协议日志中添加注释 | None |
| `home()` | 所有轴归位 | None |
| `set_rail_lights(on)` | 控制导轨灯 (仅限 Flex) | None |
### 协议属性
| 属性 | 描述 | 类型 |
|----------|-------------|------|
| `deck` | 工作台布局 | Deck 对象 |
| `fixed_trash` | 固定垃圾桶位置 (OT-2) | TrashBin 对象 |
| `loaded_labwares` | 已加载器皿字典 | Dict |
| `loaded_instruments` | 已加载仪器字典 | Dict |
| `loaded_modules` | 已加载模块字典 | Dict |
| `is_simulating()` | 检查协议是否处于模拟状态 | Bool |
| `bundled_data` | 访问捆绑数据文件 | Dict |
| `params` | 运行时参数 | ParametersContext |
## 仪器上下文 (移液器) 方法
### 吸头管理
| 方法 |