# 删除智能体

`DELETE` `/api/agent/delete`

标准软删除智能体及其定义资源，返回统一删除时间和各类资源的软删除数量。调用前应先使用 deleteCheck 展示删除影响；执行删除时系统会再次检查，如果状态变化导致不可删除，将返回HTTP 409及最新删除检查结果。会话、运行记录、附件和配置快照等历史资源会按删除检查结果保留。

## 请求参数

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| agentId | integer | 是 | 待删除的智能体ID |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | AgentDeleteResult | 响应数据 |
|     agentId | integer | - |
|     deletedAt | integer | - |
|     deletedResources | AgentDeleteResourceCounts | - |
|         agent | integer | - |
|         customSkills | integer | - |
|         permissionRules | integer | - |
|         dynamicCommands | integer | - |
|         finxServices | integer | - |
|         finxTools | integer | - |
|         finxCredentials | integer | - |
|         scheduledTasks | integer | - |
|         agentHubDrafts | integer | - |
| 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处理 |