沙盒模板

使用模板定义沙盒的容器镜像、资源限制和配置。

沙盒处于私有预览阶段。随着迭代，API 和功能可能会发生变化。加入等待名单 以获取访问权限。

在创建沙盒之前，你需要一个模板。模板定义了沙盒实例的蓝图，包括容器镜像、资源分配以及可选配置，如卷和身份验证代理规则。

模板定义的内容

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

创建模板

Python

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"}
  }'

后续步骤

• 从你的模板创建沙盒
• 配置身份验证代理规则以将密钥注入出站请求
• 设置预热池以预置沙盒，实现更快的启动速度

---

Edit this page on GitHub or file an issue.

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.