> ## Documentation Index
> Fetch the complete documentation index at: https://nvd-54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用远程沙箱

> 在 LangSmith、Daytona、Modal、Runloop 或 AgentCore 沙箱中运行深度智能体 CLI 工具执行。安装提供商附加组件、设置凭证，以及使用标志和设置脚本。

CLI 使用[沙箱即工具](/oss/javascript/deepagents/sandboxes#sandbox-as-tool-pattern)模式：CLI 进程（大语言模型(LLM)循环、记忆、工具调度）在您的机器上运行，但智能体工具调用（`read_file`、`write_file`、`execute` 等）指向远程沙箱，而不是您的本地文件系统。要将文件放入沙箱，请使用[设置脚本](#setup-scripts)或提供商的文件传输 API（参见[使用文件](/oss/javascript/deepagents/sandboxes#working-with-files)）。

有关沙箱架构、集成模式和安全最佳实践的深入了解，请参见[沙箱](/oss/javascript/deepagents/sandboxes)。

<Steps>
  <Step title="安装提供商依赖" icon="download">
    <Tabs>
      <Tab title="LangSmith">
        安装 `deepagents-cli` 时默认包含。无需额外安装。
      </Tab>

      <Tab title="Daytona">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        uv tool install deepagents-cli --with langchain-daytona
        ```
      </Tab>

      <Tab title="Modal">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        uv tool install deepagents-cli --with langchain-modal
        ```
      </Tab>

      <Tab title="Runloop">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        uv tool install deepagents-cli --with langchain-runloop
        ```
      </Tab>

      <Tab title="AgentCore">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        uv tool install deepagents-cli --with langchain-agentcore-codeinterpreter
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="设置提供商凭证" icon="key">
    <Tabs>
      <Tab title="LangSmith">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        export LANGSMITH_API_KEY="your-key"
        ```
      </Tab>

      <Tab title="Daytona">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        export DAYTONA_API_KEY="your-key"
        ```
      </Tab>

      <Tab title="Modal">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        modal setup
        ```
      </Tab>

      <Tab title="Runloop">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        export RUNLOOP_API_KEY="your-key"
        ```
      </Tab>

      <Tab title="AgentCore">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        export AWS_ACCESS_KEY_ID="your-key"
        export AWS_SECRET_ACCESS_KEY="your-secret"
        export AWS_SESSION_TOKEN="session-token"
        export AWS_REGION="us-west-2"
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="使用沙箱运行 CLI" icon="player-play">
    <Tabs>
      <Tab title="LangSmith">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        deepagents --sandbox langsmith
        ```
      </Tab>

      <Tab title="Daytona">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        deepagents --sandbox daytona
        ```
      </Tab>

      <Tab title="Modal">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        deepagents --sandbox modal
        ```
      </Tab>

      <Tab title="Runloop">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        deepagents --sandbox runloop
        ```
      </Tab>

      <Tab title="AgentCore">
        ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
        deepagents --sandbox agentcore
        ```
      </Tab>
    </Tabs>
  </Step>
</Steps>

## 沙箱标志和示例

| 标志                     | 描述                                                                         |
| ---------------------- | -------------------------------------------------------------------------- |
| `--sandbox TYPE`       | 要使用的沙箱提供商：`langsmith`、`agentcore`、`modal`、`daytona` 或 `runloop`（默认：`none`） |
| `--sandbox-id ID`      | 通过 ID 重用现有沙箱，而不是创建新的。跳过创建和清理。详情请参阅您的沙箱文档                                   |
| `--sandbox-setup PATH` | 创建沙箱后在其中运行的设置脚本路径                                                          |

示例：

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
# 创建新的 Daytona 沙箱
deepagents --sandbox daytona

# 重用现有沙箱（跳过创建和清理）
deepagents --sandbox runloop --sandbox-id dbx_abc123

# 沙箱创建后运行设置脚本
deepagents --sandbox modal --sandbox-setup ./setup.sh
```

## 设置脚本

使用 `--sandbox-setup` 在沙箱创建后运行 shell 脚本。这对于克隆仓库、安装依赖和配置环境变量非常有用。

```bash title="setup.sh" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
#!/bin/bash
set -e

# 使用 GitHub token 克隆仓库
git clone https://x-access-token:${GITHUB_TOKEN}@github.com/username/repo.git $HOME/workspace
cd $HOME/workspace

# 使环境变量持久化
cat >> ~/.bashrc <<'EOF'
export GITHUB_TOKEN="${GITHUB_TOKEN}"
export OPENAI_API_KEY="${OPENAI_API_KEY}"
cd $HOME/workspace
EOF
source ~/.bashrc
```

CLI 使用您本地环境变量展开设置脚本中的 `${VAR}` 引用。将密钥存储在本地 `.env` 文件中供设置脚本访问。

<Warning>
  沙箱隔离了代码执行，但智能体在面对不受信任的输入时仍易受提示注入攻击。请使用人机协作审批、短生命周期的密钥，并仅使用受信任的设置脚本。详见[安全注意事项](/oss/javascript/deepagents/sandboxes#security-considerations)。
</Warning>

***

<div className="source-links">
  <Callout icon="terminal-2">
    [通过 MCP 连接这些文档](/use-these-docs)到 Claude、VSCode 等以获取实时解答。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/deepagents/cli/remote-sandboxes.mdx) 或 [提交 issue](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>