元数据-函数计算(FC)-阿里云帮助中心

元数据用于在控制面标记沙箱，便于业务系统追踪任务、用户、场景和版本。元数据不会自动变成沙箱内的环境变量。

创建沙箱时写入元数据

const sandbox = await Sandbox.create("code-interpreter-v1", {
  apiKey: process.env.E2B_API_KEY,
  apiUrl: process.env.E2B_API_URL,
  domain: process.env.E2B_DOMAIN,
  metadata: {
    task_id: "task-001",
    agent: "code-reviewer",
  },
});

const info = await sandbox.getInfo();
console.log(info.metadata);

Python 示例：

sandbox = Sandbox.create(
    template="code-interpreter-v1",
    api_key=os.environ["E2B_API_KEY"],
    api_url=os.environ["E2B_API_URL"],
    domain=os.environ["E2B_DOMAIN"],
    metadata={
        "task_id": "task-001",
        "agent": "code-reviewer",
    },
)

info = sandbox.get_info()
print(info.metadata)

元数据和环境变量的区别

元数据用于管理面查询、审计和业务关联。
环境变量用于沙箱内进程读取。
同一个业务字段如果既要管理面可见、又要进程可见，可以同时写入 metadata 和 envs。

使用建议

元数据值建议使用短字符串，避免写入大段上下文、用户隐私或凭证。复杂业务状态应保存在业务数据库中，元数据只保存可索引的关联 ID。