Obtener registros de ejecución

OBTENER /api/v1/projects/{id}/execution-logs
Autorización del portador

Obtiene los registros de ejecución de una sesión a través del motor de orquestación del espacio de trabajo. El ámbito del proyecto se define mediante el parámetro de ruta ID, y la organización se deriva de dicho proyecto.

Parámetros de path

  • ID string Requerido

    ID del proyecto

Parámetros de query

  • session_id string Requerido

    ID de sesión

  • ya que string

    Filtro de marca de tiempo RFC3339

  • después string

    Cursor opaco devuelto como next_cursor por la respuesta anterior.

  • ID del espacio de trabajo string

    ID de espacio de trabajo para la resolución del espacio de trabajo

Respuestas

  • 406

    Versión de API no compatible o con formato incorrecto, operación no disponible en el contrato publicado seleccionado o representación inaceptable (incluidos parámetros de tipo de medio no compatibles o SSE excluidos). Los fallos de autenticación, autorización y límite de velocidad existentes tienen prioridad.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.
  • 200

    OK

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • count entero
    • tiene_más booleano
    • Registros arreglo[objeto]
      Ocultar atributos de registro Mostrar atributos de registro Objeto
      • a2a_caller_workspace_id string
      • a2a_parent_execution_id string
      • a2a_target_agent_id string
      • a2a_nombre_del_agente_objetivo string
      • tokens de finalización entero
      • costo_USD Número
      • decisión string
      • duración_ms Número
      • Error string
      • id_de_ejecución string
      • acción de barandilla string

        Campos de decisión de la barrera de seguridad (rellenados para los registros de tipo "guardrail" por LogGuardrailDecision). Estos son campos de nivel superior en el documento OE; asignarlos aquí garantiza que la puerta de enlace de API los pase a la interfaz de usuario en lugar de descartarlos durante la deserialización de la estructura.

      • nombre_de_la_barandilla string
      • tipo de barandilla string
      • ID string
      • entradas Objeto

        Se permiten propiedades adicionales.

      • kind string

        Kind es "llm" para llamadas LLM, "tool" para herramientas ordinarias, "memory" para operaciones de memoria, "a2a" para llamadas de agente a agente, "guardrail" para eventos de decisión de guardrail y "policy" para eventos de decisión de política de plataforma.

        Los valores son llm, tool, memory, a2a, guardrail o policy.

      • origen del registro string

        LogSource identifica el componente de la plataforma que registró esta fila de registro (por ejemplo, "memory_proxy" para las filas escritas por el proxy de memoria de la plataforma). Vacío para las filas registradas a partir de llamadas controladas por el agente.

      • metadata Objeto

        Se permiten propiedades adicionales.

      • Modelo string
      • org_id string
      • pod_name string

        Nombre de host/nombre de pod donde se ejecutó la herramienta

      • project_id string
      • prompt_tokens entero

        Campos de uso y coste del token (que se rellenan para las llamadas a invoke_llm)

      • id_de_ejecución_raíz string
      • root_session_id string
      • session_id string
      • span_id string
      • Estado string

        Resultado del paso; incluye "cancelado" para escrituras de turnos de memoria cancelados por el llamador.

      • número_de_paso entero

        StepNumber identifica el paso dentro de su ejecución. Es lo que vincula una fila del registro con el paso que un cliente está consultando en otro lugar; si se omite aquí, la fila llegará igualmente, pero no se podrá determinar a qué paso pertenece.

      • Marca de tiempo string(date-time)
      • Herramienta string
      • error_de_api_de_herramienta Objeto
        Ocultar atributos tool_api_error Mostrar atributos tool_api_error Objeto
        • clasificación string
        • error_code string
        • http_status entero
        • provider_type string
        • motivo string
        • reintentable booleano

          Verdadero si una nueva llamada al proveedor puede tener éxito (429/503/timeout/connect). No se debe repetir esta llamada a la herramienta.

      • ID de llamada de herramienta string

        ToolCallID es el identificador estable de la llamada a la herramienta LLM. Vincula los registros de inicio y resultado de la ejecución de una llamada a la herramienta entre sí y con el mensaje de sesión. Está vacío para invoke_llm y otros eventos que no son llamadas a herramientas.

      • total_tokens entero
      • id_de_rastreo string
      • ids_de_política_activados array[string]
      • user_id string
      • ID del espacio de trabajo string
    • siguiente_cursor string

      NextCursor es el token opaco posterior para la siguiente encuesta. Se omite cuando OE no envía ninguna posición (primera página vacía).

    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • count entero
    • tiene_más booleano
    • Registros arreglo[objeto]
      Ocultar atributos de registro Mostrar atributos de registro Objeto
      • a2a_caller_workspace_id string
      • a2a_parent_execution_id string
      • a2a_target_agent_id string
      • a2a_nombre_del_agente_objetivo string
      • tokens de finalización entero
      • costo_USD Número
      • decisión string
      • duración_ms Número
      • Error string
      • id_de_ejecución string
      • acción de barandilla string

        Campos de decisión de la barrera de seguridad (rellenados para los registros de tipo "guardrail" por LogGuardrailDecision). Estos son campos de nivel superior en el documento OE; asignarlos aquí garantiza que la puerta de enlace de API los pase a la interfaz de usuario en lugar de descartarlos durante la deserialización de la estructura.

      • nombre_de_la_barandilla string
      • tipo de barandilla string
      • ID string
      • entradas Objeto

        Se permiten propiedades adicionales.

      • kind string

        Kind es "llm" para llamadas LLM, "tool" para herramientas ordinarias, "memory" para operaciones de memoria, "a2a" para llamadas de agente a agente, "guardrail" para eventos de decisión de guardrail y "policy" para eventos de decisión de política de plataforma.

        Los valores son llm, tool, memory, a2a, guardrail o policy.

      • origen del registro string

        LogSource identifica el componente de la plataforma que registró esta fila de registro (por ejemplo, "memory_proxy" para las filas escritas por el proxy de memoria de la plataforma). Vacío para las filas registradas a partir de llamadas controladas por el agente.

      • metadata Objeto

        Se permiten propiedades adicionales.

      • Modelo string
      • org_id string
      • pod_name string

        Nombre de host/nombre de pod donde se ejecutó la herramienta

      • project_id string
      • prompt_tokens entero

        Campos de uso y coste del token (que se rellenan para las llamadas a invoke_llm)

      • id_de_ejecución_raíz string
      • root_session_id string
      • session_id string
      • span_id string
      • Estado string

        Resultado del paso; incluye "cancelado" para escrituras de turnos de memoria cancelados por el llamador.

      • número_de_paso entero

        StepNumber identifica el paso dentro de su ejecución. Es lo que vincula una fila del registro con el paso que un cliente está consultando en otro lugar; si se omite aquí, la fila llegará igualmente, pero no se podrá determinar a qué paso pertenece.

      • Marca de tiempo string(date-time)
      • Herramienta string
      • error_de_api_de_herramienta Objeto
        Ocultar atributos tool_api_error Mostrar atributos tool_api_error Objeto
        • clasificación string
        • error_code string
        • http_status entero
        • provider_type string
        • motivo string
        • reintentable booleano

          Verdadero si una nueva llamada al proveedor puede tener éxito (429/503/timeout/connect). No se debe repetir esta llamada a la herramienta.

      • ID de llamada de herramienta string

        ToolCallID es el identificador estable de la llamada a la herramienta LLM. Vincula los registros de inicio y resultado de la ejecución de una llamada a la herramienta entre sí y con el mensaje de sesión. Está vacío para invoke_llm y otros eventos que no son llamadas a herramientas.

      • total_tokens entero
      • id_de_rastreo string
      • ids_de_política_activados array[string]
      • user_id string
      • ID del espacio de trabajo string
    • siguiente_cursor string

      NextCursor es el token opaco posterior para la siguiente encuesta. Se omite cuando OE no envía ninguna posición (primera página vacía).

    • éxito booleano
  • 400

    Solicitud incorrecta

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 401

    No autorizado

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 425

    El motor de orquestación del espacio de trabajo no está listo.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 500

    Error interno del servidor

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 502

    Puerta de enlace incorrecta

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
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"
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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
}
Ejemplos de respuesta (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
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (425) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (425) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}