模板名稱標識運行環境；標籤為模板的某次構建標記階段或版本（如 prod、staging、v1），便於灰階和復原。
開始前，請先完成快速開始中的串連配置。
模板名稱
名稱建議包含業務情境、語言或基礎鏡像、關鍵依賴版本和日期，便於識別和分組：
agent-python313-20260704
code-review-node22-20260704
data-analysis-py313-v1建立沙箱時用名稱引用模板：
const sandbox = await Sandbox.create("agent-python313-20260704");Python 樣本：
sandbox = Sandbox.create(template="agent-python313-20260704")標籤
分配標籤
assignTags 第一個參數使用 name:tag 格式指定從哪個構建打標籤；不帶 :tag 時預設指向 default 構建。
import { Template } from "e2b";
// 不指定源標籤時，為 default 構建分配標籤
await Template.assignTags("agent-python313-20260704", ["staging", "v1"]);Python 樣本：
from e2b import Template
Template.assign_tags("agent-python313-20260704", ["staging", "v1"])查詢標籤
分配與移除標籤按模板名稱操作；查詢標籤時，TypeScript 用模板名稱即可返回全部標籤，Python 需使用模板 ID（例如 Template.build 返回的 build.template_id）。
const tags = await Template.getTags("agent-python313-20260704");
console.log(tags);
// 輸出: [{ tag: 'default', buildId: '...', createdAt: '...' },
// { tag: 'staging', buildId: '...', createdAt: '...' }, ...]Python 樣本：
tags = Template.get_tags("<template-id>")
print(tags)
# 輸出: [TemplateTag(tag='default', build_id='...', created_at='...'), ...]移除標籤
await Template.removeTags("agent-python313-20260704", "staging");Python 樣本：
Template.remove_tags("agent-python313-20260704", "staging")限制說明
每個模板最多 20 個標籤。
不能刪除
default標籤（返回 400 錯誤）。重複分配同一標籤、刪除不存在的標籤都是等冪操作。
使用建議
發布新版本時，先驗證新模板或標籤，再切換業務引用；複雜的發布規則仍由業務系統或發布系統管理。