# 查询服务列表

`GET` `/api/agent/finx/listServices`

查询指定智能体可用的 Finx 服务摘要列表，包含全局服务。每个服务项包含 categories（所属市场分类）和 groups（供应商分组标签）两组标签，标签含 id（稳定键，用于前端筛选/回链）和 name（展示名）；仅全局/市场服务可能有值，智能体专属服务恒为空数组。身份说明：当您通过API访问本系统时，请求头中必须传递 X-Principal-Id 以标识操作主体；当您通过页面访问本系统时，无需传递。

## 请求参数

### 请求头参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| X-Principal-Id | integer | 否 | 身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。 |

### Query 参数

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

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | array | 响应数据 |
|     id | integer | - |
|     name | string | - |
|     displayName | string | - |
|     logoUrl | string | - |
|     description | string | - |
|     type | string | - |
|     enabled | boolean | - |
|     toolCount | integer | - |
|     createdAt | string | - |
|     updatedAt | string | - |
|     authRequired | boolean | - |
|     hasAuth | boolean | - |
|     categories | array | - |
|         id | integer | - |
|         name | string | - |
|     groups | array | - |
|         id | integer | - |
|         name | string | - |
|     system | 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处理 |