用途:面向 Benchling 生命科学研发云平台的程序化集成,通过 Python SDK 与 REST API 管理生物序列、库存、实验记录与工作流,并支持数据仓库分析与事件驱动同步。
主要能力:
- 认证与初始化:支持 API Key 与 OAuth 客户端凭证两种方式。安装命令为 uv pip install benchling-sdk 或 poetry add benchling-sdk。
- 注册表实体管理:创建、读取、更新、归档 DNA/RNA/氨基酸序列、自定义实体与混合物,支持注册到注册表及命名策略。
- 库存管理:创建容器、盒子、位置、板,更新属性,转移物品,批量操作。
- 实验记录:创建与更新 ELN 条目、模板,关联实体与结果,导出文档。
- 工作流自动化:创建任务、更新状态与分配、异步批量操作与进度监控。
- 事件与集成:通过 AWS EventBridge 订阅实体、库存、工作流、条目等事件,路由到 Lambda 等目标。
- 数据仓库:使用 SQL 查询历史数据,用于聚合结果、库存趋势、合规报告,可对接 Jupyter、BI 工具。
使用方式:安装 SDK 后,用 Benchling(url=..., auth_method=...) 初始化客户端,再调用 benchling.dna_sequences、containers、entries、workflow_tasks 等资源方法。列表接口返回生成器,可用 estimated_count() 估算总数;自定义字段用 benchling.models.fields() 包装。SDK 对 429、502、503、504 自动重试,最多 5 次指数退避,可通过 RetryStrategy 调整。
适用场景:批量导入 FASTA 序列、库存审计、工作流自动校验与状态更新、数据导出到 CSV 或数据库、与外部系统同步。
限制与注意:API Key 从 Benchling 个人设置获取,权限与 UI 用户一致;凭证应存于环境变量,切勿提交到版本控制;所有请求需 HTTPS;注册实体时 entity_registry_id 与 naming_strategy 只能二选一;部分操作异步,需用 wait_for_task 等待。具体价格、配额与平台支持范围资料未提供。