使用 Context Hub

了解如何在 LangSmith Context Hub 中创建、查看和提升上下文。

Context Hub 为你的团队提供版本控制、环境感知的方式来管理 agent 在生产环境中使用的指令和工具。上下文 是在 LangSmith 中管理的、由 agent 指令和工具组成的版本化捆绑包，可以是 skill 或完整 agent。

使用本指南创建你的第一个上下文、查看其文件和历史，并将其提升到环境，以便你的 agent 可以拉取它。

1. 打开 Context Hub

NOTE

如果你在左侧导航中看不到 Context，请验证你的工作区已启用 Context Hub，并且你拥有所需权限。

在 LangSmith UI 中，在 左侧导航中选择 Context。Context Hub 会列出工作区中的每个 agent 和 skill。

2. 创建上下文

1. 点击 Context Hub 左上角的 + Create。

2. 选择上下文类型：

   • Agent： 包含 AGENTS.md 文件和工具的完整 agent 捆绑包。
   • Skill： agent 可以使用的可复用能力，包含 SKILL.md 文件。
   

3. 填写名称和描述。对于 skill，描述是必填项。你现在也可以输入初始文件内容（skill 为 SKILL.md，agent 为 AGENTS.md），或者在创建后添加。点击 Create Agent 或 Create Skill。LangSmith 会创建仓库并打开它以供编辑。

3. 查看上下文

从 Context Hub 点击一个 agent 或 skill 以查看它。

中间面板显示当前提交的文件树，右侧面板预览所选文件。点击中间面板中的文件以打开它。

Markdown 文件会在 Preview 中打开，这是只读渲染。要更改文件，请切换到右侧面板右上角的 Edit 选项卡：它会显示文件中的确切文本。保存更改以创建新提交。

每次保存都会在左侧历史面板中创建一个新提交。选择一个提交以浏览其文件。目前，Context Hub 不提供文件比较视图，也不提供将先前版本恢复为最新提交的操作。

4. 标记并提升提交

提交准备好发布后，将其提升到环境，以便下游 agent 可以拉取它。

NOTE

Context Hub 目前支持两个用于提升的环境标签：staging 和 production。

1. 选择目标提交后，点击右上角的 Promote。

2. 选择目标环境：

   • Promote to Production： 你的生产 agent 拉取的提交。
   • Promote to Staging： 用于验证的预生产环境。
   

3. 环境标签（例如 Production 7ca95573）会移动到 被提升的提交。使用 Promote 旁边的 Tag 按钮为任何提交附加 人类可读的标签以便参考。

通过环境标签（例如 :production）解析上下文的 agent 运行时现在会拉取这个已提升的提交。

要在环境中使用先前版本，请选择该提交并将其提升到 staging 或 production。这会将环境标签移动到所选提交。它不会更改最新文件或创建回滚提交。

后续步骤

• 上下文工程概念：了解 skill、agent、版本控制和共享。
• 使用 SDK 管理上下文：以编程方式推送、拉取、列出和删除上下文。
• 配置提交 webhook：将工作区 Context Hub 提交发送到外部 HTTPS 端点。
• 在沙箱中挂载 Context Hub 仓库：为沙箱代码提供对仓库的只读文件系统访问，并随其变化保持同步。

---