# 更新智能体基本定义

`PUT` `/api/agent/updateDefinition`

仅更新智能体名称和描述，不修改灵魂设定、身份定义、模型、技能、头像或能力配置。更新成功后返回最新的基本定义；如需同时修改灵魂设定，请继续使用兼容接口 updateBasicInfo。

## 请求参数

### 请求体（JSON）

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| agentId | integer | 是 | 智能体ID |
| agentName | string | 是 | 智能体名称，去除首尾空白后不能为空，最多128个字符 |
| agentDescription | string | 否 | 智能体描述，最多512个字符；传null或空白字符串表示清空描述 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | AgentDefinition | 响应数据 |
|     agentId | integer | - |
|     agentName | string | - |
|     agentDescription | string | - |
|     gmtModified | string | - |
| 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处理 |