如何用 benchling-integration 技能把 AI agent 接入 Benchling 研发数据平台【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills这篇文档面向需要在 Cursor、Claude Code、Codex 等支持 Agent Skills 标准的 AI agent 中接入 Benchling 的开发者。目标是一条连续的集成路径把 scientific-agent-skills 仓库里的benchling-integration技能装进 agent配置租户凭证安装benchling-sdk初始化客户端并通过/users/me端点验证认证真正生效最后跑一次对 DNA 序列库的查询。前提是你已经有一个 Benchling 账号、租户 URL以及 API key 或 OAuth 应用凭证技能 frontmatter 中声明BENCHLING_TENANT_URL为必需API key 或 OAuth 二选一。所有 API 请求必须走 HTTPS 且只发往你的租户 URL。准备条件环境、依赖与 Benchling 凭证按照 README.md 的 Prerequisites 与 skills/benchling-integration/references/sdk_reference.md 的 Requirements你需要准备Agent 客户端任何支持 Agent Skills 标准的客户端README 列出 Cursor、Claude Code、Codex、Gemini CLI、Google Antigravity 等uv技能依赖的安装都通过uv完成可用uv --version确认已装好Pythonbenchling-sdk要求 Python 3.93.12 的支持自 SDK 1.11.0 起仓库推荐 3.11Benchling 侧租户已启用 API 访问如果要使用应用apps和事件还需要租户管理员授予 Developer Platform 访问权限。API key 的获取路径在 skills/benchling-integration/references/authentication.md 中写得很明确登录 Benchling → 进入 Profile Settings → 找到 API Key 部分 → 生成新 key。key 只会显示一次需要立即妥善保存。API key 走的是 HTTP Basic 认证key 作为用户名、密码留空这一点直接影响后面 curl 验证命令里-u key:的写法。把技能安装进 agent 并确认可被发现README.md 的 Getting Started 给出三种安装方式任选其一# 方式一npx支持的标准安装器适用于 Claude Code、Codex、Gemini CLI、Google Antigravity、Cursor 等 npx skills add K-Dense-AI/scientific-agent-skills# 方式二GitHub CLIgh v2.90.0直接安装单个技能 gh skill install K-Dense-AI/scientific-agent-skills benchling-integrationREADME 也支持版本固定--pin v2.65.0或 commit SHA如果需要可复现安装可以加上。# 方式三手动克隆到 agent 的技能扫描目录用户级或项目级 git clone https://github.com/K-Dense-AI/scientific-agent-skills.git ~/.agents/skills/scientific-agent-skills手动安装时的判断依据来自 README 的 Troubleshooting「Skills not loading」一节技能文件夹必须在 agent 配置的目录内每个技能文件夹必须包含SKILL.mdbenchling-integration 的技能入口 符合这一结构装完后重启 agent/IDE。在 Cursor 里可以进一步到 Settings → Rules 确认技能已被发现。技能装好之后不需要额外配置 agentREADME 说明兼容的宿主会从配置路径自动发现技能你也可以在 prompt 里直接提到技能名手动触发。有一个环境边界要注意如果 agent 运行在 NemoClawNVIDIA OpenShell默认拒绝出站网络里所有需要网络的技能——包括 Benchling 调用——都要先由操作员在 OpenShell TUI 中预先放行相关域名才可用。配置凭证只读具名环境变量技能的 frontmatter 声明了这些环境变量BENCHLING_TENANT_URL必需、BENCHLING_API_KEYAPI key 认证与 OAuth 二选一、BENCHLING_CLIENT_ID/BENCHLING_CLIENT_SECRETOAuth 应用以及多环境部署用的BENCHLING_PROD_TENANT_URL、BENCHLING_PROD_API_KEY、BENCHLING_STAGING_TENANT_URL、BENCHLING_STAGING_API_KEY。authentication.md 的安全实践明确要求只读取具名的环境变量不要 dump 或遍历整个os.environ不要把凭证提交到版本控制、硬编码进源码或存进明文文件。主路径API key的写法import os tenant_url os.environ.get(BENCHLING_TENANT_URL) # e.g. https://your-tenant.benchling.com api_key os.environ.get(BENCHLING_API_KEY) if not tenant_url or not api_key: raise ValueError(Set BENCHLING_TENANT_URL and BENCHLING_API_KEY)其中https://your-tenant.benchling.com是文档给出的租户 URL 示例形态替换成你自己的租户地址。多租户production/staging 并存时文档给出的模式是每个环境使用独立的具名 key 对而不是共享一组变量见 skills/benchling-integration/references/authentication.md 的 Multi-Tenant Considerations 一节。安装 benchling-sdk 并初始化客户端SDK 安装命令来自 skills/benchling-integration/references/core_capabilities.md示例统一针对 PyPI 上的稳定版1.25.0uv pip install benchling-sdk1.25.0可选分支预览构建alpha 功能文档明确标注 not for productionuv pip install benchling-sdk --prerelease allow初始化客户端来自 sdk_reference.md 的 Basic Initializationimport os from benchling_sdk.benchling import Benchling from benchling_sdk.auth.api_key_auth import ApiKeyAuth benchling Benchling( urlos.environ[BENCHLING_TENANT_URL], auth_methodApiKeyAuth(os.environ[BENCHLING_API_KEY]), )Benchling类是所有 SDK 操作的根benchling.dna_sequences、benchling.containers、benchling.entries、benchling.workflow_tasks等属性对应不同资源端点资源操作遵循统一的 CRUD 模式create/get_by_id/list/update/archive。验证连接用 /users/me 端点确认认证成功在跑任何批量操作之前core_capabilities.md 要求先用benchling.users.get_me()验证凭证。两个等价验证方式from benchling_sdk.benchling import Benchling from benchling_sdk.auth.api_key_auth import ApiKeyAuth try: benchling Benchling( urlhttps://your-tenant.benchling.com, auth_methodApiKeyAuth(your_api_key) ) user benchling.users.get_me() print(fAuthenticated as: {user.name} ({user.email})) except Exception as e: print(fAuthentication failed: {e})不想写脚本时authentication.md 给出 curl 快速测试注意 API key 后面必须带冒号、密码留空curl -X GET \ https://your-tenant.benchling.com/api/v2/users/me \ -u your_api_key: \ -v判断标准/users/me端点返回的是当前认证用户的身份信息能拿到即说明凭证与租户 URL 配对正确。用 OAuth token 时则换成-H Authorization: Bearer your_token。跑第一次数据操作查询 DNA 序列库认证通过后最小可用的数据操作是列出 DNA 序列。SDK 的list()返回生成器按页迭代sequences benchling.dna_sequences.list() for page in sequences: for seq in page: print(f{seq.name} ({seq.id})) # 不加载全部页即可估算总量 total sequences.estimated_count()如果只想看某个文件夹或 schema 下的序列用服务端过滤而不是拉全量再在客户端筛sdk_reference.md 的 Efficient Filtering 一节把后者明确标为 Bad 示例sequences benchling.dna_sequences.list( folder_idfld_abc123, # 换成你租户里真实的 folder id schema_idts_abc123 # 可选换成真实的 schema id )fld_abc123、ts_abc123这类值是文档示例中的占位 ID执行前必须替换为你租户里的真实资源 ID。另一个必须注意的坑分页生成器只能迭代一次第二次for page in sequences不会报错但拿不到任何数据需要重新调用list()生成新的生成器sdk_reference.md 的 Pagination Exhaustion 一节。遇到认证错误时按状态码排查authentication.md 的 Troubleshooting 一节把三种最常见错误与处理方式写清楚了401 Unauthorized凭证无效或过期、API key 格式不对、缺少Authorization头。按文档顺序核对凭证是否正确、key 是否已过期或被删除、header 格式是否为Authorization: Bearer tokenOAuth 场景。403 Forbidden凭证有效但权限不足——用户对资源无访问权或应用没有被授予组织/项目的访问。API 权限与 UI 权限一致被挂起的用户会失去 API 访问归档的应用在恢复前也无法调用。处理路径是在 Developer Console 给应用授予所需访问。429 Too Many Requests超过限流。文档给出的默认限流是每用户/应用 100 次请求 / 10 秒。SDK 默认对 429、502、503、504 自动做指数退避重试SKILL.md 说明默认最多 5 次重试如需调整可用RetryStrategy(max_retries3, backoff_factor0.5, status_codes_to_retry[429, 502, 503, 504])传给Benchling(...)。SDK 侧还可以捕获具体异常类型NotFoundError、ValidationError、UnauthorizedError和兜底的BenchlingError来做分支处理。此外注意字段校验规则fields里的值必须与租户 schema 匹配数值字段也以字符串传入如numeric_field: 123日期用YYYY-MM-DD下拉字段必须与选项完全一致。限制与下一步这条路径覆盖的是单用户脚本和自动化场景。文档给出的升级边界多用户生产应用应改用 OAuth 2.0 client credentialsClientCredentialsOAuth2SDK 自动处理 token 刷新在 Developer Console 注册应用并授予对组织、团队、项目、文件夹的最小必要权限企业身份提供方场景还有 OIDC 路径要求 Benchling 企业账户和带 email claim 的 IdP token。更深入的端点清单分页参数pageSize默认 50 最大 100、nextToken、错误响应结构在 skills/benchling-integration/references/api_endpoints.md库存、ELN 条目、工作流任务的完整 CRUD 示例在 skills/benchling-integration/references/sdk_reference.md事件驱动的集成AWS EventBridge 订阅则在 skills/benchling-integration/references/eventbridge.md 单独展开不在本文范围内。【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何用 benchling-integration 技能把 AI agent 接入 Benchling 研发数据平台
如何用 benchling-integration 技能把 AI agent 接入 Benchling 研发数据平台【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills这篇文档面向需要在 Cursor、Claude Code、Codex 等支持 Agent Skills 标准的 AI agent 中接入 Benchling 的开发者。目标是一条连续的集成路径把 scientific-agent-skills 仓库里的benchling-integration技能装进 agent配置租户凭证安装benchling-sdk初始化客户端并通过/users/me端点验证认证真正生效最后跑一次对 DNA 序列库的查询。前提是你已经有一个 Benchling 账号、租户 URL以及 API key 或 OAuth 应用凭证技能 frontmatter 中声明BENCHLING_TENANT_URL为必需API key 或 OAuth 二选一。所有 API 请求必须走 HTTPS 且只发往你的租户 URL。准备条件环境、依赖与 Benchling 凭证按照 README.md 的 Prerequisites 与 skills/benchling-integration/references/sdk_reference.md 的 Requirements你需要准备Agent 客户端任何支持 Agent Skills 标准的客户端README 列出 Cursor、Claude Code、Codex、Gemini CLI、Google Antigravity 等uv技能依赖的安装都通过uv完成可用uv --version确认已装好Pythonbenchling-sdk要求 Python 3.93.12 的支持自 SDK 1.11.0 起仓库推荐 3.11Benchling 侧租户已启用 API 访问如果要使用应用apps和事件还需要租户管理员授予 Developer Platform 访问权限。API key 的获取路径在 skills/benchling-integration/references/authentication.md 中写得很明确登录 Benchling → 进入 Profile Settings → 找到 API Key 部分 → 生成新 key。key 只会显示一次需要立即妥善保存。API key 走的是 HTTP Basic 认证key 作为用户名、密码留空这一点直接影响后面 curl 验证命令里-u key:的写法。把技能安装进 agent 并确认可被发现README.md 的 Getting Started 给出三种安装方式任选其一# 方式一npx支持的标准安装器适用于 Claude Code、Codex、Gemini CLI、Google Antigravity、Cursor 等 npx skills add K-Dense-AI/scientific-agent-skills# 方式二GitHub CLIgh v2.90.0直接安装单个技能 gh skill install K-Dense-AI/scientific-agent-skills benchling-integrationREADME 也支持版本固定--pin v2.65.0或 commit SHA如果需要可复现安装可以加上。# 方式三手动克隆到 agent 的技能扫描目录用户级或项目级 git clone https://github.com/K-Dense-AI/scientific-agent-skills.git ~/.agents/skills/scientific-agent-skills手动安装时的判断依据来自 README 的 Troubleshooting「Skills not loading」一节技能文件夹必须在 agent 配置的目录内每个技能文件夹必须包含SKILL.mdbenchling-integration 的技能入口 符合这一结构装完后重启 agent/IDE。在 Cursor 里可以进一步到 Settings → Rules 确认技能已被发现。技能装好之后不需要额外配置 agentREADME 说明兼容的宿主会从配置路径自动发现技能你也可以在 prompt 里直接提到技能名手动触发。有一个环境边界要注意如果 agent 运行在 NemoClawNVIDIA OpenShell默认拒绝出站网络里所有需要网络的技能——包括 Benchling 调用——都要先由操作员在 OpenShell TUI 中预先放行相关域名才可用。配置凭证只读具名环境变量技能的 frontmatter 声明了这些环境变量BENCHLING_TENANT_URL必需、BENCHLING_API_KEYAPI key 认证与 OAuth 二选一、BENCHLING_CLIENT_ID/BENCHLING_CLIENT_SECRETOAuth 应用以及多环境部署用的BENCHLING_PROD_TENANT_URL、BENCHLING_PROD_API_KEY、BENCHLING_STAGING_TENANT_URL、BENCHLING_STAGING_API_KEY。authentication.md 的安全实践明确要求只读取具名的环境变量不要 dump 或遍历整个os.environ不要把凭证提交到版本控制、硬编码进源码或存进明文文件。主路径API key的写法import os tenant_url os.environ.get(BENCHLING_TENANT_URL) # e.g. https://your-tenant.benchling.com api_key os.environ.get(BENCHLING_API_KEY) if not tenant_url or not api_key: raise ValueError(Set BENCHLING_TENANT_URL and BENCHLING_API_KEY)其中https://your-tenant.benchling.com是文档给出的租户 URL 示例形态替换成你自己的租户地址。多租户production/staging 并存时文档给出的模式是每个环境使用独立的具名 key 对而不是共享一组变量见 skills/benchling-integration/references/authentication.md 的 Multi-Tenant Considerations 一节。安装 benchling-sdk 并初始化客户端SDK 安装命令来自 skills/benchling-integration/references/core_capabilities.md示例统一针对 PyPI 上的稳定版1.25.0uv pip install benchling-sdk1.25.0可选分支预览构建alpha 功能文档明确标注 not for productionuv pip install benchling-sdk --prerelease allow初始化客户端来自 sdk_reference.md 的 Basic Initializationimport os from benchling_sdk.benchling import Benchling from benchling_sdk.auth.api_key_auth import ApiKeyAuth benchling Benchling( urlos.environ[BENCHLING_TENANT_URL], auth_methodApiKeyAuth(os.environ[BENCHLING_API_KEY]), )Benchling类是所有 SDK 操作的根benchling.dna_sequences、benchling.containers、benchling.entries、benchling.workflow_tasks等属性对应不同资源端点资源操作遵循统一的 CRUD 模式create/get_by_id/list/update/archive。验证连接用 /users/me 端点确认认证成功在跑任何批量操作之前core_capabilities.md 要求先用benchling.users.get_me()验证凭证。两个等价验证方式from benchling_sdk.benchling import Benchling from benchling_sdk.auth.api_key_auth import ApiKeyAuth try: benchling Benchling( urlhttps://your-tenant.benchling.com, auth_methodApiKeyAuth(your_api_key) ) user benchling.users.get_me() print(fAuthenticated as: {user.name} ({user.email})) except Exception as e: print(fAuthentication failed: {e})不想写脚本时authentication.md 给出 curl 快速测试注意 API key 后面必须带冒号、密码留空curl -X GET \ https://your-tenant.benchling.com/api/v2/users/me \ -u your_api_key: \ -v判断标准/users/me端点返回的是当前认证用户的身份信息能拿到即说明凭证与租户 URL 配对正确。用 OAuth token 时则换成-H Authorization: Bearer your_token。跑第一次数据操作查询 DNA 序列库认证通过后最小可用的数据操作是列出 DNA 序列。SDK 的list()返回生成器按页迭代sequences benchling.dna_sequences.list() for page in sequences: for seq in page: print(f{seq.name} ({seq.id})) # 不加载全部页即可估算总量 total sequences.estimated_count()如果只想看某个文件夹或 schema 下的序列用服务端过滤而不是拉全量再在客户端筛sdk_reference.md 的 Efficient Filtering 一节把后者明确标为 Bad 示例sequences benchling.dna_sequences.list( folder_idfld_abc123, # 换成你租户里真实的 folder id schema_idts_abc123 # 可选换成真实的 schema id )fld_abc123、ts_abc123这类值是文档示例中的占位 ID执行前必须替换为你租户里的真实资源 ID。另一个必须注意的坑分页生成器只能迭代一次第二次for page in sequences不会报错但拿不到任何数据需要重新调用list()生成新的生成器sdk_reference.md 的 Pagination Exhaustion 一节。遇到认证错误时按状态码排查authentication.md 的 Troubleshooting 一节把三种最常见错误与处理方式写清楚了401 Unauthorized凭证无效或过期、API key 格式不对、缺少Authorization头。按文档顺序核对凭证是否正确、key 是否已过期或被删除、header 格式是否为Authorization: Bearer tokenOAuth 场景。403 Forbidden凭证有效但权限不足——用户对资源无访问权或应用没有被授予组织/项目的访问。API 权限与 UI 权限一致被挂起的用户会失去 API 访问归档的应用在恢复前也无法调用。处理路径是在 Developer Console 给应用授予所需访问。429 Too Many Requests超过限流。文档给出的默认限流是每用户/应用 100 次请求 / 10 秒。SDK 默认对 429、502、503、504 自动做指数退避重试SKILL.md 说明默认最多 5 次重试如需调整可用RetryStrategy(max_retries3, backoff_factor0.5, status_codes_to_retry[429, 502, 503, 504])传给Benchling(...)。SDK 侧还可以捕获具体异常类型NotFoundError、ValidationError、UnauthorizedError和兜底的BenchlingError来做分支处理。此外注意字段校验规则fields里的值必须与租户 schema 匹配数值字段也以字符串传入如numeric_field: 123日期用YYYY-MM-DD下拉字段必须与选项完全一致。限制与下一步这条路径覆盖的是单用户脚本和自动化场景。文档给出的升级边界多用户生产应用应改用 OAuth 2.0 client credentialsClientCredentialsOAuth2SDK 自动处理 token 刷新在 Developer Console 注册应用并授予对组织、团队、项目、文件夹的最小必要权限企业身份提供方场景还有 OIDC 路径要求 Benchling 企业账户和带 email claim 的 IdP token。更深入的端点清单分页参数pageSize默认 50 最大 100、nextToken、错误响应结构在 skills/benchling-integration/references/api_endpoints.md库存、ELN 条目、工作流任务的完整 CRUD 示例在 skills/benchling-integration/references/sdk_reference.md事件驱动的集成AWS EventBridge 订阅则在 skills/benchling-integration/references/eventbridge.md 单独展开不在本文范围内。【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
