Obter registros de tempo de execução do agente

OBTER /api/v1/projects/{id}/agent-logs

Recupere lotes de registros JSONL compactados e gravados pelo tempo de execução do agente no S3 para um 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

  • workspace_id string Obrigatório

    Identificador do espaço de trabalho

  • start_time string

    Hora de início da RFC3339 (padrão: 1 hora atrás; o intervalo não deve exceder 6 horas)

  • end_time string

    Hora de término da RFC3339 (padrão: agora; a faixa não deve exceder 6 horas)

  • limit inteiro

    Máximo de entradas (padrão 500, máximo de 5000)

  • cursor string

    Cursor de paginação opaco de uma resposta anterior

  • level string

    Níveis de registro para corresponder exatamente, separados por vírgula ou espaço (DEBUG, INFO, AVISO, ERRO; nomes alternativos de aviso/erro também aceitos). Alteração significativa do filtro anterior de gravidade mínima: nível=INFO agora retorna apenas INFO, não INFO+WARNING+ERROR.

  • execution_id string

    Filtrar por ID de execução (correspondência exata)

  • session_id string

    Filtrar por ID da sessão (correspondência exata)

  • Fonte string

    Origem(s) para corresponder exatamente, separadas por vírgula ou espaço (stdout, stderr, python-logging, node-logging)

  • serviço string

    Serviço(s) para corresponder exatamente, separado por vírgula ou espaço (agente-execution-runtime, ferramenta-executor; aliases de agente/tool também são aceitos)

  • order string

    Ordem de classificação: asc (padrão, mais antigo primeiro) ou desc (mais novo primeiro)

  • cauda booleano

    Retornar apenas as entradas mais recentes como uma única página (mutuamente exclusivo com o cursor)

Respostas

  • 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
    • hasMore booleano
    • logs array[objeto]
      Ocultar atributos de registros Mostrar atributos de registros objeto
      • inicializaçãoId string
      • executionId string
      • Campos objeto

        Propriedades adicionais são permitidas.

      • level string
      • logger string
      • mensagem string
      • podName string
      • serviço string
      • sessionId string
      • Fonte string
      • ID do Inquilino string
      • timestamp string
      • rastreamentoId string
      • workspaceId string
    • próximoCursor string
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • hasMore booleano
    • logs array[objeto]
      Ocultar atributos de registros Mostrar atributos de registros objeto
      • inicializaçãoId string
      • executionId string
      • Campos objeto

        Propriedades adicionais são permitidas.

      • level string
      • logger string
      • mensagem string
      • podName string
      • serviço string
      • sessionId string
      • Fonte string
      • ID do Inquilino string
      • timestamp string
      • rastreamentoId string
      • workspaceId string
    • próximoCursor string
  • 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
  • Proibido

    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
  • Não encontrado

    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
  • 429

    Muitas solicitações

    Ocultar atributo de cabeçalhos Mostrar atributo de cabeçalhos
    • Tentar novamente depois string

      Segundos antes de tentar novamente

    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
  • 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
  • 503

    Serviço indisponível

    Ocultar atributo de cabeçalhos Mostrar atributo de cabeçalhos
    • Tentar novamente depois string

      Segundos antes de tentar novamente

    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}/agent-logs
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/agent-logs?workspace_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)
{
  "hasMore": true,
  "logs": [
    {
      "bootId": "string",
      "executionId": "string",
      "fields": {},
      "level": "string",
      "logger": "string",
      "message": "string",
      "podName": "string",
      "service": "string",
      "sessionId": "string",
      "source": "string",
      "tenantId": "string",
      "timestamp": "string",
      "traceId": "string",
      "workspaceId": "string"
    }
  ],
  "nextCursor": "string"
}
Exemplos de resposta (200)
{
  "hasMore": true,
  "logs": [
    {
      "bootId": "string",
      "executionId": "string",
      "fields": {},
      "level": "string",
      "logger": "string",
      "message": "string",
      "podName": "string",
      "service": "string",
      "sessionId": "string",
      "source": "string",
      "tenantId": "string",
      "timestamp": "string",
      "traceId": "string",
      "workspaceId": "string"
    }
  ],
  "nextCursor": "string"
}
Exemplos de resposta (400)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (400)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (403)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (403)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (404)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (404)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (429)
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (429)
# Headers
Retry-After: string

# Payload
{
  "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 (503)
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (503)
# Headers
Retry-After: string

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