为 Managed Deep Agents 添加技能

向托管深度智能体添加可复用的任务专用指令。

技能将任务专用流程和支持文件打包到可复用目录中。MDA 会自动发现它们。只有当任务与 frontmatter 中的描述匹配时，智能体才会加载技能的完整内容。

NOTE

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

将每个技能放在项目根目录的 skills/ 下：

my-agent/
  agent.py
  skills/
    research/
      SKILL.md

有关完整项目布局，请参阅项目结构。

添加技能

对于仅在任务与 frontmatter 中的描述匹配时智能体才应遵循的流程，请使用技能：

Create a skill directory

每个技能目录都需要一个 SKILL.md 文件，其 frontmatter 包含 name 和 description：

---
name: research
description: Gather and synthesize context before answering complex questions.
---

# Research

Use this skill when a task needs more than a direct answer.

1. Identify what information is missing.
2. Use `query_db` to look up relevant records.
3. Summarize findings before responding to the user.

有关技能编写模式和完整格式，请参阅技能。

要了解渐进式披露，请参阅智能体如何使用技能。

Add supporting files (Optional)

技能目录还可以包含支持脚本、参考文件和模板。请在 SKILL.md 中引用这些文件，以便智能体知道何时使用它们：

skills/
  research/
    SKILL.md
    templates/
      report.md
    scripts/
      fetch_sources.py

智能体如何使用技能

启动时，智能体会看到每个技能的 name 和 description。当任务与技能描述匹配时，智能体会读取完整的 SKILL.md 并遵循其指令。支持文件仅在需要时加载。

智能体无法在运行时修改技能。

部署

运行 mda deploy 时，MDA 会将 skills/ 下的每个 UTF-8 文件同步到智能体的 Context Hub。

然后，你可以在 LangSmith UI 中编辑技能，并将这些更改应用到智能体。

最好将仓库中的技能文件作为持久更改的事实来源，因为后续部署会再次同步项目副本，并删除本地不存在的已部署技能文件。

有关哪些内容会同步、哪些不会，以及如何从部署打开仓库，请参阅 Context Hub。

何时使用技能

概念	作用	加载时机
Instructions	始终启用的系统提示词	每次运行
Skills	任务专用流程	智能体选择它们时
Memory	智能体可更新的知识	启用持久记忆时

更多信息请参阅项目结构。

---