エージェントの実行ログの取得

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

Bearer 認証

ワークスペースのエージェントランタイムによって S3 に書込まれた gzip JSONログバッチを取得します。プロジェクトスコープはルート ID パスパラメーターによって保持され、組織はそのプロジェクトから派生します。

path パラメータ

id string 必須

プロジェクトID

クエリパラメータ

Workspace_id string 必須

ワークスペース識別子
start_time string

RFC3339 の開始時間（デフォルト: 1 時間前。範囲は 6 時間以下である必要があります）
end_time string

RFC3339 終了時間（デフォルト: ようになりました）。範囲は 6 時間を超えない必要があります）
limit integer

最大エントリ（デフォルトでは500、最大 5000）
cursor string

以前の応答からの不可分ページネーションカーソル
レベル string

完全に一致するログレベル、カンマ、またはスペースで区切られたログレベル（DEBUG、INFO、WARNING、ERROR、警告/エラーエイリアスも利用可能）。以前の最小重大度フィルターからの重大な変更:level=INFO は、INFO+WARNING+ERROR ではなく INFO のみを返すようになりました。
execution_id string

実行IDでフィルタリング（完全一致）
Session_id string

セッションIDでフィルタリング（完全一致）
ソース string

完全に一致するソース、カンマ、またはスペースで区切られたソース（stdout、stserr、Python ログ、ノードログ）
service string

完全にカンマするサービス、またはスペースで区切られたもの（エージェント実行ランタイム、ツール実行プログラム、エージェント/ ツールエイリアスも利用可能）
検索 string

メッセージまたは起動IDでの大文字と小文字を区別しない部分文字列の一致
ordered string

ソート順: asc（デフォルト、最も古い順）またはdesc（新しい順）
追尾ブール値

最新のエントリのみを単一ページとして返します（カーソルと相互に排他的）

応答

406

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

サポートされていないAPIバージョンまたは不正な API バージョン、選択した公開契約で利用できない操作、または受け入れができない表現（サポートされていないメディアタイプのパラメーター、または除外された SSE を含む）。既存の認証、認可、およびレート制限の失敗が優先されます。
応答属性の非表示応答属性の表示オブジェクト
- validRequestDetail オブジェクト
  
  標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエートエラーでは、このフィールドは出力されません。
  
  validRequestDetail 属性を非表示にする validRequestDetail 属性の表示オブジェクト
  
  フィールド array[オブジェクト]
  
  検証に失敗したフィールド。
  
  フィールド属性を非表示にするフィールド属性の表示オブジェクト
  
  フィールドとその検証の失敗。
  
  説明 string 必須
  
  人間が判読できる検証の失敗。
  
  フィールド string 必須
  
  無効なリクエストフィールドの名前またはパス。
- 詳細 string 必須
  
  人間が判読できるエラーの詳細。
- エラー integer 必須
  
  HTTP status code.
- errorCode string 必須
  
  マシンが判読できるエラーコード。
- パラメーター array[string]
  
  エラーに関連付けられたリクエストパラメータ名。該当しない場合は省略します。
- 理由 string 必須
  
  HTTPステータス理由フレーズ。
応答属性の非表示応答属性の表示オブジェクト
- validRequestDetail オブジェクト
  
  標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエートエラーでは、このフィールドは出力されません。
  
  validRequestDetail 属性を非表示にする validRequestDetail 属性の表示オブジェクト
  
  フィールド array[オブジェクト]
  
  検証に失敗したフィールド。
  
  フィールド属性を非表示にするフィールド属性の表示オブジェクト
  
  フィールドとその検証の失敗。
  
  説明 string 必須
  
  人間が判読できる検証の失敗。
  
  フィールド string 必須
  
  無効なリクエストフィールドの名前またはパス。
- 詳細 string 必須
  
  人間が判読できるエラーの詳細。
- エラー integer 必須
  
  HTTP status code.
- errorCode string 必須
  
  マシンが判読できるエラーコード。
- パラメーター array[string]
  
  エラーに関連付けられたリクエストパラメータ名。該当しない場合は省略します。
- 理由 string 必須
  
  HTTPステータス理由フレーズ。
200

アプリケーション/vnd.agent- engine-2026-09-20-preview+json

アプリケーション/vnd.agent- engine-2026-09-20-preview+json application/ JSON

OK
応答属性の非表示応答属性の表示オブジェクト
- hasMore ブール値
- ログ array[オブジェクト]
  
  ログ属性の非表示ログ属性の表示オブジェクト
  
  bootId string
  
  executionId string
  
  フィールドオブジェクト
  
  追加のプロパティが許可されます。
  
  レベル string
  
  logger string
  
  メッセージ string
  
  podName string
  
  service string
  
  sessionId string
  
  ソース string
  
  tenantId string
  
  タイムスタンプ string
  
  trackId string
  
  WorkspaceId string
- nextCursor string
応答属性の非表示応答属性の表示オブジェクト
- hasMore ブール値
- ログ array[オブジェクト]
  
  ログ属性の非表示ログ属性の表示オブジェクト
  
  bootId string
  
  executionId string
  
  フィールドオブジェクト
  
  追加のプロパティが許可されます。
  
  レベル string
  
  logger string
  
  メッセージ string
  
  podName string
  
  service string
  
  sessionId string
  
  ソース string
  
  tenantId string
  
  タイムスタンプ string
  
  trackId string
  
  WorkspaceId string
- nextCursor string
400

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

無効なリクエスト
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
403

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

Forbidden
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
404

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

見つかりません
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
429

アプリケーション/vnd.agent- engine-2026-09-20-preview+json

アプリケーション/vnd.agent- engine-2026-09-20-preview+json application/ JSON

リクエストが多すぎる
ヘッダー属性を非表示ヘッダー属性を表示
- 再試行後 string
  
  再試行するまでの秒数
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
500

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

内部サーバーエラー
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
503

アプリケーション/vnd.agent- engine-2026-09-20-preview+json

アプリケーション/vnd.agent- engine-2026-09-20-preview+json application/ JSON

サービスは利用できません
ヘッダー属性を非表示ヘッダー属性を表示
- 再試行後 string
  
  再試行するまでの秒数
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値

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"

応答の例（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）

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

応答の例（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"
}

応答の例（400）

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

応答の例（400）

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

応答の例（403）

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

応答の例（403）

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

応答の例（404）

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

応答の例（404）

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

応答の例（429）

# Headers
Retry-After: string

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

応答の例（429）

# Headers
Retry-After: string

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

応答の例（500）

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

応答の例（500）

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

応答の例（503）

# Headers
Retry-After: string

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

応答の例（503）

# Headers
Retry-After: string

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

エージェントの実行ログの取得

path パラメータ

クエリ パラメータ

応答

クエリパラメータ