benchling-integration

Benchling 集成技能

技能概述

Benchling Integration 是一个生命科学研究平台集成技能，提供 Python SDK 和 REST API 访问，帮助用户自动化管理生物序列、实验室库存、电子实验记录本和工作流程。

适用场景

1. 生物序列和注册表管理

当你需要通过 Python 代码批量创建、更新或查询 DNA、RNA、蛋白质序列时，这个技能可以帮你快速完成。支持从 FASTA 文件批量导入序列、自动注册到注册表、管理自定义实体等操作，适合需要处理大量生物数据的研究场景。

2. 实验室库存自动化

对于需要管理样本、容器、盒子位置等物理库存的实验室，可以使用这个技能实现库存追踪自动化。包括创建容器、管理储存位置、执行库存转移、批量盘点等操作，特别适合高通量实验场景。

3. 工作流程自动化集成

如果你的实验室使用 Benchling 工作流系统，这个技能可以帮助你自动创建和更新工作流任务、监听任务状态变化、触发下游流程。结合 AWS EventBridge 还能实现事件驱动的实时集成，适合需要将 Benchling 与其他系统连接的场景。

核心功能

1. 生物序列管理

通过类型化的 Python SDK 类管理 DNA、RNA、氨基酸序列和自定义实体。支持创建序列、更新属性、分页列表查询、归档操作等完整的 CRUD 功能。可以设置序列的环形/线性状态、自定义字段、注册表注册等属性。

2. 库存和样本管理

管理实验室物理库存，包括容器、盒子、位置和培养皿的创建与追踪。支持库存转移、签入签出、批量操作等功能。可以自动记录浓度、制备日期等自定义字段，实现库存信息的全面数字化。

3. 电子实验记录本和工作流

创建和查询 ELN 实验记录条目，将生物实体和结果链接到实验记录。管理工作流任务的创建、状态更新和分配。支持异步操作和任务进度监控，适合构建端到端的实验室自动化流程。

常见问题

Benchling Python SDK 如何安装和配置？

安装非常简单，使用 uv pip install benchling-sdk 或 poetry add benchling-sdk 即可。配置时需要从 Benchling 个人设置中获取 API 密钥，然后使用 ApiKeyAuth 或 OAuth Client Credentials 进行认证。所有 API 请求都需要 HTTPS 连接。

怎么用 Benchling API 批量导入 DNA 序列？

可以使用 SDK 配合 BioPython 的 SeqIO 模块实现。遍历 FASTA 文件中的每条记录，调用 benchling.dna_sequences.create() 方法创建序列。SDK 支持生成器模式的分页，内存效率很高，适合处理大量序列数据。

Benchling 库存转移如何自动化？

使用 benchling.containers.transfer() 方法可以将容器转移到新位置。支持批量转移操作，可以一次性处理多个容器的位置更新。结合工作流任务系统，可以在实验完成后自动将样本移动到指定储存位置。

Benchling API 调用失败如何处理？

SDK 内置了自动重试机制，对于 429、502、503、504 状态码会自动重试最多 5 次，使用指数退避策略。你也可以自定义 RetryStrategy 来调整重试次数和间隔。对于异步操作，可以使用 wait_for_task 辅助函数等待任务完成。

这个技能需要什么前置条件？

使用此技能需要拥有 Benchling 账户和 API 密钥。API 密钥从 Benchling 的 Profile Settings 中获取。认证权限与你账号在 UI 中的权限一致。建议将 API 密钥存储在环境变量中，不要提交到版本控制系统。