DELETE /agents/{aid}
删除 Agent。
DELETE /cells/{cellID}/agents/{aid}
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
cellID | string | Cell ID |
aid | string | Agent ID |
请求体
无。
curl 示例
curl -s -X DELETE "http://localhost:9091/cells/dept-legal/agents/agent-legal" \
-H "Authorization: Bearer $TOKEN" | jq .
响应
200 OK
{
"ok": true
}
注意事项
- 删除 Agent 不会删除该 Agent 已有的会话和消息记录。
- 删除后，新的 Run 不能再指定该 Agent ID。
- 对不存在的 Agent 执行删除返回 200（幂等）。
错误码
| HTTP | 错误 | 说明 |
|---|---|---|
| 401 | — | 未认证或 Token 无效 |
| 403 | — | Token scope 不足（需要 cell:admin） |
| 404 | — | Cell 不存在 |
相关端点
- GET /agents — 列出 Agent
- POST /agents — 注册 / 更新 Agent
- GET /agents/{aid} — 获取 Agent 详情