用途
benchling-integration 用于以编程方式集成 Benchling 生命科学研发云平台。当需要操作 Benchling 的 Python SDK 或 REST API、管理生物序列与注册表实体、自动化库存操作、创建或查询电子实验记录本条目、构建工作流自动化或 Benchling Apps、在 Benchling 与外部系统之间同步数据、查询 Data Warehouse 进行分析，或配置基于 AWS EventBridge 的事件驱动集成时，可使用本技能。
主要能力
认证与初始化
提供 Python SDK 安装方式：uv pip install benchling-sdk，或使用 Poetry：poetry add benchling-sdk。支持两种认证方式：API Key 认证（推荐用于脚本）与 OAuth 客户端凭证（用于 Apps）。API Key 可从 Benchling 的 Profile Settings 获取，凭据应安全存储（如环境变量或密码管理器），所有 API 请求要求 HTTPS，认证权限与用户在 UI 中的权限一致。
注册表与实体管理
注册表实体包括 DNA 序列、RNA 序列、氨基酸序列、自定义实体与混合物。SDK 提供类型化类进行创建与管理，支持创建、读取、更新、归档等操作。创建 DNA 序列时可指定名称、碱基、是否环状、文件夹 ID、schema ID 及自定义字段。注册表注册时可在创建时直接注册实体，需注意 entity_registry_id 与 naming_strategy 二者只能使用其一。更新实体时未指定的字段保持不变，支持部分更新。列表操作返回生成器，可内存高效地分页遍历，并可通过 estimated_count() 查看总数。
库存管理
可管理 Benchling 库存系统中的物理样品、容器、盒子和位置。支持创建容器与盒子、更新库存项属性、在位置之间转移物品、检出/检入物品，以及批量操作。
笔记本与文档
可与电子实验记录本（ELN）条目、协议和模板交互。支持创建和更新实验记录本条目、管理条目模板、将实体和结果链接到条目，以及导出条目用于文档记录。
工作流与自动化
可自动化实验室流程。支持创建和管理工作流任务、更新任务状态与分配、以异步方式执行批量操作并监控任务进度。部分操作是异步的，会返回任务，可使用 wait_for_task 等待完成。
事件与集成
可订阅 Benchling 事件以实现实时集成，使用 AWS EventBridge。事件类型包括实体创建、更新、归档，库存转移，工作流任务状态变更，条目创建与更新，结果注册等。集成模式为：在 Benchling 设置中配置事件路由到 AWS EventBridge，创建 EventBridge 规则过滤事件，将事件路由到 Lambda 函数或其他目标，处理事件并更新外部系统。
数据仓库与分析
可通过 Data Warehouse 使用 SQL 查询历史 Benchling 数据，用于分析与报告。使用标准 SQL 客户端及提供的凭据连接，可用于汇总实验结果、分析库存趋势、生成合规报告、导出数据供外部分析，并可集成 Jupyter notebooks、BI 工具（Tableau、Looker、PowerBI）及自定义仪表板。
使用方式
通过 Python SDK 进行认证与调用。SDK 会自动重试失败的请求（针对 429、502、503、504 状态码，最多 5 次指数退避重试），可自定义重试行为。列表操作使用生成器进行内存高效的分页遍历。自定义 schema 字段可使用 fields() 辅助方法将字典转换为 Fields 对象。SDK 具备前向兼容性，会优雅处理未知枚举值与类型。
安全注意事项：切勿将 API Key 提交到版本控制，使用环境变量存储凭据，若凭据泄露应轮换密钥，为 Apps 授予最小必要权限，多用户场景使用 OAuth。
参考资料包括 authentication.md（认证指南、OIDC、安全最佳实践）、sdk_reference.md（Python SDK 详细参考与高级模式）、api_endpoints.md（REST API 端点参考）。
适用场景
- 批量实体导入：例如从 FASTA 文件导入多条序列。
- 库存审计：例如列出特定位置的所有容器。
- 工作流自动化：例如更新某个工作流的所有待处理任务。
- 数据导出：例如导出具有特定属性的所有序列并保存为 CSV 或数据库。
- 将 Benchling 数据同步到外部数据库、在工作流完成时触发下游流程、在实体变更时发送通知、审计追踪日志记录。
限制
关于该技能的收费、价格等信息暂未提供。本技能仅覆盖资料中明确描述的能力，具体功能是否可用取决于 Benchling 平台本身及用户权限。