# 查询技能列表

`GET` `/api/agent/skills`

根据智能体ID查询该智能体下的技能列表，包含内置技能和自定义技能。当智能体技能隔离范围为PRINCIPAL模式时，传递 X-Principal-Id 可按身份主体过滤技能数据；未传递则返回该智能体下所有技能。

身份说明：当您通过API访问本系统时，可在请求头中传递 X-Principal-Id 以按身份主体过滤技能（可选）；当您通过页面访问本系统时，无需传递。

## 请求参数

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| agentId | integer | 是 | 智能体ID，必填 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | array | 响应数据 |
|     id | integer | - |
|     name | string | - |
|     description | string | - |
|     type | string | - |
|     enabled | boolean | - |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |