创建专家套件

将 <BASE_URL> 替换为所在企业环境的 API 域名。

• Scope：admin.v1.expert-suites.manage
• 权限项：专家套件管理（expert-suites）
• 权限类型：管理
• 接口：POST/api/openapi/v1/expert-suites

认证与请求头

使用应用 API Key 调用。当前接口只校验上方独立 Scope；读取、管理与执行权限互不隐含。

请求参数

请求示例

cURL

curl --request POST \
  --url '<BASE_URL>/api/openapi/v1/expert-suites' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Idempotency-Key: <UNIQUE_REQUEST_ID>' \
  --header 'Content-Type: application/json' \
  --data '{
  "category_id": "<uuid>",
  "clients": [
    "<string>"
  ],
  "command_count": 0,
  "connector_refs": [
    {
      "connector_id": "<string>",
      "connector_origin": "<string>",
      "required": false
    }
  ],
  "description": "<string>",
  "description_cn": "<string>",
  "display_name": "<string>",
  "display_name_cn": "<string>",
  "icon_upload_id": "<uuid>",
  "icon_url": "<string>",
  "name": "<string>",
  "skill_count": 0,
  "status": "draft",
  "upload_id": "<uuid>",
  "version": "<string>"
}'

响应

201 Created

响应示例

{
  "clients": [
    "<string>"
  ],
  "command_count": 0,
  "commands": [
    {}
  ],
  "connector_count": 0,
  "connector_refs": [
    {
      "connector_id": "<string>",
      "connector_origin": "<string>",
      "required": false
    }
  ],
  "connectors": [
    {}
  ],
  "created_at": "2026-08-27T10:00:00Z",
  "description": "<string>",
  "description_cn": "<string>",
  "display_name": "<string>",
  "display_name_cn": "<string>",
  "has_package": false,
  "icon_url": "<string>",
  "id": "<string>",
  "name": "<string>",
  "origin": "<string>",
  "readme_content": "<string>",
  "readme_content_cn": "<string>",
  "revision": 0,
  "skill_count": 0,
  "skills": [
    {}
  ],
  "source_type": "official",
  "status": "<string>",
  "updated_at": "2026-08-27T10:00:00Z",
  "version": "<string>"
}

default Flat business error

响应示例

{
  "code": "<string>",
  "detail": "<string>",
  "details": {
    "field": "<string>",
    "reason": "<string>",
    "suggestion": "<string>"
  },
  "error": "<string>"
}