上下文工程的核心概念

LangSmith 中上下文工程的核心概念，包括技能、智能体、版本管理和共享。

当上下文管理不当时，智能体在生产环境中的表现会很不稳定。上下文是智能体采取行动所依赖的信息，例如系统指令、工具定义和参考资料。上下文工程则是指构建并优化这层上下文，从而提升智能体性能与能力的实践。

本页介绍 LangSmith 中上下文工程的核心概念：技能、智能体、Context Hub、版本管理和共享。

技能

技能是 Context Hub 中一个带版本管理的仓库，它把智能体可以调用的某种可复用能力打包在一起。

技能仓库通常包含：

常见文件：

• 位于根目录的 SKILL.md，用于提供指令和用法指导。
• 可选的辅助文件，例如参考资料、模板和 schema。

示例包括邮件排版、代码审查和网络调研。

智能体

智能体是指借助工具、技能和子智能体端到端完成任务的人工智能系统。智能体仓库则将它的配置打包在一起，包括高层指令、已关联的技能与子智能体，以及工具配置。

智能体仓库通常包含：

常见文件：

• AGENTS.md，用于系统提示词和操作指令。
• 可选文件，例如 tools.json 以及已关联的 agents/* 或 skills/* 条目。

示例包括邮件助手、编程助手或客户支持智能体。

在技能与智能体之间取舍

技能是可复用的上下文模块。智能体仓库则是顶层的打包单元，用于定义智能体应当如何运作。

• 对于多个智能体共享的可复用指令、策略或示例，请使用技能。
• 对于单个智能体的操作指令、工具以及关联依赖，请使用智能体仓库。

关联仓库

Context Hub 的提交在 files 中支持三种条目类型：

• file：内联的文件内容。
• agent：指向另一个智能体仓库的链接。
• skill：指向另一个技能仓库的链接。

当被关联的智能体或技能仓库产生新提交时，LangSmith 会将该更新传播到引用它的父仓库。

TIP

如果你发现自己把同一段上下文复制进了多个智能体，那就把它抽出来做成一个技能仓库，然后在每个智能体中引用它。

Context Hub 与 store 后端

LangSmith 中的上下文可以由两种不同的后端来管理： Context Hub 和 store 后端。它们用途不同，而大多数智能体都会同时使用两者。

Context Hub 是智能体的长期上下文存储。它把每一次变更都记录为一个提交，并支持版本管理、共享和持续改进。

store 后端是为运行时状态而构建的。它保存智能体在运行过程中积累的信息：记忆、会话历史、用户偏好、习得的事实，以及其他随会话或用户而演变的数据。

版本管理

对 Context Hub 中仓库的每一次更改都会产生一个新的提交。提交是不可变的，并且可以浏览和比较，因此你可以：

• 精确查看某个智能体的两个版本之间发生了哪些变化。
• 如果某次更改导致行为退化，可以回退到任意先前的提交。
• 为重要的提交添加标签（例如你在某个 特定日期发布的那个提交），以便于日后查阅。
• 将某个提交提升到 Staging 或 Production 这样的环境， 这样下游智能体拉取到的是稳定的版本，而不是最新的 编辑。

如果你觉得这套工作流似曾相识，那是有意为之：Context Hub 把 Git 带给代码的那种规范，同样带给了智能体指令。

共享与权限

Context Hub 是面向团队设计的。每个仓库都位于某个工作区内，能否访问取决于工作区权限以及仓库的可见性：

• 私有仓库仅在该工作区内部可见。
• 公开仓库可以被任何人发现和拉取。
• 创建提交、添加标签以及提升环境都需要拥有该工作区的更新权限。

工作区级别的共享与可见性控制，让 Hub 成为协作开发智能体与技能、并持续改进它们的天然场所。

后续步骤

• 通过使用 Context Hub 来创建你的第一个技能或智能体。

---