获取会话的运行次数

获取 /api/v1/projects/{id}/sessions/{session_id}/runs
持有者身份验证

按最旧在前的顺序返回会话的运行，每个运行都有按顺序排列的步骤。步骤包含其种类、运行内的起始偏移量、持续时间、令牌计数、状态和步骤编号。

路径参数

  • id 字符串 必需

    项目 ID

  • session_id 字符串 必需

    会话id

查询参数

  • Workspace_id 字符串

    用于工作区解析的工作区ID

响应

  • 406

    不支持或格式不正确的API版本、所选已发布合约中不可用的操作或不可接受的表示形式（包括不支持的媒体类型参数或排除的 SSE）。现有的身份验证、授权和速率限制失败优先。

    隐藏响应属性 显示响应属性 对象
    • badRequestDetail 对象

      标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。

      隐藏 BadRequestDetail 属性 显示 BadRequestDetail 属性 对象
      • 字段 大量[对象]

        验证失败的字段。

        隐藏字段属性 显示字段属性 对象

        字段及其验证失败。

        • 描述 字符串 必需

          人类可读的验证失败。

        • 字段 字符串 必需

          无效请求字段的名称或路径。

    • 详细信息 字符串 必需

      人类可读的错误详细信息。

    • 错误 整型 必需

      HTTP status code.

    • 错误代码 字符串 必需

      机器可读的错误代码。

    • 参数 array[string]

      与错误相关的请求参数名称；不应用时省略。

    • 原因 字符串 必需

      HTTP状态原因短语。

    隐藏响应属性 显示响应属性 对象
    • badRequestDetail 对象

      标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。

      隐藏 BadRequestDetail 属性 显示 BadRequestDetail 属性 对象
      • 字段 大量[对象]

        验证失败的字段。

        隐藏字段属性 显示字段属性 对象

        字段及其验证失败。

        • 描述 字符串 必需

          人类可读的验证失败。

        • 字段 字符串 必需

          无效请求字段的名称或路径。

    • 详细信息 字符串 必需

      人类可读的错误详细信息。

    • 错误 整型 必需

      HTTP status code.

    • 错误代码 字符串 必需

      机器可读的错误代码。

    • 参数 array[string]

      与错误相关的请求参数名称；不应用时省略。

    • 原因 字符串 必需

      HTTP状态原因短语。
  • 200

    正常

    隐藏响应属性 显示响应属性 对象
    • 数数 整型
    • 运行 大量[对象]
      隐藏运行属性 显示运行属性 对象
      • active_duration_ms 整型
      • completion_tokens 整型
      • duration_ms 整型

        DurationMS 是从运行开始到最后一次更新的挂钟时间。

      • 错误 字符串
      • error_code 字符串
      • execution_id 字符串
      • invoker_user_id 字符串
      • memory_recalls 整型

        MemoryRecalls 和 MemorySaves 计算稳定的内存步骤，即截断读取的下限。

      • memory_saves 整型
      • prompt_tokens 整型

        PromptTokens 和 CompletionTokens分割了TotalTokens。当运行没有固定的 llm 步骤时，两者都不存在。

      • run_number 整型

        RunNumber 是运行在会话中基于 1 的位置，从早到晚。当 truncated 为 true 时，它是相对于返回的窗口：最早的运行是在上限处删除的运行，因此运行1 不是会话的第一个。

      • session_id 字符串
      • slowest_step 对象

        当运行没有稳定步骤时，SlowestStep 不存在。

        隐藏 slowest_step 属性 显示slowest_step 属性 对象
        • duration_ms 数字
        • kind 字符串
        • 名称 字符串
        • 步骤编号 整型
      • started_at 字符串
      • startup_failure 对象
        隐藏 startup_failure 属性 显示 startup_failure 属性 对象
        • boot_id 字符串
        • 代码 字符串
        • 组件 字符串
        • 相 字符串
        • 来源 字符串
      • 状态 字符串
      • 步骤 大量[对象]
        隐藏步骤属性 显示步骤属性 对象
        • completion_tokens 整型
        • duration_ms 数字

          对于尚未解决的步骤，缺少 DurationMS。

        • 错误 字符串
        • kind 字符串

          Kind 是步骤的类别：llm、tool、memory、guardrail、policy、a2a 或agent_step。

        • memory_op 字符串

          MemoryOp 是“recall”（召回）操作的意思。或“保存”在固定的内存步骤上，否则不存在。

        • 名称 字符串
        • 提交 字符串
        • presented_truncated 布尔
        • prompt_tokens 整型

          PromptTokens 和 CompletionTokens分割了TotalTokens，两者都只出现在已结算的 llm 步骤上。

        • review_outcome 字符串

          ReviewOutcome、WaitMS 和 ReviewTrigger 仅出现在 human_review 步骤上：等待的状态（“待处理”、“已批准”/“已拒绝”）、其稳定长度（以毫秒为单位）（在待处理时不存在）以及路由致电进行查看。

        • review_trigger 字符串
        • 评论家 字符串

          Reviewer/ReviewerNotes/Prepresented 镜像 OE查看记录：决策者、他们的注释以及他们审核内容的简短摘要。

        • reviewer_notes 字符串
        • run_id 字符串

          RunID 是图表节点调用的标识符，仅出现在agent_step 上。它是将节点步骤与其 node_executions 行关联的唯一键。

        • span_id 字符串

          SpanID 将此步骤加入 spans集合中的完整跟踪详细信息。

        • start_offset_ms 整型

          StartOffsetMS 是从运行开始到此步骤开始的毫秒数。

        • started_at 字符串
        • 状态 字符串
        • 步骤编号 整型

          StepNumber 是中断端点的目标值。 Agent_step 缺失，记录图表结构，并且没有可中断的步骤。

        • tool_call_id 字符串
        • total_tokens 整型

          TotalTokens 仅出现在已结算的 llm 步骤中。

        • wait_ms 整型
      • 总结 字符串

        摘要是运行的调用消息，在服务器端被截断。

      • time_to_first_event_ms 整型

        TimeToFirstEventMS 是第一步的偏移量，当运行还没有步骤时不存在。

      • total_tokens 整型

        TotalTokens 汇总了运行的已结算 llm 步骤，因此它是运行实际花费的下限。

      • user_id 字符串

        UserID 和 InvokerUserID 镜像了运行的执行身份：委托的目标是运行的运行身份以及启动运行的经过网关身份验证的调用者。其中一个可能不存在 — 请参阅 OE 的 SessionRun。二者均会从安全支持视图中省略。

      • wait_ms 整型

        WaitMS 是运行的已解决人工审核等待，当运行从未暂停时不存在。 ActiveDurationMS 排除该等待；两者都没有出现在更早出现的编排引擎中。

      • Workspace_id 字符串
    • truncated 布尔

      Truncated 报告该会话的行数超过 OE 在一次读取中返回的行数，因此这是部分视图。反映自 OE 响应。

    隐藏响应属性 显示响应属性 对象
    • 数数 整型
    • 运行 大量[对象]
      隐藏运行属性 显示运行属性 对象
      • active_duration_ms 整型
      • completion_tokens 整型
      • duration_ms 整型

        DurationMS 是从运行开始到最后一次更新的挂钟时间。

      • 错误 字符串
      • error_code 字符串
      • execution_id 字符串
      • invoker_user_id 字符串
      • memory_recalls 整型

        MemoryRecalls 和 MemorySaves 计算稳定的内存步骤，即截断读取的下限。

      • memory_saves 整型
      • prompt_tokens 整型

        PromptTokens 和 CompletionTokens分割了TotalTokens。当运行没有固定的 llm 步骤时，两者都不存在。

      • run_number 整型

        RunNumber 是运行在会话中基于 1 的位置，从早到晚。当 truncated 为 true 时，它是相对于返回的窗口：最早的运行是在上限处删除的运行，因此运行1 不是会话的第一个。

      • session_id 字符串
      • slowest_step 对象

        当运行没有稳定步骤时，SlowestStep 不存在。

        隐藏 slowest_step 属性 显示slowest_step 属性 对象
        • duration_ms 数字
        • kind 字符串
        • 名称 字符串
        • 步骤编号 整型
      • started_at 字符串
      • startup_failure 对象
        隐藏 startup_failure 属性 显示 startup_failure 属性 对象
        • boot_id 字符串
        • 代码 字符串
        • 组件 字符串
        • 相 字符串
        • 来源 字符串
      • 状态 字符串
      • 步骤 大量[对象]
        隐藏步骤属性 显示步骤属性 对象
        • completion_tokens 整型
        • duration_ms 数字

          对于尚未解决的步骤，缺少 DurationMS。

        • 错误 字符串
        • kind 字符串

          Kind 是步骤的类别：llm、tool、memory、guardrail、policy、a2a 或agent_step。

        • memory_op 字符串

          MemoryOp 是“recall”（召回）操作的意思。或“保存”在固定的内存步骤上，否则不存在。

        • 名称 字符串
        • 提交 字符串
        • presented_truncated 布尔
        • prompt_tokens 整型

          PromptTokens 和 CompletionTokens分割了TotalTokens，两者都只出现在已结算的 llm 步骤上。

        • review_outcome 字符串

          ReviewOutcome、WaitMS 和 ReviewTrigger 仅出现在 human_review 步骤上：等待的状态（“待处理”、“已批准”/“已拒绝”）、其稳定长度（以毫秒为单位）（在待处理时不存在）以及路由致电进行查看。

        • review_trigger 字符串
        • 评论家 字符串

          Reviewer/ReviewerNotes/Prepresented 镜像 OE查看记录：决策者、他们的注释以及他们审核内容的简短摘要。

        • reviewer_notes 字符串
        • run_id 字符串

          RunID 是图表节点调用的标识符，仅出现在agent_step 上。它是将节点步骤与其 node_executions 行关联的唯一键。

        • span_id 字符串

          SpanID 将此步骤加入 spans集合中的完整跟踪详细信息。

        • start_offset_ms 整型

          StartOffsetMS 是从运行开始到此步骤开始的毫秒数。

        • started_at 字符串
        • 状态 字符串
        • 步骤编号 整型

          StepNumber 是中断端点的目标值。 Agent_step 缺失，记录图表结构，并且没有可中断的步骤。

        • tool_call_id 字符串
        • total_tokens 整型

          TotalTokens 仅出现在已结算的 llm 步骤中。

        • wait_ms 整型
      • 总结 字符串

        摘要是运行的调用消息，在服务器端被截断。

      • time_to_first_event_ms 整型

        TimeToFirstEventMS 是第一步的偏移量，当运行还没有步骤时不存在。

      • total_tokens 整型

        TotalTokens 汇总了运行的已结算 llm 步骤，因此它是运行实际花费的下限。

      • user_id 字符串

        UserID 和 InvokerUserID 镜像了运行的执行身份：委托的目标是运行的运行身份以及启动运行的经过网关身份验证的调用者。其中一个可能不存在 — 请参阅 OE 的 SessionRun。二者均会从安全支持视图中省略。

      • wait_ms 整型

        WaitMS 是运行的已解决人工审核等待，当运行从未暂停时不存在。 ActiveDurationMS 排除该等待；两者都没有出现在更早出现的编排引擎中。

      • Workspace_id 字符串
    • truncated 布尔

      Truncated 报告该会话的行数超过 OE 在一次读取中返回的行数，因此这是部分视图。反映自 OE 响应。
  • 400

    Bad Request

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 401

    Unauthorized

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 500

    内部服务器错误

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 502

    错误网关

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
GET /api/v1/projects/{id}/sessions/{session_id}/runs 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/sessions/{session_id}/runs' \
 --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,
  "runs": [
    {
      "active_duration_ms": 42,
      "completion_tokens": 42,
      "duration_ms": 42,
      "error": "string",
      "error_code": "string",
      "execution_id": "string",
      "invoker_user_id": "string",
      "memory_recalls": 42,
      "memory_saves": 42,
      "prompt_tokens": 42,
      "run_number": 42,
      "session_id": "string",
      "slowest_step": {
        "duration_ms": 42.0,
        "kind": "string",
        "name": "string",
        "step_number": 42
      },
      "started_at": "string",
      "startup_failure": {
        "boot_id": "string",
        "code": "string",
        "component": "string",
        "phase": "string",
        "source": "string"
      },
      "status": "string",
      "steps": [
        {
          "completion_tokens": 42,
          "duration_ms": 42.0,
          "error": "string",
          "kind": "string",
          "memory_op": "string",
          "name": "string",
          "presented": "string",
          "presented_truncated": true,
          "prompt_tokens": 42,
          "review_outcome": "string",
          "review_trigger": "string",
          "reviewer": "string",
          "reviewer_notes": "string",
          "run_id": "string",
          "span_id": "string",
          "start_offset_ms": 42,
          "started_at": "string",
          "status": "string",
          "step_number": 42,
          "tool_call_id": "string",
          "total_tokens": 42,
          "wait_ms": 42
        }
      ],
      "summary": "string",
      "time_to_first_event_ms": 42,
      "total_tokens": 42,
      "user_id": "string",
      "wait_ms": 42,
      "workspace_id": "string"
    }
  ],
  "truncated": true
}
响应示例 (200) 
{
  "count": 42,
  "runs": [
    {
      "active_duration_ms": 42,
      "completion_tokens": 42,
      "duration_ms": 42,
      "error": "string",
      "error_code": "string",
      "execution_id": "string",
      "invoker_user_id": "string",
      "memory_recalls": 42,
      "memory_saves": 42,
      "prompt_tokens": 42,
      "run_number": 42,
      "session_id": "string",
      "slowest_step": {
        "duration_ms": 42.0,
        "kind": "string",
        "name": "string",
        "step_number": 42
      },
      "started_at": "string",
      "startup_failure": {
        "boot_id": "string",
        "code": "string",
        "component": "string",
        "phase": "string",
        "source": "string"
      },
      "status": "string",
      "steps": [
        {
          "completion_tokens": 42,
          "duration_ms": 42.0,
          "error": "string",
          "kind": "string",
          "memory_op": "string",
          "name": "string",
          "presented": "string",
          "presented_truncated": true,
          "prompt_tokens": 42,
          "review_outcome": "string",
          "review_trigger": "string",
          "reviewer": "string",
          "reviewer_notes": "string",
          "run_id": "string",
          "span_id": "string",
          "start_offset_ms": 42,
          "started_at": "string",
          "status": "string",
          "step_number": 42,
          "tool_call_id": "string",
          "total_tokens": 42,
          "wait_ms": 42
        }
      ],
      "summary": "string",
      "time_to_first_event_ms": 42,
      "total_tokens": 42,
      "user_id": "string",
      "wait_ms": 42,
      "workspace_id": "string"
    }
  ],
  "truncated": 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
}
响应示例 (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
}