沙盒是隔离环境，允许代理安全地执行潜在风险操作（如运行任意代码或与文件系统交互），而不会影响您的主基础设施。

从 LangSmith 主页，选择 **沙盒** 来管理您所有的沙盒资源。

!沙盒概览页面

环境可用性

开始使用

1. 安装 SDK

# uv
uv add "langsmith[sandbox]"

# pip
pip install "langsmith[sandbox]"

npm install langsmith

2. 设置您的 API 密钥

3. 创建并运行沙盒

from langsmith.sandbox import SandboxClient

client = SandboxClient()

with client.sandbox() as sb:
    result = sb.run("python -c 'print(2 + 2)'")
    print(result.stdout)  # "4\n"

const client = new SandboxClient();
const sandbox = await client.createSandbox();
const result = await sandbox.run("node -e 'console.log(2 + 2)'");
console.log(result.stdout); // "4\n"
await sandbox.delete();

4. 将沙盒与您的代理配合使用

要将沙盒接入代理代码，请参阅开源文档：

• 深度代理: 使用 LangSmithSandbox 作为后端，涵盖安装、后端创建和清理。
• 沙盒作为代理后端: 将任何沙盒配置为执行后端 为您的代理提供 execute 和文件系统工具。
• LangChain / LangGraph integrations：将 LangSmith 沙盒作为第一方选项，或 连接第三方提供商 如 AgentCore、Daytona、E2B、Modal、Runloop 和 Vercel。

资源