OpenAI 删除智能体会话

2026-11-18 18:01 更新

delete /agents/sessions/{session_id}

从公开 API 中移除托管智能体会话,并返回删除确认。如果后端执行已经结束,删除会取消仍开放的公开轮次并丢弃未发布的输出。仍在运行的执行必须先取消。底层资源清理可能在后台继续。参见管理会话。

路径参数

  • session_id: string

会话 ID。

minLength: 0, maxLength: 1048576

返回值

  • AgentSessionDeleted object { id, deleted, object }

已从公开 API 中移除的 Managed Agents 会话。底层资源清理可能仍在后台进行。

  • id: string

已删除会话的 ID。

minLength: 0

  • deleted: boolean

会话是否已从公开 API 中移除,恒为 true。底层资源可能仍在清理中。

  • object: "agent.session.deleted" (default: "agent.session.deleted")

对象类型,固定为 agent.session.deleted。

  • "agent.session.deleted"

示例

## 从环境变量读取 API 密钥。
## 将 SESSION_ID 设置为目标会话的 ID。
curl https://api.openai.com/v1/agents/sessions/$SESSION_ID \
    -X DELETE \
    -H 'OpenAI-Beta: agents=v1' \
    -H "Authorization: Bearer $OPENAI_API_KEY"

200 响应示例

字段名、类型值和示例标识均按接口定义保留。

{
  "id": "id",
  "deleted": true,
  "object": "agent.session.deleted"
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号