Skip to main content
Sandboxes are in private preview. APIs and features may change as we iterate. Sign up for the waitlist to get access.
在创建沙盒之前,你需要一个模板。模板定义了沙盒实例的蓝图,包括容器镜像、资源分配以及可选配置,如卷和身份验证代理规则。 模板列表视图

模板定义的内容

设置项描述
容器镜像要使用的 Docker 镜像(支持私有仓库)
资源容量CPU、内存和存储限制
要附加的持久化存储(可选)
身份验证代理配置用于将密钥注入出站请求的规则(可选)——参见身份验证代理

创建模板

from langsmith.sandbox import SandboxClient

client = SandboxClient()

client.create_template(
    name="python-sandbox",
    image="python:3.12-slim",
)
你也可以通过 REST API 创建模板,并完全控制资源和代理配置:
curl -X POST "$LANGSMITH_ENDPOINT/api/v2/sandboxes/templates" \
  -H "x-api-key: $LANGSMITH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "python-sandbox",
    "image": "python:3.12-slim",
    "resources": {"cpu": "500m", "memory": "512Mi", "storage": "2Gi"}
  }'

后续步骤