托管式深度智能体是一个托管式运行时，用于在 LangSmith 中创建、运行和操作深度智能体。使用它可以运行持久的长时间运行的智能体，而无需自行搭建智能体服务器。

它将 深度智能体 工具与托管基础设施相结合：持久化运行、 LangSmith 沙盒、线程状态、MCP 工具、文件树、追踪和智能体版本。

推荐的工作流程如下：

1. 创建或编辑本地托管式深度智能体项目。
2. 保留默认后端或选择使用 LangSmith 沙盒后端。
3. 当智能体需要外部能力时连接 MCP 工具。
4. 将项目部署到托管式深度智能体。
5. 使用 Python 或 TypeScript SDK 运行智能体。
6. 在 LangSmith 中检查追踪、文件、工具调用、运行时状态和版本。

按照工作流程

使用托管式深度智能体

使用托管式深度智能体可以：

• - 从本地项目文件创建和管理深度智能体。
• - 运行长时间运行的智能体，而无需搭建自定义智能体服务器。
• - 为每个线程或智能体提供隔离的 LangSmith 沙盒资源，用于代码执行、文件系统操作和长时间运行的任务。
• - 流式传输运行并持久化线程状态。
• - 使用托管式文件树来管理指令、技能、子智能体、工具和运行时文件。
• - 注册工作区级 MCP 服务器，包括 OAuth MCP 服务器，并列出其可用工具。
• - 在 LangSmith 中检查追踪和智能体行为。

创建的资源

创建托管式深度智能体时，LangSmith 会提供以下资源：

• - 一个托管深度智能体资源。
• - 一个独立的 LangSmith 追踪项目 用于该智能体。
• - A Context Hub 用于存储托管文件树的智能体仓库。

它不会创建 LangSmith 部署。

托管深度智能体运行会在为该智能体创建的独立追踪项目中进行追踪。在 LangSmith 中打开追踪以检查用户输入、最终响应、模型调用、工具调用、子智能体活动、文件和运行期间创建的运行时状态。

Context Hub 智能体仓库为智能体存储托管文件树，包括指令、技能、子智能体和工具配置。

LangSmith 沙箱后端

由以下方式生成的托管深度智能体项目 deepagents-cli>=0.2.2 使用 state backend:

{
  "backend": {
    "type": "state"
  }
}

LangSmith 沙箱是用于运行代码和与文件系统交互等操作的隔离环境，不会影响您的主基础设施。在托管深度智能体中，沙箱为智能体提供托管运行时以执行长时间运行的工作，而 LangSmith 负责处理底层沙箱生命周期。

选择与您的范围匹配的后端：

• - state：不应用任何沙箱特定的后端行为。
• - sandbox 配合 sandbox_config.scope: "thread"：将沙箱资源限定到每个线程。
• - sandbox 配合 sandbox_config.scope: "agent"：将沙箱限定到智能体而非单个线程。

有关独立沙箱概念，请参阅 LangSmith 沙箱概述。有关托管深度智能体的配置字段和验证规则，请参阅 部署智能体 和 CLI 参考.

限制和注意事项

适用于私有测试版期的运维注意事项。在正式发布前行为可能会发生变化。

稳定的部署体验

托管深度智能体部署可通过私有测试版期间的 beta CLI 版本获得。稳定的深度智能体部署体验将继续工作，直到托管深度智能体进入公开测试版且部署命令切换到新行为。

支持的模型

以以下形式传递模型标识符 {provider}:{model_id}。例如， openai:gpt-5.5。运行时使用以下方式解析模型 init_chat_model，因此任何支持 init_chat_model 的提供商都可从托管深度智能体使用。请参阅 支持的提供商和模型 以获取当前列表。

没有冒号的值会被解释为对保存的 Playground 配置的引用，而不是模型标识符。在直接配置模型时，请始终提供完整的 {provider}:{model_id} 形式。

线程保留

在私有测试版期间，线程没有保留期或每个工作区的上限。按需创建任意数量。现有的线程在整个测试版期间都可访问。

速率限制和配额

在私有测试版期间，托管深度智能体端点不会强制执行每个密钥、每个工作区或每个智能体的请求速率限制。

智能体限制

免费 LangSmith 工作区仅限一个托管深度智能体。付费 LangSmith 计划可创建无限数量的智能体。当免费工作区已达到上限时， deepagents deploy 且 POST /v1/deepagents/agents 失败并显示 HTTP 409 和一条消息，提示删除现有智能体或升级您的计划。

删除智能体

DELETE /v1/deepagents/agents/{agent_id} 不会级联到线程。针对已删除智能体创建的线程仍然可以查询，但无法启动新的运行。当您想要清理线程时，请明确地跟踪和删除线程。

API 稳定性

路由位于 /v1/deepagents下，但接口处于私人测试阶段，在正式发布前可能会发生变化。重大变更会通过授予访问权限时提供的联系方式直接通知测试客户。

支持与反馈

测试版本包含直接支持。错误报告和功能请求的联系方式包含在授予访问权限时收到的电子邮件中。

私人测试范围

托管深度智能体在私人测试阶段仅在 LangSmith Cloud 美国区域可用。不支持自托管和混合部署，欧盟及其他地区计划在正式发布后提供。

此外，API 在私人测试阶段也不会镜像每个 LangSmith 部署端点。托管深度智能体不是 LangSmith 部署。