# 查询智能体详情

`GET` `/api/agent/detail`

根据智能体ID查询智能体的详细信息，包含基础信息、头像、技能矩阵和功能开关等。

## 请求参数

### Query 参数

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

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | AgentDetailVO | 响应数据 |
|     agentId | integer | 智能体ID |
|     agentName | string | 智能体名称 |
|     agentDescription | string | 智能体描述 |
|     avatarUrl | string | 头像URL |
|     agentSoul | string | 灵魂设定 |
|     disabledBuiltinSkills | array | 禁用的内置技能列表 |
|     defaultModelName | string | 自定义默认模型名称。为 null 表示未设置自定义默认模型（沿用系统默认）；前端可据此判断是否「已自定义」 |
|     effectiveModelName | string | 实际生效的模型名称。当未自定义默认模型时回落为系统默认模型，恒非空；前端下拉框应使用该字段预选 |
|     imageModelName | string | 图片理解模型名称（file 工具 view 图片时使用的视觉模型）。为 null 表示未设置、使用系统默认视觉模型 |
|     createdAt | string | 创建时间 |
|     cronEnabled | boolean | 是否启用定时任务能力 |
|     slashCommandEnabled | boolean | 是否启用斜杠命令 |
|     codeExecuteEnabled | boolean | 是否启用代码执行能力 |
|     shellExecEnabled | boolean | 是否启用Shell执行能力 |
|     webSearchEnabled | boolean | 是否启用联网搜索能力 |
|     webFetchEnabled | boolean | 是否启用网页读取能力 |
|     soulWriteEnabled | boolean | 是否允许Agent自主修改SOUL.md（人设文件），true表示可自主修改，false表示只读 |
|     humanQuestionEnabled | boolean | 是否允许智能体向用户提问并等待回答 |
|     agentIdentity | string | 智能体身份定义内容 |
|     skillScope | string | 技能隔离范围，可选值：AGENT（所有用户共享自定义技能，默认）、PRINCIPAL（按用户隔离，每个用户拥有独立私有技能集） |
| 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处理 |