根据智能体ID和技能名称查询指定技能的详细信息，包含技能描述、内容、文件树等。
GET
/api/agent/skill/detail查询技能详情
请求参数
请求头参数1 个字段
X-Principal-Idintegernullable
身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。
Query 参数2 个字段
agentIdintegerrequired
智能体ID，必填
skillNamestringrequired
技能名称，必填
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataCustomSkillDetailnullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理
POST
/api/agent/skill/importFromZip导入自定义技能
上传 ZIP 压缩包导入自定义技能到指定智能体，可通过 overwrite 参数控制是否覆盖同名技能，通过 skillType 指定技能类型。
请求参数
请求头参数1 个字段
X-Principal-Idintegernullable
身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。
Query 参数3 个字段
agentIdintegerrequired
智能体ID
overwritebooleannullable
是否覆盖同名技能
skillTypestringnullable
技能类型，可选值：CUSTOM（自定义技能）、SYSTEM（系统技能），不传时默认为 CUSTOM
Form Data1 个字段
filestringrequired
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataSkillImportFromZipResultnullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理
POST
/api/agent/skill/installFromHub从技能市场安装技能
校验技能对当前应用可见且目标智能体属于当前应用后执行安装；调用方重试时应复用requestId。
请求参数
请求头参数1 个字段
X-Principal-Idintegernullable
身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。
请求体（JSON）3 个字段
skillHubIdintegerrequired
技能市场中的技能ID
agentIdintegerrequired
目标智能体ID
requestIdstringnullable
安装幂等请求ID；重试时应复用同一个值，最长64个字符
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataintegernullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理
GET
/api/agent/skill/download下载自定义技能
根据技能ID下载技能的 ZIP 压缩包文件。
请求参数
请求头参数1 个字段
X-Principal-Idintegernullable
身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。
Query 参数1 个字段
skillIdintegerrequired
技能ID
响应
200
POST
/api/agent/skill/toggleEnabled禁用/启用技能
根据智能体ID和技能名称切换技能的启用/禁用状态，支持系统技能和自定义技能。PRINCIPAL 技能隔离模式下，系统通过当前登录身份自动按 (agentId, principalId, skillName) 定位该用户的自定义技能；系统技能的启停始终为智能体级别。
请求参数
请求头参数1 个字段
X-Principal-Idintegernullable
身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。
请求体（JSON）3 个字段
agentIdintegerrequired
智能体ID
skillNamestringrequired
技能名称（系统技能或自定义技能均可）
enabledbooleanrequired
是否启用
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataobjectnullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理
POST
/api/agent/skill/changeType变更技能类型
将指定智能体下的技能在 CUSTOM（自定义技能）和 SYSTEM（系统技能）之间进行类型转换。内置系统技能不可转换；转为 SYSTEM 时若与内置技能同名会被拒绝。变更后技能ID可能发生变化，请以返回值为准。
请求参数
请求头参数1 个字段
X-Principal-Idintegernullable
身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。
请求体（JSON）3 个字段
agentIdintegerrequired
智能体ID
skillNamestringrequired
技能名称
targetTypestringrequired
目标技能类型，可选值：CUSTOM（自定义技能）、SYSTEM（系统技能）
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataintegernullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理
POST
/api/agent/skill/delete删除自定义技能
根据智能体ID和技能名称删除指定的自定义技能。
请求参数
请求头参数1 个字段
X-Principal-Idintegernullable
身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。
请求体（JSON）2 个字段
agentIdintegerrequired
智能体ID
skillNamestringnullable
技能名称
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
databooleannullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID，用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码，前端可据此做特殊UI处理