진행 중인 도구 또는 LLM 호출 중단

POST /api/v1/projects/{id}/executions/{execution_id}/interrupt
베어러 인증

세션을 취소하지 않고 실행을 위한 진행 중인 도구 또는 LLM 호출을 중단하여 에이전트 계속 진행되도록 합니다. 단일 명명 호출을 중단하려면 step_number를 전송합니다. 본문을 생략하여 현재 진행 중인 모든 호출을 중단합니다. 응답 결과는 "중단됨" (이동 중 무언가가 중지됨), "armed&" (전송 중 아무것도 없음, 실행의 다음 호출을 위해 준비됨, 보류 중=true), "already_armed" (만료되지 않은 arm이 이미 존재했으며 TTL 확장되지 않았습니다), "noop_terminal&" (실행이 이미 종료되었으며, 다른 복제본 에서 실행 중일 수 있음), " ( 지속형 형 단계 기록 진행 중인 호출을 표시하지만 이 OE 복제본 에서는 표시하지 않습니다. 여기서는 중단된 것이 없으며 스탬프된 단계로 범위가 지정된 백스톱은 이 복제본 에서 해당 디스패치가 완료되는 경우 디스패치 시 호출을 중지합니다 — 이후 호출을 절대 포착할 수 없습니다. ) 또는 "noop" (이름이 지정된 step_number가 실행 중 일치하는 항목이 없음). 멱등: 반복된 요청은 안전합니다.

경로 매개변수

  • id 문자열 필수 사항

    프로젝트 ID

  • execution_id 문자열 필수 사항

    실행 ID

쿼리 매개변수

  • Workspace_id 문자열

    실행을 소유한 작업 공간 ID , 중단을 해당 작업 공간의 OE로 라우팅하는 데 필요합니다.

application/json

body

단일 호출 대상(선택 사항)

  • step_number integer

    StepNumber는 중단할 단일 도구/LLM 호출의 실행 단계입니다.

응답

  • 406

    지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        유효성 검사 에 실패한 필드입니다.

        필드 속성 숨기기 필드 속성 표시 객체

        필드 및 해당 유효성 검사 실패.

        • description 문자열 필수 사항

          사람이 읽을 수 있는 유효성 검사 실패.

        • 필드 문자열 필수 사항

          잘못된 요청 필드 의 이름 또는 경로입니다.

    • 세부 정보 문자열 필수 사항

      사람이 읽을 수 있는 오류 세부 정보.

    • 오류 integer 필수 사항

      HTTP status code.

    • 오류 코드 문자열 필수 사항

      기계가 읽을 수 있는 오류 코드입니다.

    • 매개변수 array[string]

      오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.

    • 이유 문자열 필수 사항

      HTTP 상태 이유 구문입니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        유효성 검사 에 실패한 필드입니다.

        필드 속성 숨기기 필드 속성 표시 객체

        필드 및 해당 유효성 검사 실패.

        • description 문자열 필수 사항

          사람이 읽을 수 있는 유효성 검사 실패.

        • 필드 문자열 필수 사항

          잘못된 요청 필드 의 이름 또는 경로입니다.

    • 세부 정보 문자열 필수 사항

      사람이 읽을 수 있는 오류 세부 정보.

    • 오류 integer 필수 사항

      HTTP status code.

    • 오류 코드 문자열 필수 사항

      기계가 읽을 수 있는 오류 코드입니다.

    • 매개변수 array[string]

      오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.

    • 이유 문자열 필수 사항

      HTTP 상태 이유 구문입니다.
  • 200

    확인

    추가 속성이 허용됩니다.

    추가 속성이 허용됩니다.
  • 400

    잘못된 요청

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 401

    승인되지 않음

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • 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) 
{}