Skip to main content
Deep Agents Deploy 将您的智能体配置部署为 LangSmith 部署:一个可水平扩展的服务器,包含 30 多个端点,包括 MCP、A2A、Agent Protocol、人机协作和记忆 API。基于开放标准构建:
  • 开源运行时:MIT 许可证,提供 PythonTypeScript 版本
  • AGENTS.md:智能体指令的开放标准
  • Agent Skills:智能体知识和操作的开放标准
  • 任意模型,任意沙箱:无供应商锁定
  • 开放协议MCPA2AAgent Protocol
  • 可自托管:LangSmith 部署可以自托管,因此记忆数据保留在您的基础设施中
Deep Agents Deploy 目前处于测试阶段,需要 deepagents-cli>=0.0.36。API、配置格式和行为可能在版本之间发生变化。有关详细的变更日志,请参阅发布页面

与 Claude 托管智能体的比较

您正在部署的内容

deepagents deploy 将您的智能体配置打包并部署为 LangSmith 部署。您可以通过几个参数配置您的智能体:

安装

安装 CLI 或直接使用 uvx 运行:

用法

默认情况下,deepagents deploy 在当前目录中查找 deepagents.toml。传递 --config 以使用不同的路径:
deepagents deploy 每次调用都会完全重新构建并创建一个新的修订版。使用 deepagents dev 进行本地迭代。

deepagents init

搭建一个新的智能体项目:
这将创建以下文件: 初始化后,编辑 AGENTS.md 添加您的智能体指令,然后运行 deepagents deploy。可选地添加一个 user/ 目录,其中包含每个用户的记忆模板——参见用户记忆

项目布局

deploy 命令使用基于约定的项目布局。将以下文件与您的 deepagents.toml 放在一起,它们将被自动发现:
mcp.json 必须仅包含使用 httpsse 传输的服务器。使用 stdio 传输的服务器在部署环境中不受支持,因为没有本地进程可以生成。在部署前将 stdio 服务器转换为 HTTP 或 SSE。

配置文件

deepagents.toml 配置智能体的身份和沙箱环境。只有 [agent] 部分是必需的。[sandbox] 部分是可选的,默认为无沙箱。

[agent]

(必需) 核心智能体身份。有关模型选择和提供商配置的更多信息,请参阅支持的模型
string
required
部署的智能体的名称。用作 LangSmith 中的助手标识符。
string
provider:model 格式的模型标识符。参见支持的模型
deepagents.toml
name 字段是整个配置文件中唯一必需的值。其他所有内容都有默认值。
技能、用户记忆、子智能体、MCP 服务器和模型依赖项从项目布局中自动检测:
  • 技能:打包器递归扫描 skills/,跳过隐藏的点文件,并打包其余内容。
  • 用户记忆:如果 user/ 存在,单个 AGENTS.md 将作为每个用户的记忆被打包(如果存在 user/AGENTS.md,则使用其内容,否则为空)。在运行时,每个用户获得自己的副本(在首次访问时初始化,永远不会被覆盖)。智能体可以读取和写入此文件。
  • 子智能体:如果 subagents/ 存在,打包器会扫描有效的子目录(每个必须包含 deepagents.tomlAGENTS.md)。主智能体接收一个 task 工具,可以按名称将工作委派给每个子智能体。参见子智能体
  • MCP 服务器:如果 mcp.json 存在,它将包含在部署中,并且 langchain-mcp-adapters 将作为依赖项添加。仅支持 HTTP/SSE 传输(stdio 在打包时会被拒绝)。
  • 模型依赖项model 字段中的 provider: 前缀决定了所需的 langchain-* 包(例如,google_genai -> langchain-google-genai)。这包括在子智能体配置中指定的模型。
  • 沙箱依赖项[sandbox].provider 值映射到其伴侣包(例如,daytona -> langchain-daytona)。

[sandbox]

配置智能体运行代码的隔离执行环境。沙箱提供一个具有文件系统和 shell 访问权限的容器,因此不受信任的代码不会影响主机。有关支持的提供商和高级沙箱配置,请参阅沙箱 当省略或设置为 provider = "none" 时,沙箱被禁用。如果您需要代码执行或技能脚本执行,则使用沙箱。
string
default:"none"
沙箱提供商。决定容器在哪里运行。支持的值:"none""daytona""modal""runloop""langsmith"(私有测试版)。有关提供商详情,请参阅沙箱集成
string
default:"deepagents-deploy"
沙箱环境的提供商特定模板名称。
string
default:"python:3"
沙箱容器的基础 Docker 镜像。
string
default:"thread"
沙箱生命周期作用域。"thread" 为每个对话创建一个沙箱。"assistant" 在同一助手的所有对话之间共享单个沙箱。
作用域行为:
  • "thread"(默认):每个对话获得自己的沙箱。不同的线程获得不同的沙箱,但相同的线程在不同轮次中重用其沙箱。当每个对话应从干净环境开始时使用此选项。
  • "assistant":所有对话共享一个沙箱。文件、安装的包和其他状态在对话之间持久化。当智能体维护一个长期工作空间(如克隆的仓库)时使用此选项。

[auth]

添加 [auth] 部分以控制部署的智能体上的身份验证。存在时,打包器会生成一个 auth.py 文件并自动连接到部署中。当 [frontend].enabled = true 时,[auth]必需的;否则它是可选的(没有它,LangSmith 部署的默认 x-api-key 要求适用)。
string
required
身份验证提供商。支持的值:"supabase""clerk""anonymous"
deepagents.toml
所需的环境变量取决于提供商: 将这些添加到您的 .env 文件中,与其他凭据放在一起。打包器在部署时验证所有必需的变量是否存在,如果缺少任何变量,将快速失败并给出清晰的错误信息。 运行时行为:
  • 未认证的请求返回 401
  • 成功后,已认证用户的身份将注入到 config.configurable.langgraph_auth_user_id 中。
  • 所有资源(线程、运行、存储)通过 metadata.owner 自动按用户作用域划分。
  • LangSmith Studio 在本地开发时绕过身份验证。

[frontend]

前端部署需要 deepagents-cli>=0.0.43
可选地启用 [frontend],以便在同一个部署中与您的智能体一起部署预构建的 React 聊天 UI。前端挂载在部署 URL 的 /app 路径上;您的 LangGraph API 保持在根路径(/threads/runs/assistants)。每个前端使用三种身份验证提供商之一——Clerk、Supabase 或匿名(参见下面的 [auth])。
boolean
default:"false"
如果为 true,则将默认聊天 UI 打包到部署中。
string
default:"[agent].name"
在 UI 标题和浏览器标签页中显示的名称。
string
default:"Your deep agent, deployed."
在标题中应用名称下方和空状态主图上显示的副标题。用于描述智能体的功能。
string[]
当没有消息时在空状态上显示的建议芯片。默认为通用的研究主题集;覆盖以根据您的智能体定制芯片。
deepagents.toml
身份验证提供商: [frontend].enabled = true 时,[auth] 是必需的。选择以下三种提供商之一:
  • Clerk ([auth] provider = "clerk") —— 每个用户的真实身份验证。每个用户登录;线程和记忆按用户作用域划分。
  • Supabase ([auth] provider = "supabase") —— 每个用户的真实身份验证。与 Clerk 相同的按用户作用域划分。
  • 匿名 ([auth] provider = "anonymous") —— 打包器提供一个宽松的身份验证处理程序,覆盖 LangSmith 部署的默认 x-api-key 要求,以便前端可以访问 /threads,这意味着任何拥有部署 URL 的人都可以调用 API。前端为每个浏览器分配一个 UUID cookie,并根据它过滤线程选择器(仅 UX 作用域,非安全)。CLI 在推送前需要交互式 y/N 确认。
您将获得:
  • 与智能体的流式聊天
  • 线程选择器,具有从第一条用户消息自动生成的标题
  • 实时待办事项、文件和子智能体活动面板,反映您的深度智能体的实时图状态
  • 浅色/深色主题切换,首次加载时遵循操作系统偏好设置,之后保持
  • (仅 Clerk / Supabase)登录/注册/登出流程——Clerk 提供其完整小部件(社交登录、密码重置);Supabase 提供电子邮件/密码以及内置的密码重置流程
环境变量: 前端重用 [auth] 已经要求的大部分内容。只有 Clerk 需要一个额外的浏览器端密钥。 部署后设置: 部署后,将您的部署 URL 添加到身份验证提供商的仪表板中,以便身份验证重定向返回到应用程序。每个部署 URL 只需执行一次此步骤。
  • Clerk: 仪表板 → 您的应用程序 → → 添加您的部署主机(例如 clerk-abc.us.langgraph.app)。Clerk 开发实例自动将 localhost 加入白名单;生产部署 URL 需要显式加入白名单。
  • Supabase: 仪表板 → 身份验证URL 配置 → 将 https://<your-deployment>/app/** 添加到 重定向 URL。没有此设置,密码重置和电子邮件确认链接将无法路由回您的应用程序。

.env

deepagents.toml 旁边放置一个 .env 文件,其中包含您的 API 密钥:

身份验证

运行时身份验证状态取决于 [auth]
  • [auth] provider = "supabase""clerk" —— 每个用户的真实身份验证。在 Authorization 头中传递用户的身份验证提供商令牌。
  • [auth] provider = "anonymous" —— 打包器提供一个宽松的身份验证处理程序。API 对任何拥有部署 URL 的人开放。无需头信息。(当部署 [frontend] 而没有真实的按用户身份验证时必需。)
  • 没有 [auth] 部分 —— 部署回退到 LangSmith 部署的默认 x-api-key 要求。在 x-api-key 头中传递您的 LangSmith API 密钥。仅在 [frontend].enabledfalse 或未设置时有效。
[auth] 配置为 supabaseclerk 时,在 Authorization 头中传递来自身份验证提供商的令牌:
每个用户的线程和记忆自动隔离——用户 B 无法看到用户 A 的线程。

沙箱提供商

deepagents.toml 中设置 [sandbox].provider,并将所需的环境变量添加到 .env。有关可用提供商,请参阅沙箱集成。有关生命周期模式和 SDK 用法,请参阅沙箱

部署端点

部署的服务器公开:
  • MCP:从其他智能体调用您的智能体作为工具
  • A2A:通过 A2A 协议进行多智能体编排
  • Agent Protocol:用于构建 UI 的标准 API
  • 人机协作:敏感操作的审批门
  • 记忆:短期和长期记忆访问

示例

一个具有每个用户偏好的内容写作智能体,智能体可以更新这些偏好:
deepagents.toml
一个具有 LangSmith 沙箱用于运行代码的编码智能体:
deepagents.toml
一个将研究委派给子智能体的 GTM 策略智能体:
一个轻量级的内部演示智能体,具有捆绑的 UI 和匿名模式(无需注册,无需基础设施):
deepagents.toml

用户记忆

用户记忆为每个用户提供自己的可写 AGENTS.md,该文件在对话之间持久化。要启用它,请在项目根目录创建一个 user/ 目录:
如果 user/ 目录存在(即使为空),每个用户将在 /memories/user/AGENTS.md 获得自己的 AGENTS.md。如果您提供 user/AGENTS.md,其内容将用作初始模板;否则将初始化一个空文件。 在运行时,用户记忆通过自定义身份验证(runtime.server_info.user.identity)按用户作用域划分。当用户首次与智能体交互时,其命名空间将使用模板进行初始化。后续交互重用现有文件——智能体的编辑会持久化,重新部署永远不会覆盖用户数据。

工作原理

  1. 打包时 —— 打包器读取 user/AGENTS.md(或使用空字符串)并将其包含在种子负载中。
  2. 运行时(首次访问) —— 当智能体首次看到 user_id 时,它会将 AGENTS.md 模板写入该用户命名空间下的存储中。现有条目永远不会被覆盖。
  3. 预加载 —— 用户 AGENTS.md 被传递给记忆中间件,因此智能体在每次对话开始时在上下文中看到其内容。
  4. 可写 —— 智能体可以使用 edit_file 工具更新它。共享的 AGENTS.md 文件和技能文件夹是只读的。

权限

用户身份

user_id 通过 runtime.user.identity 从自定义身份验证中解析。平台自动注入已认证用户的身份——无需通过 configurable 传递。如果没有已认证用户,该调用将优雅地跳过用户记忆功能。

子智能体

子智能体允许主智能体将专门任务委派给隔离的子智能体。每个子智能体有自己的系统提示、可选技能和可选 MCP 工具。主智能体接收一个 task 工具,可以按名称将工作分派给子智能体。 有关子智能体为何有用以及它们在 SDK 级别如何工作的背景信息,请参阅子智能体

目录结构

在项目根目录创建一个 subagents/ 目录。每个子目录都是一个子智能体:
每个子智能体子目录必须包含: 每个子智能体子目录可以包含:

子智能体配置

string
required
子智能体的唯一标识符。必须在所有子智能体中唯一。
string
required
此子智能体的功能。主智能体使用此信息来决定何时委派。必须非空。
string
provider:model 格式的模型覆盖。省略以继承主智能体的模型。
subagents/researcher/deepagents.toml

继承

子智能体默认从主智能体继承一些属性:

记忆隔离

每个子智能体在 /memories/subagents/<name>/ 获得一个专用的、隔离的记忆命名空间。子智能体的 AGENTS.md 和技能在部署时初始化到此命名空间中。

示例

一个将研究委派给专门子智能体的上市策略智能体:
deepagents.toml
subagents/researcher/deepagents.toml
subagents/researcher/AGENTS.md

限制

  • MCP:仅限 HTTP/SSE。 stdio 传输在打包时会被拒绝。
  • 无自定义 Python 工具。 使用 MCP 服务器公开自定义工具逻辑。