Obter registros de execução

OBTER /api/v1/projects/{id}/execution-logs
Autenticação do portador

Busca os registros de execução para uma sessão por meio do Mecanismo de orquestração do espaço de trabalho. O escopo do projeto é realizado pelo parâmetro route id path e a organização é derivada desse projeto.

parâmetros de caminho

  • id string Obrigatório

    ID do Projeto

parâmetros de query

  • session_id string Obrigatório

    ID da sessão

  • desde string

    Filtro de carimbo de data/hora RFC3339

  • after string

    Cursor opaco retornado como próximo_cursor pela resposta anterior

  • workspace_id string

    ID do workspace para a resolução do workspace

Respostas

  • 406

    Versão de API não permitida ou malformada, uma operação indisponível no contrato publicado selecionado ou uma representação inaceitável (incluindo parâmetros de tipo de mídia não suportados ou SSE excluído). Falhas existentes de autenticação, autorização e limite de taxa têm precedência.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes de validação opcionais definidos pelo esquema de erro padrão; Os erros de negociação da API não emitem este campo.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Campos com falhas de validação.

        Ocultar atributos de campos Mostrar atributos dos campos objeto

        Um campo e sua falha de validação.

        • Descrição string Obrigatório

          Falha na validação legível por humanos.

        • Campo string Obrigatório

          Nome ou caminho do campo de solicitação inválido .

    • detalhe string Obrigatório

      Detalhes de erro legíveis por humanos.

    • Erro inteiro Obrigatório

      HTTP status code.

    • Código de erro string Obrigatório

      Código de erro legível por máquina.

    • Parâmetros array[string]

      Solicitar nomes de parâmetros associados ao erro; omitido quando nenhum se aplica.

    • Razão string Obrigatório

      Frase de razão do status HTTP.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes de validação opcionais definidos pelo esquema de erro padrão; Os erros de negociação da API não emitem este campo.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Campos com falhas de validação.

        Ocultar atributos de campos Mostrar atributos dos campos objeto

        Um campo e sua falha de validação.

        • Descrição string Obrigatório

          Falha na validação legível por humanos.

        • Campo string Obrigatório

          Nome ou caminho do campo de solicitação inválido .

    • detalhe string Obrigatório

      Detalhes de erro legíveis por humanos.

    • Erro inteiro Obrigatório

      HTTP status code.

    • Código de erro string Obrigatório

      Código de erro legível por máquina.

    • Parâmetros array[string]

      Solicitar nomes de parâmetros associados ao erro; omitido quando nenhum se aplica.

    • Razão string Obrigatório

      Frase de razão do status HTTP.
  • 200

    OK

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • contar inteiro
    • has_more booleano
    • logs array[objeto]
      Ocultar atributos de registros Mostrar atributos de registros objeto
      • a2a_caller_workspace_id string
      • a2a_parent_execution_id string
      • a2a_target_agent_id string
      • a2a_target_agent_name string
      • completed_tokens inteiro
      • cost_usd número
      • decisão string
      • duration_ms número
      • Erro string
      • execution_id string
      • guardrail_action string

        Campos de decisão do guardrail (preenchidos para kind="guardrail" logs por LogGuardrailDecision). Esses são campos de nível superior no documento OE ; mapeá-los aqui garante que o API Gateway os passe para a UI em vez de descartá-los durante a desordenação da estrutura.

      • guardrail_name string
      • guardrail_type string
      • id string
      • entradas objeto

        Propriedades adicionais são permitidas.

      • kind string

        Kind é "llm" para chamadas LLM, "tool" para ferramentas comuns, "memória" para operações de memória, "a2a" para chamadas de agente para agente, "guardrail" para eventos de decisão de proteção e "política" para eventos de decisão de política de plataforma.

        Os valores são llm, tool, memory, a2a, guardrail ou policy.

      • log_source string

        LogSource identifica o componente de plataforma que registrou essa linha de registro (por exemplo, "memory_proxy" para linhas gravadas pelo proxy de memória da plataforma). Vazio para linhas registradas de chamadas orientadas por agente.

      • metadata objeto

        Propriedades adicionais são permitidas.

      • Modelo string
      • org_id string
      • pod_name string

        Nome do host/pod onde a ferramenta foi executada

      • PROJECT_ID string
      • prompt_tokens inteiro

        Campos de uso e custo do token (preenchidos para chamadas invoke_llm)

      • root_execution_id string
      • root_session_id string
      • session_id string
      • span_id string
      • Status string

        Resultado da etapa; inclui "cancelado" para escritas de mudança de memória canceladas pelo chamador.

      • step_number inteiro

        StepNumber identifica a etapa dentro de sua execução. É o que vincula uma linha de registro à etapa que um cliente está procurando em outro lugar – omita-a aqui e a linha ainda chegará, mas nada pode dizer a qual etapa ela pertence.

      • timestamp string(data-hora)
      • Ferramenta string
      • tool_api_error objeto
        Ocultar atributos tool_api_error Mostrar atributos tool_api_error objeto
        • classificação string
        • error_code string
        • http_status inteiro
        • provider_type string
        • Razão string
        • Repetitivo booleano

          Verdadeiro se uma nova chamada de fornecedor puder ser bem-sucedida (429/503/timeout/connect). Não deve reproduzir esta chamada de ferramenta.

      • tool_call_id string

        ToolCallID é o ID de chamada de ferramenta LLM estável. Une os registros de log de execução de início/resultado de uma chamada de ferramenta uns aos outros e à mensagem da sessão. Vazio para invoke_llm e outros eventos que não sejam de chamada de ferramenta.

      • total_tokens inteiro
      • rastreamento_id string
      • trigger_policy_ids array[string]
      • user_id string
      • workspace_id string
    • próximo_cursor string

      NextCursor é o token posterior opaco para a próxima enquete. Omitido quando o OE não enviou nenhuma posição (primeira página vazia).

    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • contar inteiro
    • has_more booleano
    • logs array[objeto]
      Ocultar atributos de registros Mostrar atributos de registros objeto
      • a2a_caller_workspace_id string
      • a2a_parent_execution_id string
      • a2a_target_agent_id string
      • a2a_target_agent_name string
      • completed_tokens inteiro
      • cost_usd número
      • decisão string
      • duration_ms número
      • Erro string
      • execution_id string
      • guardrail_action string

        Campos de decisão do guardrail (preenchidos para kind="guardrail" logs por LogGuardrailDecision). Esses são campos de nível superior no documento OE ; mapeá-los aqui garante que o API Gateway os passe para a UI em vez de descartá-los durante a desordenação da estrutura.

      • guardrail_name string
      • guardrail_type string
      • id string
      • entradas objeto

        Propriedades adicionais são permitidas.

      • kind string

        Kind é "llm" para chamadas LLM, "tool" para ferramentas comuns, "memória" para operações de memória, "a2a" para chamadas de agente para agente, "guardrail" para eventos de decisão de proteção e "política" para eventos de decisão de política de plataforma.

        Os valores são llm, tool, memory, a2a, guardrail ou policy.

      • log_source string

        LogSource identifica o componente de plataforma que registrou essa linha de registro (por exemplo, "memory_proxy" para linhas gravadas pelo proxy de memória da plataforma). Vazio para linhas registradas de chamadas orientadas por agente.

      • metadata objeto

        Propriedades adicionais são permitidas.

      • Modelo string
      • org_id string
      • pod_name string

        Nome do host/pod onde a ferramenta foi executada

      • PROJECT_ID string
      • prompt_tokens inteiro

        Campos de uso e custo do token (preenchidos para chamadas invoke_llm)

      • root_execution_id string
      • root_session_id string
      • session_id string
      • span_id string
      • Status string

        Resultado da etapa; inclui "cancelado" para escritas de mudança de memória canceladas pelo chamador.

      • step_number inteiro

        StepNumber identifica a etapa dentro de sua execução. É o que vincula uma linha de registro à etapa que um cliente está procurando em outro lugar – omita-a aqui e a linha ainda chegará, mas nada pode dizer a qual etapa ela pertence.

      • timestamp string(data-hora)
      • Ferramenta string
      • tool_api_error objeto
        Ocultar atributos tool_api_error Mostrar atributos tool_api_error objeto
        • classificação string
        • error_code string
        • http_status inteiro
        • provider_type string
        • Razão string
        • Repetitivo booleano

          Verdadeiro se uma nova chamada de fornecedor puder ser bem-sucedida (429/503/timeout/connect). Não deve reproduzir esta chamada de ferramenta.

      • tool_call_id string

        ToolCallID é o ID de chamada de ferramenta LLM estável. Une os registros de log de execução de início/resultado de uma chamada de ferramenta uns aos outros e à mensagem da sessão. Vazio para invoke_llm e outros eventos que não sejam de chamada de ferramenta.

      • total_tokens inteiro
      • rastreamento_id string
      • trigger_policy_ids array[string]
      • user_id string
      • workspace_id string
    • próximo_cursor string

      NextCursor é o token posterior opaco para a próxima enquete. Omitido quando o OE não enviou nenhuma posição (primeira página vazia).

    • Sucesso booleano
  • 400

    Solicitação inválida

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • 401

    Não autorizado

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • 425

    O mecanismo de orquestração do espaço de trabalho não está pronto

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • 500

    Erro interno do servidor

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • 502

    Gateway incorreto

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso 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"
Exemplos de resposta (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"
}
Exemplos de resposta (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"
}
Exemplos de resposta (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
}
Exemplos de resposta (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
}
Exemplos de resposta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (425) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (425) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}