> Source: https://clickhouse.github.io/loom/zh-CN/reference/operations/consolidations/ (Markdown: https://clickhouse.github.io/loom/zh-CN/reference/operations/consolidations.md)

<!-- i18n: source=docs/reference/operations/consolidations.md blob=027661a2cb67012c85af5b02448780b116559c01 model=claude-sonnet-5-5 -->
> 本页由机器从[英文原文](https://clickhouse.github.io/loom/reference/operations/consolidations/)翻译，内容以英文原文为准。
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/consolidations/), which is authoritative.

<a id="consolidations-operations"></a>

# `consolidations` 操作

每个 `consolidations.*` 操作接受和返回的确切字段。

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

每个操作都是 HTTP 上的 `POST /v1/<op>`，也是 MCP 工具 `loom_<op>`。当传输方式能够提供时，身份字段（`org`、`namespace`、`agent`、`user_id`、`session_id`）会根据令牌和 MCP 会话自动填充；对于单用户服务器上不带令牌的 HTTP 调用，除 `code.*` 和 `tracker.*`（它们保留各自平面的 org）之外，所有操作都使用该安装的 org，而[部分操作](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)还会使用其命名空间和 agent；参见[身份与命名空间](https://clickhouse.github.io/loom/zh-CN/concepts/identities-and-namespaces/)。[操作索引](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)说明了角色、种类以及 MCP `all` 列表。未知的输入字段会照常处理，并列在 `ignored_args` 中。

<!-- prettier-ignore-start -->

<a id="consolidationslist"></a>

## `consolidations.list`

按命名空间划分的整合运行历史。agent 和 user_id 是可选的，省略时会跨它们聚合运行记录。

`POST /v1/consolidations.list` · MCP `loom_consolidations_list` · 角色 `viewer` · 读取 · 未列在 MCP `all` 工具集中

| 输入字段 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| `org` | `str` | 必填 | 租户（身份元组的第一个元素）。 |
| `namespace` | `str` | 必填 | 该操作读取或写入的命名空间。 |
| `agent` | `str` | `'-'` | 写入或读取的 agent；`'-'` 或 `'*'` 表示在操作允许时匹配任意 agent。 |
| `user_id` | `str` | `'-'` | 该行所属的最终用户；`'-'` 表示无。 |
| `session_id` | `str` | `'-'` | 该行所属的会话或对话；`'-'` 表示无。 |
| `run_id` | `str` | `'-'` | 该调用所属的 agent 运行（任务范围）；`'-'` 表示无。 |
| `limit` | `int` | `50` | 最多返回这么多条运行记录，按时间从新到旧排列。 |

| 输出字段 | 类型 | 含义 |
| --- | --- | --- |
| `rows` | `list[ConsolidationRunRow]` | 该命名空间的整合运行记录，按时间从新到旧排列，每个被检查的聚类一条。 |

<!-- prettier-ignore-end -->
