Skip to main content

删除 Agent

删除 Agent 配置;已有 Session 使用创建时的快照,不受影响。

接口

DELETE /agents/{agent_id} 成功返回 200 和删除信封。删除为软归档:Agent 标记为已删除并记录删除时间,之后获取或再次删除返回 404。 删除只归档 Agent,不停止已有 Session,也不清理环境。已有 Session 使用创建时的 Agent 快照,不受后续删除影响。

路径参数

agent_id string (必选)Agent ID,按不透明字符串使用本接口没有请求体和 Query 参数。

请求示例

curl -sS -X DELETE "$BASE_URL/agents/agent_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "OpenAI-Beta: agents=v1"

响应字段

id string被删除的 Agent IDobject stringAgent 删除结果对象类型,固定为 agent.deleteddeleted boolean是否删除成功,删除成功时为 true

响应示例

{
  "id": "agent_xxx",
  "object": "agent.deleted",
  "deleted": true
}

错误码

业务错误返回 error 对象,包含 type、code、message 和 param。常见错误如下:
HTTP 状态码错误类型 / 错误码解决方案
401authentication_error / invalid_api_key在请求头携带有效的 Authorization: Bearer $DASHSCOPE_API_KEY
404not_found_error / not_found_error使用当前工作空间中存在且未删除的 Agent ID
500server_error / server_error稍后重试;持续失败时提交工单并提供 x-request-id