文档中心

AgentKit

沙箱模板管理

创建和管理 E2B API Key

E2B 协议兼容功能支持使用 E2B API Key 调用沙箱模板。本文介绍如何创建 E2B API Key、为沙箱模板开启 E2B 协议兼容，以及如何在查看和管理已创建的 Key。

注意

E2B API Key 当前为白名单功能，仅开通后可见、可使用，如需试用，请联系客户经理。

创建 E2B API Key

您可以通过以下三种方式创建 E2B API Key，三种创建方式仅入口不同，配置操作完全相同。

选择任意一种方式，进入创建 E2B API Key 页面。

创建方式	配置入口
方式一：单独创建 E2B API Key	在沙箱模板页面，单击“创建 E2B API Key”按钮。
方式二：创建沙箱模板时创建	创建沙箱模板时，在“权限与访问控制”区域单击“创建 E2B API Key”按钮。
方式三：在已有沙箱模板中创建	在沙箱模板页面沙箱模板列表中，单击目标沙箱模板名称，在“配置信息”页签“E2B 协议兼容”区域，单击“创建 E2B API Key”按钮。

在“创建 E2B API Key”页面填写名称，单击“创建 Key”按钮。

说明

系统会自动生成 E2B API Key 名称，如果不符合要求您可修改。系统生成的 E2B API Key 名称和完整 Key 均以 e2b_apikey_ 开头。

创建成功后，立即复制并保存完整 Key。

说明

完整 Key 仅在创建成功时展示一次，如有需要请立即复制并妥善保存，创建成功后仅展示脱敏后的 Key 值。

关闭 E2B 协议兼容开关只会影响后续新建实例；已有 E2B 实例会继续运行和计费。如需管理已有实例，请使用 E2B CLI 或 OpenAPI。

管理 E2B API Key

查看 E2B API Key

通过任意一种方式进入创建 E2B API Key 页面，在页面下方展示当前已创建的 Key 的信息，包括名称、脱敏后的 Key 和创建时间。您可以单击“刷新”按钮获取最新 E2B API Key 列表信息。

管理已有 E2B API Key

已创建的 E2B API Key 支持编辑或删除账号级 E2B API Key，您可以像管理其他 API Key 一样，查看 Key 的绑定状态，并根据需要编辑、绑定、轮换密钥或删除凭据。

在左侧导航树中，选择“身份与权限 > 凭据管理”，或在创建 E2B API Key 页面单击“前往凭据管理”按钮。

在凭据管理页面，您可查看 E2B API Key 详细信息、编辑 E2B API Key 值、为 Agent 绑定 E2B API Key、轮换密钥或删除不需要的 E2B API Key。

查看 E2B API Key 信息
编辑 E2B API Key 值
为 Agent 绑定 E2B API Key
轮换密钥
删除 E2B API Key
在凭据列表中，单击目标凭据名称。

查看 E2B API Key 详情。
在凭据列表中，单击目标凭据“操作”列的“编辑”按钮。

编辑 E2B API Key 值，设置 E2B API Key 传递方式。字段含义和填写要求请参考创建第三方 API Key 凭据。

配置完成后，单击“确定”按钮，完成修改。
若需将 E2B API Key 绑定到 Agent，请确保已提前创建目标 Agent，并确认其运行状态正常。具体操作请参见创建运行时。
注意
建议遵循最小授权原则，仅将 E2B API Key 绑定到确有访问需求的 Agent。
请勿仅凭 Agent 名称判断凭据绑定目标：Agent 名称不唯一，可能存在名称相同的 Agent。
Agent 发布或升级版本：一般会沿用原有 E2B API Key 绑定关系，无需为每个版本重复绑定。
删除重建智能体运行时：若新建的智能体运行时仍然归属原 Agent，绑定关系保持不变。
重建 Agent 场景：如果重新创建 Agent，造成 Agent 唯一标识发生变更，则需要为新 Agent 重新绑定 E2B API Key 。
在凭据列表中，单击目标凭据“操作”列的“绑定”按钮。

单击“绑定到更多 Agent”按钮，选择待绑定的 Agent 单击“确定”按钮，完成绑定。

选择待绑定的 Agent，单击“确定”按钮，完成绑定。
密钥轮换完成后，新客户端密钥将立即覆盖替换旧值；该 E2B API Key 已有的 Agent 绑定关系保持不变，不会受密钥轮换操作影响。
注意
轮换前，请先确认没有运行中的应用、E2B CLI 配置或其他调用方正在使用该 Key，以免影响业务调用。
在凭据列表中，单击目标凭据“操作”列的“轮换密钥”按钮。

在弹出的对话框中，设置新的 API Key，单击“确认轮换”按钮，完成操作。
前置操作
删除 E2B API Key 前，请完成以下检查。
确认已无业务依赖：确认目标 E2B API Key 不再被运行中的应用、E2B CLI 配置或其他调用方正在使用，以免影响业务调用。
解除全部 Agent 绑定：当存在绑定关系时，系统不允许删除凭据，如果 API Key 或 OAuth 连接凭据已绑定 Agent，请先解除全部 Agent 绑定关系。
保留必要的审计信息：若后续可能需要追溯 E2B API Key 用途、绑定关系或历史配置，建议在删除前记录凭据名称、类型、提供方、所属项目和更新时间等必要信息。请勿在记录中保存 API Key、Client Secret 等敏感值。
操作步骤
在凭据列表中，单击目标凭据“操作”列的“删除”按钮。

在弹出的对话框中，确认信息无误后，单击“删除”按钮，完成操作。

最近更新时间：2026.11.04 14:21:45

这个页面对您有帮助吗？

有用

无用