用途:面向生命科学研发场景,通过 Python SDK 与 REST API 以编程方式访问 Benchling 云平台,涵盖注册表实体、库存、电子实验记录本(ELN)与工作流,并支持构建 Benchling Apps、查询数据仓库及与外部系统同步数据。
主要能力:认证与初始化(API Key 或 OAuth 客户端凭证);注册表与实体管理(DNA、RNA、氨基酸序列、自定义实体、混合物的创建、读取、更新、归档与分页列表);库存管理(容器、盒子、位置、板,转移与批量操作);实验记录(条目创建更新、模板、实体关联、导出);工作流自动化(任务创建、状态更新、异步任务等待);事件与集成(通过 AWS EventBridge 订阅实体、库存、工作流、条目等事件);数据仓库与 SQL 分析。
使用方式:安装 SDK 可用 uv pip install benchling-sdk 或 poetry add benchling-sdk。API Key 认证示例:from benchling_sdk.benchling import Benchling;from benchling_sdk.auth.api_key_auth import ApiKeyAuth;benchling = Benchling(url="https://your-tenant.benchling.com", auth_method=ApiKeyAuth("your_api_key"))。OAuth 客户端凭证使用 ClientCredentialsOAuth2。实体操作遵循 create/get/list/update/archive 模式,自定义字段用 benchling.models.fields({...}) 传入。
适用场景:批量导入序列、库存审计、工作流自动化、数据导出、与外部数据库或分析工具(Jupyter、BI 工具)集成。
限制:需有效 Benchling 租户与凭证,权限与 UI 用户权限一致;所有请求须 HTTPS;注册实体时 entity_registry_id 与 naming_strategy 只能二选一;部分操作异步需等待任务完成;SDK 对 429、502、503、504 自动重试。具体价格、平台支持范围等资料暂未提供。