세션 실행 가져오기

얻다 /api/v1/projects/{id}/sessions/{session_id}/runs

베어러 인증

세션의 가장 오래된 실행부터 각 단계를 순서대로 반환합니다. 단계는 종류, 실행 내 시작 오프셋, 기간, 토큰 수, 상태 및 step_number를 포함합니다.

경로 매개변수

id 문자열 필수 사항

프로젝트 ID
session_id 문자열 필수 사항

세션 ID

쿼리 매개변수

Workspace_id 문자열

작업 공간 확인을 위한 작업 공간 ID

응답

406

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

지원되지 않거나 잘못된 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

애플리케이션/vnd.agent-engine-2026-09-20-preview+json

애플리케이션/vnd.agent-engine-2026-09-20-preview+json application/json

확인
응답 속성 숨기기 응답 속성 표시 객체
- 카운트 integer
- 실행 배열[객체]
  
  런 속성 숨기기 실행 속성 표시 객체
  
  active_duration_ms integer
  
  Completion_tokens integer
  
  duration_ms integer
  
  DurationMS는 실행 시작부터 마지막 업데이트 까지의 실제 시간입니다.
  
  오류 문자열
  
  error_code 문자열
  
  execution_id 문자열
  
  invoker_user_id 문자열
  
  Memory_recalls integer
  
  MemoryRecalls 및 Memory Saves는 잘린 읽기의 하한인 확정된 메모리 단계를 계산합니다.
  
  메모리_저장 integer
  
  prompt_tokens integer
  
  PromptTokens 및 CompletionTokens는 TotalTokens를 분할 . 실행 에 확정된 llm 단계가 없는 경우 둘 다 없습니다.
  
  run_number integer
  
  RunNumber는 세션에서 실행의 1 기반 위치로, 가장 오래된 것부터입니다. truncated가 true이면 대신 반환된 창 기준으로 합니다. 즉, 가장 오래된 실행이 상한선에서 삭제되므로 1 실행 세션의 첫 번째 실행이 아닙니다.
  
  session_id 문자열
  
  slowest_step 객체
  
  실행 에 확정된 단계가 없는 경우에는 SlowestStep이 없습니다.
  
  slowest_step 속성 숨기기 slowest_step 속성 표시 객체
  
  duration_ms 숫자
  
  kind 문자열
  
  이름 문자열
  
  step_number integer
  
  started_at 문자열
  
  startup_failure 객체
  
  startup_failure 속성 숨기기 startup_failure 속성 표시 객체
  
  Boot_id 문자열
  
  코드 문자열
  
  구성 요소 문자열
  
  상 문자열
  
  source 문자열
  
  상태 문자열
  
  단계 배열[객체]
  
  단계 속성 숨기기 단계 속성 표시 객체
  
  Completion_tokens integer
  
  duration_ms 숫자
  
  DurationMS는 아직 해결되지 않은 단계에 대해 존재하지 않습니다.
  
  오류 문자열
  
  kind 문자열
  
  종류는 llm, 도구, 메모리, 가드레일, 정책, a2a 또는 에이전트_단계와 같은 단계의 카테고리입니다.
  
  Memory_op 문자열
  
  MemoryOp는 "recall"입니다. 또는 "저장" 확정된 메모리 단계에서 실행되며, 그렇지 않으면 부재합니다.
  
  이름 문자열
  
  제공 문자열
  
  presentation_truncated 부울
  
  prompt_tokens integer
  
  PromptTokens 및 CompletionTokens 분할 TotalTokens, 둘 다 확정된 llm 단계에만 존재합니다.
  
  review_outcome 문자열
  
  ReviewOutcome, WaitMS 및 ReviewTrigger는 대기 상태 ('pending', 그 다음 'approved'/'rejected'), 확정된 길이(ms)(대기 중 부재), 검토 위해 전화하세요.
  
  Review_trigger 문자열
  
  리뷰 문자열
  
  Reviewer/ReviewerNotes/Presented는 OE 검토 기록 미러링합니다: 결정된 사람, 메모, 리뷰한 내용의 발췌문.
  
  Reviewer_notes 문자열
  
  run_id 문자열
  
  RunID는 그래프 노드 호출의 식별자로, Agent_step에만 존재합니다. 노드 단계를 node_executions 행에 연결하는 유일한 키입니다.
  
  span_id 문자열
  
  SpanID는 이 단계를 span 컬렉션 의 전체 추적 세부 정보에 결합합니다.
  
  start_offset_ms integer
  
  StartOffsetMS는 실행 시작 시점부터 이 단계 시작 시점까지의 밀리초입니다.
  
  started_at 문자열
  
  상태 문자열
  
  step_number integer
  
  StepNumber는 인터럽트 엔드포인트가 목표로 하는 값입니다. 그래프 구조를 기록하고 중단 가능한 단계가 없는 Agent_step이 없습니다.
  
  tool_call_id 문자열
  
  total_tokens integer
  
  TotalTokens는 결제된 llm 단계에만 존재합니다.
  
  wait_ms integer
  
  요약 문자열
  
  요약은 실행을 호출하는 메시지로, 서버 측에서 잘린 내용입니다.
  
  time_to_first_event_ms integer
  
  TimeToFirstEventMS는 첫 번째 단계의 오프셋으로, 실행 아직 단계가 없는 경우에는 존재하지 않습니다.
  
  total_tokens integer
  
  TotalTokens는 실행의 확정된 llm 단계를 합산하므로 실행 이 실제로 소비한 금액의 하한입니다.
  
  user_id 문자열
  
  UserID 및 InvokerUserID는 실행의 실행 ID, 즉 위임 대상으로 실행된 실행 과 이를 시작한 게이트웨이 인증 호출자를 미러링합니다. 둘 중 하나가 없을 수 있습니다 - OE의 SessionRun을 참조하세요. 둘 다 지원 안전 보기에서 생략됩니다.
  
  wait_ms integer
  
  WaitMS는 실행의 확정된 인적 검토 대기로, 실행 일시 중단되지 않은 경우에는 존재하지 않습니다. ActiveDurationMS는 해당 대기를 제외합니다. 둘 다 이전의 오케스트레이션 엔진 에 없습니다.
  
  Workspace_id 문자열
- 잘린 부울
  
  잘린 경우에는 세션이 한 번의 읽기에서 OE가 반환하는 것보다 더 많은 행이 있다고 보고하므로 이는 부분적인 보기입니다. OE 응답에서 미러링됩니다.
응답 속성 숨기기 응답 속성 표시 객체
- 카운트 integer
- 실행 배열[객체]
  
  런 속성 숨기기 실행 속성 표시 객체
  
  active_duration_ms integer
  
  Completion_tokens integer
  
  duration_ms integer
  
  DurationMS는 실행 시작부터 마지막 업데이트 까지의 실제 시간입니다.
  
  오류 문자열
  
  error_code 문자열
  
  execution_id 문자열
  
  invoker_user_id 문자열
  
  Memory_recalls integer
  
  MemoryRecalls 및 Memory Saves는 잘린 읽기의 하한인 확정된 메모리 단계를 계산합니다.
  
  메모리_저장 integer
  
  prompt_tokens integer
  
  PromptTokens 및 CompletionTokens는 TotalTokens를 분할 . 실행 에 확정된 llm 단계가 없는 경우 둘 다 없습니다.
  
  run_number integer
  
  RunNumber는 세션에서 실행의 1 기반 위치로, 가장 오래된 것부터입니다. truncated가 true이면 대신 반환된 창 기준으로 합니다. 즉, 가장 오래된 실행이 상한선에서 삭제되므로 1 실행 세션의 첫 번째 실행이 아닙니다.
  
  session_id 문자열
  
  slowest_step 객체
  
  실행 에 확정된 단계가 없는 경우에는 SlowestStep이 없습니다.
  
  slowest_step 속성 숨기기 slowest_step 속성 표시 객체
  
  duration_ms 숫자
  
  kind 문자열
  
  이름 문자열
  
  step_number integer
  
  started_at 문자열
  
  startup_failure 객체
  
  startup_failure 속성 숨기기 startup_failure 속성 표시 객체
  
  Boot_id 문자열
  
  코드 문자열
  
  구성 요소 문자열
  
  상 문자열
  
  source 문자열
  
  상태 문자열
  
  단계 배열[객체]
  
  단계 속성 숨기기 단계 속성 표시 객체
  
  Completion_tokens integer
  
  duration_ms 숫자
  
  DurationMS는 아직 해결되지 않은 단계에 대해 존재하지 않습니다.
  
  오류 문자열
  
  kind 문자열
  
  종류는 llm, 도구, 메모리, 가드레일, 정책, a2a 또는 에이전트_단계와 같은 단계의 카테고리입니다.
  
  Memory_op 문자열
  
  MemoryOp는 "recall"입니다. 또는 "저장" 확정된 메모리 단계에서 실행되며, 그렇지 않으면 부재합니다.
  
  이름 문자열
  
  제공 문자열
  
  presentation_truncated 부울
  
  prompt_tokens integer
  
  PromptTokens 및 CompletionTokens 분할 TotalTokens, 둘 다 확정된 llm 단계에만 존재합니다.
  
  review_outcome 문자열
  
  ReviewOutcome, WaitMS 및 ReviewTrigger는 대기 상태 ('pending', 그 다음 'approved'/'rejected'), 확정된 길이(ms)(대기 중 부재), 검토 위해 전화하세요.
  
  Review_trigger 문자열
  
  리뷰 문자열
  
  Reviewer/ReviewerNotes/Presented는 OE 검토 기록 미러링합니다: 결정된 사람, 메모, 리뷰한 내용의 발췌문.
  
  Reviewer_notes 문자열
  
  run_id 문자열
  
  RunID는 그래프 노드 호출의 식별자로, Agent_step에만 존재합니다. 노드 단계를 node_executions 행에 연결하는 유일한 키입니다.
  
  span_id 문자열
  
  SpanID는 이 단계를 span 컬렉션 의 전체 추적 세부 정보에 결합합니다.
  
  start_offset_ms integer
  
  StartOffsetMS는 실행 시작 시점부터 이 단계 시작 시점까지의 밀리초입니다.
  
  started_at 문자열
  
  상태 문자열
  
  step_number integer
  
  StepNumber는 인터럽트 엔드포인트가 목표로 하는 값입니다. 그래프 구조를 기록하고 중단 가능한 단계가 없는 Agent_step이 없습니다.
  
  tool_call_id 문자열
  
  total_tokens integer
  
  TotalTokens는 결제된 llm 단계에만 존재합니다.
  
  wait_ms integer
  
  요약 문자열
  
  요약은 실행을 호출하는 메시지로, 서버 측에서 잘린 내용입니다.
  
  time_to_first_event_ms integer
  
  TimeToFirstEventMS는 첫 번째 단계의 오프셋으로, 실행 아직 단계가 없는 경우에는 존재하지 않습니다.
  
  total_tokens integer
  
  TotalTokens는 실행의 확정된 llm 단계를 합산하므로 실행 이 실제로 소비한 금액의 하한입니다.
  
  user_id 문자열
  
  UserID 및 InvokerUserID는 실행의 실행 ID, 즉 위임 대상으로 실행된 실행 과 이를 시작한 게이트웨이 인증 호출자를 미러링합니다. 둘 중 하나가 없을 수 있습니다 - OE의 SessionRun을 참조하세요. 둘 다 지원 안전 보기에서 생략됩니다.
  
  wait_ms integer
  
  WaitMS는 실행의 확정된 인적 검토 대기로, 실행 일시 중단되지 않은 경우에는 존재하지 않습니다. ActiveDurationMS는 해당 대기를 제외합니다. 둘 다 이전의 오케스트레이션 엔진 에 없습니다.
  
  Workspace_id 문자열
- 잘린 부울
  
  잘린 경우에는 세션이 한 번의 읽기에서 OE가 반환하는 것보다 더 많은 행이 있다고 보고하므로 이는 부분적인 보기입니다. OE 응답에서 미러링됩니다.
400

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

잘못된 요청
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
401

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

승인되지 않음
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
500

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

내부 서버 오류
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
502

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

잘못된 게이트웨이
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울

GET /api/v1/projects/{id}/sessions/{session_id}/runs

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/sessions/{session_id}/runs' \
 --header "Authorization: $API_KEY"

응답 예시(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)

{
  "count": 42,
  "runs": [
    {
      "active_duration_ms": 42,
      "completion_tokens": 42,
      "duration_ms": 42,
      "error": "string",
      "error_code": "string",
      "execution_id": "string",
      "invoker_user_id": "string",
      "memory_recalls": 42,
      "memory_saves": 42,
      "prompt_tokens": 42,
      "run_number": 42,
      "session_id": "string",
      "slowest_step": {
        "duration_ms": 42.0,
        "kind": "string",
        "name": "string",
        "step_number": 42
      },
      "started_at": "string",
      "startup_failure": {
        "boot_id": "string",
        "code": "string",
        "component": "string",
        "phase": "string",
        "source": "string"
      },
      "status": "string",
      "steps": [
        {
          "completion_tokens": 42,
          "duration_ms": 42.0,
          "error": "string",
          "kind": "string",
          "memory_op": "string",
          "name": "string",
          "presented": "string",
          "presented_truncated": true,
          "prompt_tokens": 42,
          "review_outcome": "string",
          "review_trigger": "string",
          "reviewer": "string",
          "reviewer_notes": "string",
          "run_id": "string",
          "span_id": "string",
          "start_offset_ms": 42,
          "started_at": "string",
          "status": "string",
          "step_number": 42,
          "tool_call_id": "string",
          "total_tokens": 42,
          "wait_ms": 42
        }
      ],
      "summary": "string",
      "time_to_first_event_ms": 42,
      "total_tokens": 42,
      "user_id": "string",
      "wait_ms": 42,
      "workspace_id": "string"
    }
  ],
  "truncated": true
}

응답 예시(200)

{
  "count": 42,
  "runs": [
    {
      "active_duration_ms": 42,
      "completion_tokens": 42,
      "duration_ms": 42,
      "error": "string",
      "error_code": "string",
      "execution_id": "string",
      "invoker_user_id": "string",
      "memory_recalls": 42,
      "memory_saves": 42,
      "prompt_tokens": 42,
      "run_number": 42,
      "session_id": "string",
      "slowest_step": {
        "duration_ms": 42.0,
        "kind": "string",
        "name": "string",
        "step_number": 42
      },
      "started_at": "string",
      "startup_failure": {
        "boot_id": "string",
        "code": "string",
        "component": "string",
        "phase": "string",
        "source": "string"
      },
      "status": "string",
      "steps": [
        {
          "completion_tokens": 42,
          "duration_ms": 42.0,
          "error": "string",
          "kind": "string",
          "memory_op": "string",
          "name": "string",
          "presented": "string",
          "presented_truncated": true,
          "prompt_tokens": 42,
          "review_outcome": "string",
          "review_trigger": "string",
          "reviewer": "string",
          "reviewer_notes": "string",
          "run_id": "string",
          "span_id": "string",
          "start_offset_ms": 42,
          "started_at": "string",
          "status": "string",
          "step_number": 42,
          "tool_call_id": "string",
          "total_tokens": 42,
          "wait_ms": 42
        }
      ],
      "summary": "string",
      "time_to_first_event_ms": 42,
      "total_tokens": 42,
      "user_id": "string",
      "wait_ms": 42,
      "workspace_id": "string"
    }
  ],
  "truncated": true
}

응답 예시(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
}

응답 예시(500)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(500)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(502)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(502)

{
  "code": "string",
  "error": "string",
  "success": true
}