创建技能
更新时间：2026-11-13
POST
https://api.dumate.cn/api/dma/v1/skills
本接口用于创建技能（Skill），请求格式为 multipart/form-data。技能是一组可复用的指令和脚本文件，挂载到智能体（Agent）的 skills 字段后供智能体使用。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
files[]
array
技能文件，可传多个。
文件名带目录前缀表示相对路径，例如 demo-skill/SKILL.md，下载版本内容时保留该目录结构。
上传的文件必须包含位于顶层目录下的 SKILL.md，技能版本的 name、description 从该文件的同名字段解析。SKILL.md 的格式如下：
text
---
name: doc-test-skill
description: A minimal skill used for API documentation testing.
---
# doc-test-skill
技能的指令正文，供智能体在运行时参考。创建成功后返回技能对象，并同时生成第一个版本，latest_version_id 为该版本的标识。
必选
显示子属性
隐藏子属性
items
string
display_name
string
显示名称，长度不超过 128 个字符。
可选
请求结构
POST /api/dma/v1/skills HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: multipart/form-data示例代码
请求示例
curl --location --request POST "https://api.dumate.cn/api/dma/v1/skills" \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--form 'display_name=doc-test-skill' \
--form 'files[]=@demo-skill/SKILL.md;filename=demo-skill/SKILL.md' \
--form 'files[]=@demo-skill/reference.md;filename=demo-skill/reference.md'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
type
string
资源类型标识，固定为 skill。
可选
id
string
技能（Skill）标识。
可选
display_name
string
显示名称。
可选
source
object {1}
技能来源。
可选
显示子属性
隐藏子属性
type
string
技能来源。
可选值：custom（用户自建）、official（平台预置）。
可选
latest_version_id
string
最新版本的标识。
可选
created_at
string
创建时间，RFC 3339 格式，UTC。
可选
updated_at
string
最近更新时间，RFC 3339 格式，UTC。
可选
响应示例
{
"id": "3054bd77-53c4-4372-721d-d6215d3ff4e5",
"type": "skill",
"display_name": "doc-test-skill",
"latest_version_id": "aa3c4c4c-38ea-4323-81f8-b32eb1f899b4",
"source": {
"type": "custom"
},
"created_at": "2026-11-11T06:52:37Z",
"updated_at": "2026-11-11T06:52:37Z"
}评价此篇文章