用途:通过 Benchling Python SDK 与 REST API 以编程方式访问生命科学研发云平台,管理注册表实体(DNA、RNA、蛋白质)、库存、电子实验记录(ELN)、工作流,并构建 Benchling Apps 与数据仓库查询。示例基于 benchling-sdk 1.25.0。
主要能力:认证与初始化(API Key 或 OAuth 客户端凭证);注册表实体创建、读取、更新、归档与分页列表;库存容器、盒子、位置、转移与批量操作;ELN 条目创建、模板管理与实体关联;工作流任务创建、状态更新与异步任务轮询;通过 AWS EventBridge 或 Webhook 订阅事件;数据仓库 SQL 查询与外部分析工具集成。
使用方式:安装 uv pip install "benchling-sdk==1.25.0";设置环境变量 BENCHLING_TENANT_URL 与 BENCHLING_API_KEY(OAuth 另需 BENCHLING_CLIENT_ID、BENCHLING_CLIENT_SECRET),仅读取所需命名键;用 Benchling(url=..., auth_method=ApiKeyAuth(api_key)) 初始化,建议先用 benchling.users.get_me() 验证凭据。实体操作如 benchling.dna_sequences.create(DnaSequenceCreate(...)),列表返回生成器,可用 estimated_count() 估算总数;自定义字段用 benchling.models.fields({...})。异步任务可用 wait_for_task 轮询,默认 max_wait_seconds 为 600 秒。
适用场景:批量实体导入、库存审计、工作流自动化、数据导出、事件驱动集成与合规报告。
限制:所有请求须走 HTTPS 且仅指向自有租户 URL;权限与 UI 一致;EventBridge 事件不重放,需用 List Events API 恢复约两周内事件;载荷超 256 KB 需按 apiURL 重新获取;预览版 SDK 为 alpha,不建议用于生产;密钥不得提交版本库。具体收费、价格与平台支持范围资料未提供。