移動中のツールまたは LVM 呼び出しを中断する

POST /api/v1/projects/{id}/executions/{execution_id}/Interrupt

セッションをキャンセルせずに実行中のツールまたは LM 呼び出しを中止し、エージェントは続行します。単一の名前付き呼び出しを中断するには、step_number を送信します。現在進行中のすべての呼び出しを中断するには、 ボディを省略します。レスポンスの結果は、何が発生したかを正確に報告します: "aborted" は(移動中のドキュメントが停止された)、"ARMed" は(移動中は何も起こりません。実行の次の呼び出し用に待機します。pending=true)、"already_ARMed"" (有効期限が切れていない arm はすでに存在していました。TTL は拡張されませんでした)、"noop_ternal"" は 、 (実行はすでにターミナル になっており、別のレプリカで実行されている場合があります)、"in_flight_elsewhere" (ステップ永続レコードには実行中の呼び出しが表示されていますが、この OAレプリカには)、または "noop" は(という名前のstep_numberは移動中に何も一致しませんでした)。べき等: 繰り返しのリクエストは安全です。

path パラメータ

  • id string 必須

    プロジェクトID

  • execution_id string 必須

    実行ID

クエリ パラメータ

  • Workspace_id string

    実行を所有するワークスペースの OA に割り込みをルーティングするために必要なワークスペースID

application/ JSON

body

任意の単一呼び出しターゲット

  • step_number integer

    ステップ番号は、中断する単一のツールまたは LM 呼び出しの実行ステップです。

応答

  • サポートされていないAPIバージョンまたは不正な API バージョン、選択した公開契約で利用できない操作、または受け入れができない表現(サポートされていないメディアタイプのパラメーター、または除外された SSE を含む)。既存の認証、認可、およびレート制限の失敗が優先されます。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエート エラーでは、このフィールドは出力されません。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        検証に失敗したフィールド。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト

        フィールドとその検証の失敗。

        • 説明 string 必須

          人間が判読できる検証の失敗。

        • フィールド string 必須

          無効なリクエストフィールドの名前またはパス。

    • 詳細 string 必須

      人間が判読できるエラーの詳細。

    • エラー integer 必須

      HTTP status code.

    • errorCode string 必須

      マシンが判読できるエラー コード。

    • パラメーター array[string]

      エラーに関連付けられたリクエスト パラメータ名。該当しない場合は省略します。

    • 理由 string 必須

      HTTPステータス理由フレーズ。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエート エラーでは、このフィールドは出力されません。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        検証に失敗したフィールド。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト

        フィールドとその検証の失敗。

        • 説明 string 必須

          人間が判読できる検証の失敗。

        • フィールド string 必須

          無効なリクエストフィールドの名前またはパス。

    • 詳細 string 必須

      人間が判読できるエラーの詳細。

    • エラー integer 必須

      HTTP status code.

    • errorCode string 必須

      マシンが判読できるエラー コード。

    • パラメーター array[string]

      エラーに関連付けられたリクエスト パラメータ名。該当しない場合は省略します。

    • 理由 string 必須

      HTTPステータス理由フレーズ。

  • 200

    OK

    追加のプロパティが許可されます。

    追加のプロパティが許可されます。

  • 無効なリクエスト

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 許可されていない

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 404

    見つかりません

    追加のプロパティが許可されます。

    追加のプロパティが許可されます。

  • エンティティが大きすぎるリクエスト

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 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)
{}