智能体接口 API

由 scripts/generate-api-docs.ts 自动生成 —— 请勿手改 共 15 个端点

DELETE /agents/{id}

删除智能体（软删除）

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

GET /agents/{id}

获取智能体详情

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

PATCH /agents/{id}

更新智能体配置

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

PATCH /agents/{id}/activate

激活智能体

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

PATCH /agents/{id}/pause

暂停智能体

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

POST /agents/{id}/record-usage

记录智能体使用情况（内部调用）

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

GET /agents/{id}/statistics

获取智能体统计数据

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

POST /agents/{id}/training/cancel

取消训练任务

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

POST /agents/{id}/training/start

开始训练智能体

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
201

---

GET /agents/{id}/training/status

获取训练状态

请求参数

参数名	位置	类型	必填	说明
id	path	string	✅

响应

状态码	说明
200

---

POST /agents/bulk-create

批量创建智能体

响应

状态码	说明
201

---

POST /agents/create

创建智能体实例

请求体

{
  "$ref": "#/components/schemas/CreateAgentDto"
}

响应

状态码	说明
201	智能体创建成功

---

GET /agents/system/statistics

获取系统级统计数据

响应

状态码	说明
200

---

GET /agents/user/agents

获取用户的所有智能体

请求参数

参数名	位置	类型	必填	说明
status	query	string	✅
limit	query	number	✅
offset	query	number	✅

响应

状态码	说明
200

---

GET /agents/user/statistics

获取用户统计数据

响应

状态码	说明
200

---