中断运行中的工具或 LLM 调用

发布 /api/v1/projects/{id}/executions/{execution_id}/interrupt
持有者身份验证

中止正在进行的工具或 LLM 调用，而不取消会话，以便代理继续运行。发送step_number以中断单个命名调用；省略正文可中断当前正在进行的每个调用。响应的结果准确报告了发生的情况：“aborted” （飞行中的物体被停止），“armed” （进行中没有任何操作；已为执行的下一次调用做好准备，pending=true）， "already_armed" （未过期的臂已存在； TTL未延长），“noop_Terminal”是（执行已终止，可能在另一个副本上）， "in_flight_elsewhere" （持久性步骤记录显示该调用正在进行中，但在此 OE副本上不显示；此处未中止任何操作，如果调度在此副本上完成，则作用域为盖章步骤的后退器会在调度时停止调用 — 它永远不会捕获稍后的调用) 或“noop” （命名的“step_number”在飞行中与任何内容都不匹配）。幂等：重复请求是安全的。

路径参数

  • id 字符串 必需

    项目 ID

  • execution_id 字符串 必需

    执行ID

查询参数

  • Workspace_id 字符串

    拥有执行的工作区ID ，需要将中断路由到该工作区的 OE

application/json

body

可选的单次调用目标

  • 步骤编号 整型

    StepNumber 是单个工具/LLM 调用中断的执行步骤。

响应

  • 406

    不支持或格式不正确的API版本、所选已发布合约中不可用的操作或不可接受的表示形式（包括不支持的媒体类型参数或排除的 SSE）。现有的身份验证、授权和速率限制失败优先。

    隐藏响应属性 显示响应属性 对象
    • badRequestDetail 对象

      标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。

      隐藏 BadRequestDetail 属性 显示 BadRequestDetail 属性 对象
      • 字段 大量[对象]

        验证失败的字段。

        隐藏字段属性 显示字段属性 对象

        字段及其验证失败。

        • 描述 字符串 必需

          人类可读的验证失败。

        • 字段 字符串 必需

          无效请求字段的名称或路径。

    • 详细信息 字符串 必需

      人类可读的错误详细信息。

    • 错误 整型 必需

      HTTP status code.

    • 错误代码 字符串 必需

      机器可读的错误代码。

    • 参数 array[string]

      与错误相关的请求参数名称；不应用时省略。

    • 原因 字符串 必需

      HTTP状态原因短语。

    隐藏响应属性 显示响应属性 对象
    • badRequestDetail 对象

      标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。

      隐藏 BadRequestDetail 属性 显示 BadRequestDetail 属性 对象
      • 字段 大量[对象]

        验证失败的字段。

        隐藏字段属性 显示字段属性 对象

        字段及其验证失败。

        • 描述 字符串 必需

          人类可读的验证失败。

        • 字段 字符串 必需

          无效请求字段的名称或路径。

    • 详细信息 字符串 必需

      人类可读的错误详细信息。

    • 错误 整型 必需

      HTTP status code.

    • 错误代码 字符串 必需

      机器可读的错误代码。

    • 参数 array[string]

      与错误相关的请求参数名称；不应用时省略。

    • 原因 字符串 必需

      HTTP状态原因短语。
  • 200

    正常

    允许使用其他属性。

    允许使用其他属性。
  • 400

    Bad Request

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 401

    Unauthorized

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 404

    未找到

    允许使用其他属性。

    允许使用其他属性。
  • 413

    请求实体太大

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 502

    错误网关

    允许使用其他属性。

    允许使用其他属性。
POST /api/v1/projects/{id}/executions/{execution_id}/interrupt 
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/executions/{execution_id}/interrupt' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "step_number": 42
}'
请求示例 
{
  "step_number": 42
}
响应示例 (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
响应示例 (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
响应示例 (200) 
{}
响应示例 (200) 
{}
响应示例 (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (404) 
{}
响应示例 (404) 
{}
响应示例 (413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (502) 
{}
响应示例 (502) 
{}