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

# ModalSandbox 集成

> 使用 LangChain Python 集成 ModalSandbox 沙盒后端。

[Modal](https://modal.com) 提供支持 GPU 的无服务器容器基础设施。有关注册、认证和平台详情，请参阅 [Modal 文档](https://modal.com/docs)。

## 安装

```bash pip theme={null}
pip install langchain-modal
```

```bash uv theme={null}
uv add langchain-modal
```

## 创建沙盒后端

在 Python 中，您使用提供方 SDK 创建沙盒，然后用 [deepagents 后端](https://langchain-docs-zh.mintlify.site/langchain/oss/deepagents/backends.md) 将其封装。

```python theme={null}
import modal

from langchain_modal import ModalSandbox

app = modal.App.lookup("your-app")
modal_sandbox = modal.Sandbox.create(app=app)
backend = ModalSandbox(sandbox=modal_sandbox)

result = backend.execute("echo hello")
print(result.output)
```

## 与 Deep Agents 一起使用

```python theme={null}
import modal
from langchain_anthropic import ChatAnthropic

from deepagents import create_deep_agent
from langchain_modal import ModalSandbox

app = modal.App.lookup("your-app")
modal_sandbox = modal.Sandbox.create(app=app)
backend = ModalSandbox(sandbox=modal_sandbox)

agent = create_deep_agent(
    model=ChatAnthropic(model="claude-sonnet-4-6"),
    system_prompt="You are a coding assistant with sandbox access.",
    backend=backend,
)

result = agent.invoke(
    {"messages": [{"role": "user", "content": "Install numpy and calculate pi"}]}
)
```

## 清理

您负责通过 Modal 管理沙盒的生命周期。用完之后，终止沙盒。

另见：[沙盒](https://langchain-docs-zh.mintlify.site/langchain/oss/deepagents/sandboxes.md)。

***

> 官方原文：[src/oss/python/integrations/sandboxes/modal.mdx](https://github.com/langchain-ai/docs/blob/main/src/oss/python/integrations/sandboxes/modal.mdx) · 非官方翻译，译文由 AI 生成，以英文原文为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.