获取 Skill 列表

获取指定成员当前可用的全部 Skill。

请求URL

GET https://lxapi.lexiangla.com/cgi-bin/v2/ai/skills

请求头

参数	是否必须	说明
Authorization	是	接口调用凭证 access_token 值格式："Bearer access_token" 示例值："Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJS"
x-staff-id	是	成员帐号，响应只返回该成员当前可用的 Skill

其他说明

事项	说明
权限要求	AI 助手
频率限制	3000次/分钟

响应

200 OK 状态码

{
  "code": 0,
  "message": "success",
  "request_id": "10f012cd-xxxxb-42b0-bc46-a33a2c779f2a",
  "data": {
    "skills": [
      {
        "id": "1dbd20a09f93433792df19fda10a735a",
        "name": "PPT 制作",
        "description": "根据知识和要求，生成 PPT",
        "skill_name": "guided-ppt-creation-workflow",
        "skill_description": "PPT 演示文稿生成技能"
      }
    ]
  }
}

响应参数说明

参数	说明
code	状态码：0 表示成功，非 0 表示失败
message	状态信息：success 表示成功，其他值为失败信息
request_id	请求的唯一标识 ID
data.skills	当前成员可用的 Skill 列表；没有可用 Skill 时返回空数组 []
data.skills[].id	Skill ID
data.skills[].name	Skill 展示名称
data.skills[].description	Skill 展示描述
data.skills[].skill_name	Agent 加载 Skill 时使用的名称
data.skills[].skill_description	Agent 加载 Skill 时使用的描述

错误响应

400 Bad Request 状态码（未传入成员帐号）

{
  "code": 51,
  "message": "必须指定员工账号",
  "request_id": "10f012cd-xxxxb-42b0-bc46-a33a2c779f2a",
  "data": null
}

401 Unauthorized 状态码（鉴权失败）

{
  "code": 41,
  "message": "AccessToken 无效",
  "request_id": "10f012cd-xxxxb-42b0-bc46-a33a2c779f2a",
  "data": null
}