Adaptyv Bio Foundry API - 蛋白质实验云平台集成技能

技能概述

Adaptyv 技能提供蛋白质实验云平台的完整 API 集成方案，帮助开发者通过 Python SDK 或 REST API 将氨基酸序列提交给自动化实验室，执行结合测定、热稳定性检测、表达分析和荧光实验，约 21 天内获取实验结果。

适用场景

1. 蛋白质药物研发筛选 需要高通量筛选蛋白质变体结合能力的药物研发团队，可通过 API 批量提交序列，使用 BLI 或 SPR 方法测定结合亲和力，自动化获取筛选结果。

2. 蛋白质工程实验设计 蛋白质工程师设计热稳定性改进或表达优化的变体时，可通过云实验室快速验证设计方案，无需等待线下实验周期。

3. 生物信息学工作流集成 研究团队将蛋白质设计算法与实验验证集成，从计算预测到实验数据的全流程自动化，实现设计-构建-测试-学习的闭环。

核心功能

1. 多样化实验类型支持 支持亲和力测定（affinity）、结合筛选（screening）、热稳定性分析（thermostability）、表达量检测（expression）和荧光强度测定（fluorescence）五种实验类型，BLI 和 SPR 两种方法可选，满足不同研究需求。

2. Python SDK 和 REST API 双模式 提供 @lab.experiment 装饰器和 FoundryClient 客户端两种开发模式，支持从简单脚本到复杂管道的不同集成场景，环境变量自动读取 API 密钥，符合安全最佳实践。

3. 完整的实验生命周期管理 从草稿创建、成本估算、报价确认到材料准备、实验执行、数据分析、结果检索的全流程 API 支持，可通过 webhook 实时监控状态变化，支持自动接受报价的管道化运行。

常见问题

Adaptyv Bio Foundry API 是什么？如何使用？

Adaptyv Bio Foundry API 是云实验室的服务接口，开发者可通过 Python SDK 或 REST API 提交蛋白质序列，由自动化实验室执行实验并返回结果。使用前需要从 foundry.adaptyvbio.com 获取 API 密钥，安装 adaptyv-sdk 后即可通过 FoundryClient 或装饰器模式调用服务。

如何获取 Adaptyv API 密钥？

访问 foundry.adaptyvbio.com 注册账户后，在侧边栏可生成 Bearer Token。建议将密钥存储为环境变量 ADAPTYV_API_KEY 或项目的 .env 文件中，SDK 会自动读取，避免硬编码在代码中。

蛋白质实验需要多长时间能出结果？

从提交序列到获取完整结果通常需要约 21 天，包括基因合成、材料准备、实验执行、数据分析和质量验证。实验状态会通过 API 和 webhook 实时更新，可跟踪从 Draft 到 Done 的完整流程。

支持哪些类型的蛋白质实验？

平台支持五种实验类型：亲和力测定（测量 KD、kon、koff 动力学参数）、结合筛选（是/否结合判断）、热稳定性测定（熔点温度 Tm）、表达量分析（表达产量）和荧光强度检测。亲和力和筛选实验需要指定靶蛋白，其他三种可直接提交序列。

如何使用 webhook 监控实验状态？

在创建实验时传入 webhook_url 参数，Adaptyv 会在每次状态变化时向该 URL 发送 POST 请求，包含实验 ID、旧状态和新状态。适合自动化管道中集成状态通知，无需定时轮询即可实时响应实验进度。

BLI 和 SPR 测定有什么区别？

BLI（生物层干涉技术）和 SPR（表面等离子共振）都是测量分子结合相互作用的方法。两者都可用于亲和力测定和结合筛选，选择取决于具体实验需求和靶蛋白特性。API 允许在实验规范中指定 method 为 "bli" 或 "spr"。

实验结果如何通过 API 获取？

实验状态变为 Done 后，使用 client.experiments.get_results(experiment_id) 方法获取结果数据。结果包含实验测量的原始数据、分析结论和质量指标。结果状态字段显示为 none、partial 或 all，部分完成时也可获取中间数据。