> Source: https://clickhouse.github.io/loom/es/reference/operations/insights/ (Markdown: https://clickhouse.github.io/loom/es/reference/operations/insights.md)

<!-- i18n: source=docs/reference/operations/insights.md blob=e9bec66357b14346f32afbb1ad6f0a50b74bb290 model=claude-sonnet-5-5 -->
> Esta página es una traducción automática de la [página en inglés](https://clickhouse.github.io/loom/reference/operations/insights/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/insights/), which is authoritative.

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

# Operaciones de `insights`

Los campos exactos que recibe y devuelve cada operación `insights.*`.

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

Cada op es `POST /v1/<op>` sobre HTTP y la herramienta MCP `loom_<op>`. Los campos de identidad (`org`, `namespace`, `agent`, `user_id`, `session_id`) se rellenan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token en un servidor de un solo usuario, se rellena con la org de la instalación en todas las ops salvo `code.*` y `tracker.*` (que conservan la de su plano), y en [algunas ops](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) también su espacio de nombres y su agente; consulta [identidades y espacios de nombres](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md). El [índice de operaciones](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica el rol, el tipo y el listado `all` de MCP. Los campos de entrada desconocidos se atienden y se nombran en `ignored_args`.

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

<a id="insightscatalog"></a>

## `insights.catalog`

Lista las tablas que `insights.query` puede leer: cada columna con su tipo y significado, cómo leer correctamente la tabla (una fila activa por clave, o una fila por evento) y los límites bajo los que se ejecuta una sentencia.

`POST /v1/insights.catalog` · MCP `loom_insights_catalog` · rol `viewer` · lectura · no aparece en el conjunto de herramientas `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `namespace` | `str` | obligatorio | El espacio de nombres que la op lee o escribe. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `tables` | `list[CatalogTable]` | Las tablas que lee insights.query, con sus columnas y cómo leerlas. |
| `max_result_rows` | `int` | El máximo de filas que devuelve una sentencia; si se supera, la respuesta se trunca. |
| `max_execution_s` | `float` | El tiempo máximo que una sentencia se ejecuta antes de que ClickHouse la detenga (límite de esta réplica; durante un despliegue progresivo el perfil de límites almacenado puede diferir). |
| `max_rows_to_read` | `int` | El máximo de filas que una sentencia puede leer; si se supera, añade un filtro de tiempo o de clave. |

<a id="insightsquery"></a>

## `insights.query`

Ejecuta una sola sentencia SQL SELECT (o WITH) de solo lectura sobre las tablas que lista `insights.catalog`, para las preguntas que ninguna otra lectura responde: recuentos, clasificaciones y tendencias sobre memorias, conflictos, uso, documentos y el…

`POST /v1/insights.query` · MCP `loom_insights_query` · rol `viewer` · lectura · no aparece en el conjunto de herramientas `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `namespace` | `str` | obligatorio | El espacio de nombres que la op lee o escribe. |
| `sql` | `str` | obligatorio | Una sentencia SELECT o WITH sobre las tablas que lista insights.catalog; solo lee las filas de este espacio de nombres. |
| `limit` | `int` | `100` | Máximo de filas que se devuelven (por defecto 100); si el límite del despliegue (LOOM_CH_ANALYSIS_MAX_RESULT_ROWS) es menor, prevalece este. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `columns` | `list[AnalysisColumn]` | Las columnas de resultado de la sentencia, cada una con su tipo de ClickHouse. |
| `rows` | `list[list[Any]]` | Una lista por fila, en el orden de `columns`; las fechas, los UUID y los decimales como cadenas. |
| `row_count` | `int` | Cuántas filas contiene `rows`, como máximo `limit`. |
| `truncated` | `bool` | Coincidieron más filas que `limit`; acota la sentencia o agrega. |
| `sql_digest` | `str` | El digest que el registro de solicitudes guarda para `sql` (`sha256:<hex>/<length>`), contra el que se comprueba la cita de la sentencia. |

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