실행 로그 가져오기

얻다 /api/v1/projects/{id}/execution-logs

베어러 인증

작업 공간 오케스트레이션 엔진을 통해 세션의 실행 로그를 가져옵니다. 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다.

경로 매개변수

id 문자열 필수 사항

프로젝트 ID

쿼리 매개변수

session_id 문자열 필수 사항

세션 ID
이후 문자열

RFC3339 타임스탬프 필터하다
이후 문자열

이전 응답에서 Next_cursor로 반환된 커서
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
- has_more 부울
- 로그 배열[객체]
  
  로그 속성 숨기기 로그 속성 표시 객체
  
  a2a_caller_workspace_id 문자열
  
  a2a_parent_execution_id 문자열
  
  a2a_target_agent_id 문자열
  
  a2a_target_agent_name 문자열
  
  Completion_tokens integer
  
  Cost_usd 숫자
  
  결정 문자열
  
  duration_ms 숫자
  
  오류 문자열
  
  execution_id 문자열
  
  가드레일_액션 문자열
  
  가드레일 결정 필드(LogGuardrailDecision에 의해 Kind='guardrail' 로그로 채워짐). 다음은 OE 문서 의 최상위 필드입니다. 여기에 매핑하면 API 게이트웨이가 구조체 비정렬화 중에 삭제하지 않고 UI 로 전달하도록 합니다.
  
  가드레일_이름 문자열
  
  guardrail_type 문자열
  
  id 문자열
  
  입력 객체
  
  추가 속성이 허용됩니다.
  
  kind 문자열
  
  종류는 "llm" LLM 호출의 경우 "tool" 일반 도구의 경우 "메모리&" 메모리 작업의 경우 "a2a" 에이전트 간 통화의 경우 "가드레일" 가드레일 결정 이벤트 및 "정책&" 플랫폼 정책 결정 이벤트의 경우.
  
  값은 llm, tool, memory, a2a, guardrail 또는 policy입니다.
  
  log_source 문자열
  
  LogSource는 이 로그 행을 기록한 플랫폼 구성 요소를 식별합니다( 예시: 플랫폼의 메모리 프록시에 의해 기록된 행의 경우 "memory_proxy"). 상담원 기반 통화에서 기록된 행의 경우 비어 있습니다.
  
  metadata 객체
  
  추가 속성이 허용됩니다.
  
  모델 문자열
  
  org_id 문자열
  
  pod_name 문자열
  
  도구가 실행된 호스트 이름/포드 이름
  
  PROJECT_ID 문자열
  
  prompt_tokens integer
  
  토큰 사용량 및 비용 필드(invoke_llm 호출에 대해 채워짐)
  
  root_execution_id 문자열
  
  root_session_id 문자열
  
  session_id 문자열
  
  span_id 문자열
  
  상태 문자열
  
  단계 결과 에는 "취소됨"이 포함됩니다. 호출자가 취소한 메모리 턴 쓰기의 경우.
  
  step_number integer
  
  StepNumber는 실행 내 단계를 식별합니다. 클라이언트 다른 곳에서 보고 있는 단계와 로그 행을 연결하는 것은 로그 행을 연결하는 것입니다. 여기서 생략하면 행이 여전히 도착하지만, 어느 단계에 속하는지 아무것도 알 수 없습니다.
  
  timestamp 문자열(날짜-시간)
  
  도구 문자열
  
  tool_api_error 객체
  
  tools_api_error 속성 숨기기 tools_api_error 속성 표시 객체
  
  분류 문자열
  
  error_code 문자열
  
  http_status integer
  
  provider_type 문자열
  
  이유 문자열
  
  재시도 가능 부울
  
  새 제공자 호출이 성공할 수 있는 경우 true(429/503/timeout/connect)입니다. 이 도구 호출을 재생하지 않아야 합니다.
  
  tool_call_id 문자열
  
  ToolCallID는 안정적인 LLM 도구 호출 ID입니다. 도구 호출의 시작/결과 실행 로그 레코드를 서로 및 세션 메시지에 결합합니다. invoke_llm 및 기타 비 도구 호출 이벤트의 경우 비어 있습니다.
  
  total_tokens integer
  
  trace_id 문자열
  
  Triggered_policy_ids array[string]
  
  user_id 문자열
  
  Workspace_id 문자열
- Next_cursor 문자열
  
  NextCursor는 다음 폴링을 위한 불투명 토큰 뒤입니다. OE가 위치를 전송하지 않은 경우(첫 페이지가 비어 있는 경우) 생략됩니다.
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 카운트 integer
- has_more 부울
- 로그 배열[객체]
  
  로그 속성 숨기기 로그 속성 표시 객체
  
  a2a_caller_workspace_id 문자열
  
  a2a_parent_execution_id 문자열
  
  a2a_target_agent_id 문자열
  
  a2a_target_agent_name 문자열
  
  Completion_tokens integer
  
  Cost_usd 숫자
  
  결정 문자열
  
  duration_ms 숫자
  
  오류 문자열
  
  execution_id 문자열
  
  가드레일_액션 문자열
  
  가드레일 결정 필드(LogGuardrailDecision에 의해 Kind='guardrail' 로그로 채워짐). 다음은 OE 문서 의 최상위 필드입니다. 여기에 매핑하면 API 게이트웨이가 구조체 비정렬화 중에 삭제하지 않고 UI 로 전달하도록 합니다.
  
  가드레일_이름 문자열
  
  guardrail_type 문자열
  
  id 문자열
  
  입력 객체
  
  추가 속성이 허용됩니다.
  
  kind 문자열
  
  종류는 "llm" LLM 호출의 경우 "tool" 일반 도구의 경우 "메모리&" 메모리 작업의 경우 "a2a" 에이전트 간 통화의 경우 "가드레일" 가드레일 결정 이벤트 및 "정책&" 플랫폼 정책 결정 이벤트의 경우.
  
  값은 llm, tool, memory, a2a, guardrail 또는 policy입니다.
  
  log_source 문자열
  
  LogSource는 이 로그 행을 기록한 플랫폼 구성 요소를 식별합니다( 예시: 플랫폼의 메모리 프록시에 의해 기록된 행의 경우 "memory_proxy"). 상담원 기반 통화에서 기록된 행의 경우 비어 있습니다.
  
  metadata 객체
  
  추가 속성이 허용됩니다.
  
  모델 문자열
  
  org_id 문자열
  
  pod_name 문자열
  
  도구가 실행된 호스트 이름/포드 이름
  
  PROJECT_ID 문자열
  
  prompt_tokens integer
  
  토큰 사용량 및 비용 필드(invoke_llm 호출에 대해 채워짐)
  
  root_execution_id 문자열
  
  root_session_id 문자열
  
  session_id 문자열
  
  span_id 문자열
  
  상태 문자열
  
  단계 결과 에는 "취소됨"이 포함됩니다. 호출자가 취소한 메모리 턴 쓰기의 경우.
  
  step_number integer
  
  StepNumber는 실행 내 단계를 식별합니다. 클라이언트 다른 곳에서 보고 있는 단계와 로그 행을 연결하는 것은 로그 행을 연결하는 것입니다. 여기서 생략하면 행이 여전히 도착하지만, 어느 단계에 속하는지 아무것도 알 수 없습니다.
  
  timestamp 문자열(날짜-시간)
  
  도구 문자열
  
  tool_api_error 객체
  
  tools_api_error 속성 숨기기 tools_api_error 속성 표시 객체
  
  분류 문자열
  
  error_code 문자열
  
  http_status integer
  
  provider_type 문자열
  
  이유 문자열
  
  재시도 가능 부울
  
  새 제공자 호출이 성공할 수 있는 경우 true(429/503/timeout/connect)입니다. 이 도구 호출을 재생하지 않아야 합니다.
  
  tool_call_id 문자열
  
  ToolCallID는 안정적인 LLM 도구 호출 ID입니다. 도구 호출의 시작/결과 실행 로그 레코드를 서로 및 세션 메시지에 결합합니다. invoke_llm 및 기타 비 도구 호출 이벤트의 경우 비어 있습니다.
  
  total_tokens integer
  
  trace_id 문자열
  
  Triggered_policy_ids array[string]
  
  user_id 문자열
  
  Workspace_id 문자열
- Next_cursor 문자열
  
  NextCursor는 다음 폴링을 위한 불투명 토큰 뒤입니다. OE가 위치를 전송하지 않은 경우(첫 페이지가 비어 있는 경우) 생략됩니다.
- Success 부울
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 부울
425

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

애플리케이션/vnd.agent-engine-2026-09-20-preview+json application/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}/execution-logs

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/execution-logs?session_id=string' \
 --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,
  "has_more": true,
  "logs": [
    {
      "a2a_caller_workspace_id": "string",
      "a2a_parent_execution_id": "string",
      "a2a_target_agent_id": "string",
      "a2a_target_agent_name": "string",
      "completion_tokens": 42,
      "cost_usd": 42.0,
      "decision": "string",
      "duration_ms": 42.0,
      "error": "string",
      "execution_id": "string",
      "guardrail_action": "string",
      "guardrail_name": "string",
      "guardrail_type": "string",
      "id": "string",
      "inputs": {},
      "kind": "llm",
      "log_source": "string",
      "metadata": {},
      "model": "string",
      "org_id": "string",
      "pod_name": "string",
      "project_id": "string",
      "prompt_tokens": 42,
      "root_execution_id": "string",
      "root_session_id": "string",
      "session_id": "string",
      "span_id": "string",
      "status": "string",
      "step_number": 42,
      "timestamp": "2026-05-04T09:42:00Z",
      "tool": "string",
      "tool_api_error": {
        "classification": "string",
        "error_code": "string",
        "http_status": 42,
        "provider_type": "string",
        "reason": "string",
        "retryable": true
      },
      "tool_call_id": "string",
      "total_tokens": 42,
      "trace_id": "string",
      "triggered_policy_ids": [
        "string"
      ],
      "user_id": "string",
      "workspace_id": "string"
    }
  ],
  "next_cursor": "string",
  "success": true
}

응답 예시(200)

{
  "count": 42,
  "has_more": true,
  "logs": [
    {
      "a2a_caller_workspace_id": "string",
      "a2a_parent_execution_id": "string",
      "a2a_target_agent_id": "string",
      "a2a_target_agent_name": "string",
      "completion_tokens": 42,
      "cost_usd": 42.0,
      "decision": "string",
      "duration_ms": 42.0,
      "error": "string",
      "execution_id": "string",
      "guardrail_action": "string",
      "guardrail_name": "string",
      "guardrail_type": "string",
      "id": "string",
      "inputs": {},
      "kind": "llm",
      "log_source": "string",
      "metadata": {},
      "model": "string",
      "org_id": "string",
      "pod_name": "string",
      "project_id": "string",
      "prompt_tokens": 42,
      "root_execution_id": "string",
      "root_session_id": "string",
      "session_id": "string",
      "span_id": "string",
      "status": "string",
      "step_number": 42,
      "timestamp": "2026-05-04T09:42:00Z",
      "tool": "string",
      "tool_api_error": {
        "classification": "string",
        "error_code": "string",
        "http_status": 42,
        "provider_type": "string",
        "reason": "string",
        "retryable": true
      },
      "tool_call_id": "string",
      "total_tokens": 42,
      "trace_id": "string",
      "triggered_policy_ids": [
        "string"
      ],
      "user_id": "string",
      "workspace_id": "string"
    }
  ],
  "next_cursor": "string",
  "success": 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
}

응답 예시(425)

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

응답 예시(425)

{
  "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
}