文档中心

容器服务

请输入

Sandbox 组件

agent-sandbox

agent-sandbox 组件是 AI Agent 安全沙箱管理组件。本文介绍 agent-sandbox 组件的功能、核心资源、安装配置和后续验证方式。

组件概述

agent-sandbox 组件是 VCI Agent Sandbox 业务场景的核心组件，该组件基于 Kubernetes 社区 SIG Agent Sandbox 实现，扩展了沙箱快照、暂停、恢复等能力，并兼容 E2B API 设计。安装组件后，您可以在集群中管理 AI Agent 运行所需的沙箱生命周期。启用 E2B Server 后，组件会额外提供 E2B 兼容 API 的控制面和数据面能力。

安装 agent-sandbox 组件后，系统会根据配置创建控制器、E2B Server 相关工作负载及访问凭证资源。下表仅列出从当前资料中可确认的核心资源，如果您在安装时调整资源名称或 E2B Server 开关等配置，请以实际安装结果为准。

资源名称	资源类型	说明
agent-sandbox-controller	Deployment	承载组件控制器能力，用于调谐 Sandbox、SandboxClaim、SandboxWarmPool、SandboxTemplate 等资源，并处理沙箱生命周期。
agent-sandbox-control-plane	Deployment / Service	启用 E2B Server 后创建，提供 E2B 兼容 API 的控制面服务，默认服务端口为 8081。
agent-sandbox-data-plane	Deployment / Service	启用 E2B Server 后创建，提供 E2B 兼容 API 的数据面服务，默认服务端口为 8080。
e2b-key-store	Secret	开启 Control-Plane 鉴权且未手动配置管理员密钥时，用于保存自动生成的管理员密钥。

组件版本

agent-sandbox 组件提供了关于组件的历史发布记录、各版本新增特性及优化说明等信息。详情请参见组件发布记录。

安装组件

升级组件

组件会不定期发布新版本以提供新特性或修复已知问题。当组件卡片提示有可用更新时，建议您及时进行升级。为确保业务平稳过渡，升级前请尽量安排在业务低峰期执行操作。关于升级的操作步骤和注意事项，请参见升级组件。