> Source: https://clickhouse.github.io/loom/ko/reference/operations/consolidations/ (Markdown: https://clickhouse.github.io/loom/ko/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. -->

모든 op는 HTTP의 `POST /v1/<op>`이자 MCP 도구 `loom_<op>`입니다. 신원 필드(`org`, `namespace`, `agent`, `user_id`, `session_id`)는 전송 방식이 지원하면 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP를 호출하면, `code.*`와 `tracker.*`를 제외한 모든 op에서는 설치의 org가 사용되고(이 둘은 각자의 플레인 값을 유지합니다), [일부 op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 [신원과 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)를 참고하세요. [연산 색인](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)은 role, kind, MCP `all` 목록을 설명합니다. 알 수 없는 입력 필드는 그대로 처리되며 `ignored_args`에 이름이 표시됩니다.

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

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

## `consolidations.list`

네임스페이스 범위의 통합 실행 기록입니다. agent와 user_id는 선택 사항이며, 생략하면 이들을 가로질러 실행을 집계합니다.

`POST /v1/consolidations.list` · MCP `loom_consolidations_list` · role `viewer` · read · MCP `all` 툴셋에는 나열되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(신원 튜플의 첫 번째 요소)입니다. |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스입니다. |
| `agent` | `str` | `'-'` | 쓰거나 읽는 에이전트입니다. `'-'` 또는 `'*'`는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
| `user_id` | `str` | `'-'` | 행이 속한 최종 사용자입니다. 없으면 `'-'`입니다. |
| `session_id` | `str` | `'-'` | 행이 속한 세션 또는 대화입니다. 없으면 `'-'`입니다. |
| `run_id` | `str` | `'-'` | 호출이 속한 에이전트 실행(작업 범위)입니다. 없으면 `'-'`입니다. |
| `limit` | `int` | `50` | 최신순으로 최대 이 개수만큼의 실행을 반환합니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `rows` | `list[ConsolidationRunRow]` | 네임스페이스의 통합 실행 목록이며, 최신순으로 검사한 클러스터당 하나씩입니다. |

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