管理 Managed Deep Agents 的 Context Hub

了解 Managed Deep Agents 如何将指令、技能和持久记忆存储在 LangSmith Context Hub 中。

Managed Deep Agents 会将部署所有的指令和技能，以及可选的持久记忆，存储在 LangSmith Context Hub 中。这种拆分让你无需重新构建应用代码即可更改 agent 行为，同时项目仍然是持久指令和技能更新的来源。

NOTE

Managed Deep Agents 处于公开 beta 阶段，仅在 US 区域的 LangSmith Cloud 上可用。

Context Hub 中存储的内容

内容	项目来源	在 mda deploy 时同步	agent 可写
系统提示词	instructions.md	是	否
技能	skills/	是	否
持久记忆	可选的 memory 声明	启用树；不会覆盖现有记忆	是，位于 /memories/agent/ 下

工具、中间件、MCP 连接器、频道、计划、沙箱和 agent 定义会随编译后的部署一起发布。它们不会同步到 Context Hub。

有关托管运行时字段的所有权，请参阅 Agent 定义。

事实来源

项目和 Context Hub 都保存着 instructions.md 和 skills/ 的副本。哪份副本生效取决于你在何处进行持久更改，以及你如何在部署时解决冲突。

• 项目文件：将项目中的 instructions.md 和 skills/ 视为持久更改的事实来源。每次 mda deploy 都会将这些文件同步到 agent 的 Context Hub 仓库。
• Context Hub 编辑：当你需要无需重新部署代码即可应用的快速更改时，请在 Context Hub 中编辑文件。这些 Hub 编辑会保持生效，直到后续部署覆盖它们，或者你在出现冲突提示时选择保留 Hub 副本。
• 持久记忆：/memories/agent/ 下的记忆归 agent 所有。部署会启用该树，但不会覆盖已存储在那里的内容。

部署如何同步上下文

mda deploy 会作为部署流水线的一部分同步部署所有的上下文：

• 指令和技能：每次部署都会从项目文件更新 agent 的 Context Hub 仓库。后续部署会再次同步项目副本。对于技能，部署还会删除本地已不存在的已部署技能文件。
• 持久记忆：启用记忆后，部署会在 /memories/agent/ 挂载一个 Context Hub 树。部署不会覆盖已存储在那里的内容。
• 冲突：如果自上次 mda deploy 以来 instructions.md 或 skills/ 在 Context Hub 中发生了更改，CLI 会在同步前停止，并询问是否用项目副本覆盖 Context Hub 副本。默认答案保留 Context Hub 版本并跳过同步该部分。在非交互式 shell 中不会出现提示。部署会以错误退出，你必须使用 --context-strategy overwrite 或 --context-strategy keep-hub 重新运行。单独重新运行 mda deploy 会再次报告相同冲突。
• 并发编辑：如果仓库在同步期间发生变化，部署会因提交冲突而失败。请重新运行 mda deploy。

交互式冲突提示：

◇  Checked Context Hub context
│
▲  Context Hub instructions.md changed since the last MDA sync.
│
◆  Overwrite Hub-edited instructions.md with the local version?
│  ○ Yes / ● No
└

非交互式冲突（CI 或重定向输出）：

└  Context Hub instructions.md and skills/ changed since the last MDA sync. Re-run with --context-strategy overwrite or --context-strategy keep-hub.

策略	效果
overwrite	用项目副本替换 Hub 编辑过的 instructions.md 或 skills/，然后继续部署。
keep-hub	保留 Context Hub 版本，跳过同步该部分，并继续部署。

有关完整的部署步骤列表和标志，请参阅 CLI 参考。有关密钥路由和部署选项，请参阅部署 agent。

在 LangSmith 中编辑上下文

成功部署后：

1. 在 LangSmith 中打开该部署。
2. 使用 Details 边栏中指向 Context Hub 仓库的链接，该仓库保存部署的指令、技能和记忆。当上下文不再生效时，归档仓库会被标记。
3. 当你需要无需重新部署代码即可应用的快速更改时，请在 Context Hub 中编辑文件。

对于持久更改，请编辑项目副本并重新部署。有关部署如何解决 Hub 编辑，请参阅事实来源。

有关浏览提交、提升环境和 Managed Deep Agents 之外的 Context Hub 概念，请参阅使用 Context Hub和上下文工程概念。

本地开发

mda dev 会为指令、技能和记忆创建一个本地 Context Hub mock。本地 Studio 会话不会为部署创建或更新托管的 Context Hub 仓库。

更多信息请参阅使用 LangSmith Studio 进行本地开发。

选择上下文的归属位置

目标	使用
始终启用的系统提示词	指令
特定任务的流程	技能
agent 跨线程学习和保留的知识	记忆
应用逻辑和外部调用	工具、MCP 连接器或中间件

另请参阅

• 项目结构
• 部署 agent
• 使用 Context Hub
• 使用 SDK 管理上下文

---