文档中心

数据智能体 DataAgent（私有化）

请输入

技能中心

上传技能到技能中心

将一个技能 .zip 压缩包上传到技能中心。若已存在同名技能，服务端会先删除旧版本再上传新版本（幂等 upsert）。

请求说明

项目	内容
请求方式	`POST`
请求地址	`https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/skill/upload`
默认鉴权	`Authorization: Bearer ${JWT_TOKEN}`
Content-Type	`multipart/form-data`

路径：/dataAgent/llm/openApi/v2/skill/upload
说明：upsert 以 SKILL.md 的 YAML frontmatter 中的 name 为唯一标识。

请求参数

字段	位置	类型	必填	说明
`file`	form-file	file	是	技能 `.zip` 压缩包。压缩包内必须包含 `SKILL.md`（位于压缩包根目录或一级子目录），且其 YAML frontmatter 中必须包含 `name` 字段。
`scene`	form-field	string	否	技能使用场景说明。不传或传空串时，服务端默认使用 `SKILL.md` frontmatter 中的 `description` 字段填充。
`show_name`	form-field	string	否	技能展示名称（显示名）。不传或传空串时，依次取 `SKILL.md` frontmatter 中的 `show_name` / `display_name`；若仍无则回退为技能 `name`。
`tags`	form-field	string	否	技能标签。支持重复字段（`tags=a&tags=b`）或单字段英文逗号分隔（`tags=a,b`）；空白标签会被忽略。不传则不设置标签。

技能包结构要求

压缩包内需包含一个 SKILL.md，且文件开头必须带 YAML frontmatter，例如：

---
name: my-data-analysis-skill
description: 用于数据分析的示例技能
show_name: 销售数据助手
tags: [sales, analytics]
---

## My Data Analysis Skill

技能正文说明……

name：必填，技能唯一标识；upsert 按此名称判断是否已存在。
description：可选；当请求未传 scene 时，服务端可用作 scene 的默认值。
show_name / display_name：可选；技能展示名称的默认值（请求显式传 show_name 时会覆盖它）。
打包时会自动跳过 .git、__pycache__、隐藏文件/目录等。

请求示例

1）最小可用调用（仅上传 zip）

curl -X POST \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/skill/upload" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -F 'file=@/path/to/my-skill.zip;type=application/zip' \
  --silent | jq

2）带 `scene`、`show_name` 和 `tags`

curl -X POST \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/skill/upload" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -F 'file=@/path/to/my-skill.zip;type=application/zip' \
  -F 'scene=面向销售场景的数据问答技能' \
  -F 'show_name=销售数据助手' \
  -F 'tags=sales' \
  -F 'tags=analytics' \
  --silent | jq

tags 也可以在单个字段里用英文逗号分隔（等价于上面两个重复字段），例如：

-F 'tags=sales,analytics'

返回参数

字段路径	类型	示例值	说明
`data.name`	string	`my-data-analysis-skill`	技能名称（唯一标识）。通常来自技能包内 `SKILL.md` 的 YAML frontmatter `name` 字段。
`data.skillUid`	string	`my-data-analysis-skill`	技能唯一标识，用于后续引用该技能（例如在场景/编排中绑定技能）。一般与 `data.name` 一致（以实际返回为准）。
`data.version`	string	`v1.0`	技能版本号（以实际返回为准）。
`data.replaced`	boolean	`false`	是否替换了已有同名技能：`true` 表示发生 upsert 覆盖（上传前已存在同名技能）；`false` 表示首次上传/新增。

返回示例

{
  "JSONIFY_PRETTYPRINT_REGULAR": false,
  "code": "llm/ok",
  "data": {
    "name": "my-data-analysis-skill",
    "replaced": false,
    "skillUid": "my-data-analysis-skill",
    "version": "v1.0"
  },
  "msg": {}
}

最近更新时间：2026.08.17 14:12:01

这个页面对您有帮助吗？

有用

无用

数据智能体 DataAgent（私有化）

上传技能到技能中心 #

请求说明 #

请求参数 #

技能包结构要求 #

请求示例 #