用途:面向生命科学研发场景,通过 Benchling 的 Python SDK 与 REST API 以编程方式访问注册表实体(DNA、RNA、氨基酸序列、自定义实体、混合物)、库存、电子实验记录本(ELN)与工作流,并支持构建 Benchling Apps、查询数据仓库及事件驱动集成。
主要能力:认证与初始化(API Key 或 OAuth 客户端凭证);注册表实体创建、读取、更新、归档与分页列举;库存管理(容器、盒子、位置、板、转移、出入库、批量操作);ELN 条目、模板与实体关联;工作流任务创建、状态更新与异步任务等待;通过 AWS EventBridge 订阅实体、库存、工作流、条目等事件;通过 SQL 访问数据仓库做分析与报表。
使用方式:安装 SDK 可用 uv pip install benchling-sdk 或 poetry add benchling-sdk。初始化示例:Benchling(url="https://your-tenant.benchling.com", auth_method=ApiKeyAuth("your_api_key"));应用场景可用 ClientCredentialsOAuth2。实体操作如 benchling.dna_sequences.create(DnaSequenceCreate(...)),列表返回生成器,可用 estimated_count() 估算总数。自定义字段用 benchling.models.fields({...})。异步任务可用 wait_for_task 等待完成。
适用场景:批量导入序列、库存审计、工作流自动化、数据导出、与外部系统同步、合规报表与 BI 分析。
限制与注意:API 密钥需在 Benchling 个人设置中获取并安全存储,勿提交到版本控制;所有请求需 HTTPS;权限与 UI 用户权限一致;注册实体时 entity_registry_id 与 naming_strategy 只能二选一;SDK 对 429、502、503、504 自动重试(最多 5 次指数退避),可自定义 RetryStrategy;未知枚举值与多态类型会被保留以保持前向兼容。具体事件模式、数据仓库连接凭据与配置细节请参考官方文档,本资料未提供完整细节。