托管型深度智能体

托管型深度智能体是在 LangSmith 中部署和运行代码优先的深度智能体的托管运行时，它将深度智能体框架与托管基础设施相结合。它允许你在无需搭建自己的智能体服务器或基础设施的情况下，运行生产级智能体。你可以使用 Python 或 TypeScript 编写智能体，然后使用 mda CLI 进行测试并将其部署到托管运行时。 该托管运行时提供：

• 持久化运行
• LangSmith 沙箱
• 由 Context Hub 支持的指令、技能和记忆
• 追踪记录
• 托管的 LangGraph 部署

要部署你的第一个智能体，请参阅快速入门。

​

何时使用托管型深度智能体

选择符合你对控制和基础设施需求的方案：

​

组织你的智能体项目

托管型深度智能体是一个本地项目目录。文件的位置决定了它的作用：CLI 读取该目录以找到智能体入口、托管指令、技能、连接器、通道、调度计划、可选的身份验证、沙箱配置和本地评估任务，然后将部署所需的部分打包到一个托管部署中。 有关完整的目录布局和打包规则，请参阅 CLI 项目文件参考。关于 CLI 如何编译此目录以及部署会创建什么，请参阅托管型深度智能体的工作原理。

​

推荐工作流程

1. 为 Python 或 TypeScript 安装 managed-deepagents。
2. 使用 mda init 创建一个本地的代码优先智能体项目。
3. 将智能体系统提示词放入 instructions.md。
4. 添加编写的工具、中间件、调度计划、技能、连接器、消息通道、可选的身份验证和可选的沙箱。
5. （可选）使用 mda evals compile 编译 Harbor 风格的评估，并使用 Harbor 运行它们。
6. 使用 mda dev 在 LangSmith Studio 中本地测试你的智能体，然后使用 mda deploy 将其部署到 LangSmith。
7. 在 LangSmith 中检查部署、追踪记录和运行时状态。

刚接触托管型深度智能体？请从快速入门开始，然后在教程中逐步构建一个完整的智能体。

​

测试版说明和限制

以下是私有测试版期间适用的操作说明。行为在正式发布前可能会更改。

​

支持的模型

以 {provider}:{model_id} 的形式传递模型标识符。例如，openai:gpt-5.5。运行时使用 init_chat_model 解析模型，因此任何 init_chat_model 支持的提供商都可以在托管型深度智能体中使用，前提是运行时具有该提供商的凭据。有关当前列表，请参阅支持的提供商和模型。 将本地密钥放入 .env，在你的 shell 中导出它们，或者在部署前将它们配置为 LangSmith 工作区密钥。

​

Context Hub 记忆

托管记忆与部署的指令和技能存储在同一个 Context Hub 仓库中。运行时将一个 Hub 切片重新挂载为 /memories/user/（热数据 /memories/user/AGENTS.md，冷数据位于该挂载点下），并将可选的组织信息作为 /memories/org/（只读）。部署会同步 instructions.md 和 skills/**，但会保留现有的 memories/** 并且不会覆盖运行时创建的记忆。设置 disableMemory: true 或 disable_memory=True 可以禁用托管记忆。有关冷热分层、身份重新挂载和组织记忆的更多信息，请参阅记忆。要按调用者分区记忆，请参阅身份。

​

速率限制和配额

在私有测试版期间，托管型深度智能体不发布按密钥、按工作区或按智能体的请求速率限制。有关特定工作区的限制，请通过测试版访问邮件中的地址联系你的 LangChain 团队。

​

支持和反馈

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

​

私有测试版范围

在私有测试版期间，托管型深度智能体仅在美国区域的 LangSmith Cloud 上可用。不支持自托管和混合部署。

​

后续步骤

---