本文介绍如何从技能广场、工作台或 Data Agent 创建技能，并说明技能 Markdown 内容的填写规则。

从技能广场创建技能

1. 在左侧导航栏依次单击智能体>技能广场，进入项目技能页面。
2. 在页面右上方单击新建，打开创建技能对话框。
3. 选择适用应用，目前仅支持选择Data Agent；然后选择技能的所属位置。
4. 在详细内容中填写技能Markdown内容。
5. 单击保存按钮，技能出现在技能列表中，初始状态为未发布。
6. 也可以直接单击保存并发布。

表1 新建技能配置项说明

从工作台项目或“我的”创建技能

1. 进入工作台，在左侧导航栏单击项目或我的。
2. 如果进入“项目”，先进入目标项目；如果进入“我的”，直接进入“我的”文件列表。
3. 单击页面右上方创建，选择应用 > 智能体 > 技能。
4. 系统打开技能广场的创建技能对话框。
5. 选择适用应用，所属位置默认为进入当前创建路径，然后填写详细内容。
6. 根据需求单击保存或保存并发布，在对应项目或“我的”列表中查看创建结果。

从工作台的“项目”或“我的”入口创建技能时，会跳转到技能广场完成创建；从 Data Agent 内创建时不会跳转。

在 Data Agent 中创建并发布技能

Data Agent 支持在技能选择弹窗内创建并发布技能，不需要跳转到技能广场。

1. 进入智能体 > Data Agent，在下方工具栏单击上下文按钮，选择分析技能。
2. 左侧导航栏选择项目或我的，然后单击右上方新建按钮，进行新建。
3. 选择适用应用和所属位置。
4. 在详细内容中填写符合要求的 Markdown 技能内容。
5. 单击保存并发布。技能直接发布，并添加到当前 Data Agent 的技能列表中。

填写技能 Markdown 内容

技能内容必须包含name和description字段，并按照 Markdown 格式编写正文：

1---
2name: your-skill-name
3description: 描述这个技能能够完成的任务，以及适用的场景或用户请求。
4
5---
6
7# 技能名称
8
9## 目标
10说明技能需要帮助用户完成的任务和预期结果。
11
12## 工作流程
13按执行顺序说明完成任务所需的步骤、使用的工具和必要的检查。

系统会根据 Markdown 内容自动解析技能名称和描述，创建弹窗中不需要单独填写这两个字段。

技能内容校验规则

• name 和 description 必须存在，否则无法创建技能。
• name 长度为 1～64 个字符，仅允许小写英文字母 a-z、数字 0-9 和连字符 -。
• name 不能以连字符开头或结尾，不能包含连续的 --，不能以 shengsuan- 开头。
• description 最多 1024 个字符。
• 技能详细内容不能为空。