弹性容器实例（VCI）的 Agent Sandbox 现已兼容 E2B 协议。本文介绍 E2B 协议的核心概念与使用方法，帮助您了解 E2B 协议，并为您后续使用 E2B 协议管理 VCI Agent Sandbox 做基础知识储备。 ## E2B 介绍 E2B 协议（Agent Execution Protocol）是一套基于 Protobuf + HTTP/2 + Server\-Sent Events（SSE）的标准化通信协议，完整定义了 AI Agent 与远程执行环境（沙箱）之间的所有交互规范。在 E2B 协议出现之前，各沙箱厂商使用各自的私有 API 或 Kubernetes CRD，存在以下问题： * 开发者切换沙箱产品时，需要重新适配并重写管控面代码。 * AI Agent 业务难以在不同云厂商之间迁移。 E2B 协议统一了所有接口，实现了一次编写，多端运行，解决了沙箱 API 碎片化和差异化等行业痛点。 ## E2B 基本概念 ### 主要名词 |**名词** |**说明** | |---|---| |Sandbox |VCI Agent Sandbox 的核心 CRD，提供快速、安全的容器沙箱，支持暂停、恢复、状态持久化、原地升级等高级能力。 | |Template |用于定义 Sandbox 启动时的各类参数，例如镜像、资源、注解等。 | |Agent\-Sandbox\-Control\-Plane |E2B API 控制面组件，无状态服务，作为 E2B 协议的执行入口，负责处理 Sandbox 创建、删除等管控请求。 | |Agent\-Sandbox\-Data\-Plane |E2B API 数据面组件，无状态服务，在 Sandbox 内执行代码或命令等操作。 | ### 协议核心规范 |**模块** |**核心功能** | |---|---| |生命周期管理 |创建、销毁、暂停、恢复沙箱。 | |代码执行 |同步/异步执行代码、流式输出结果。 | |文件系统操作 |上传、下载、删除文件，监控文件变化。 | |终端交互 |伪终端（PTY）仿真，支持实时交互。 | |命令执行 |沙箱中执行命令。 | |可观测性 |获取沙箱日志、资源使用情况、事件。 | ## 相关文档使用 E2B 协议管理 VCI Agent Sandbox 相关文档分为以下两部分： * [快速入门](https://www.volcengine.com/docs/6460/2479108)：指导您快速从零到一通过 E2B 创建第一个 Agent Sandbox。 * [SDK 开发指南](https://www.volcengine.com/docs/6460/2479109)：为您介绍每个 SDK 请求构造方法、入参以及配置选项的说明。

容器服务