Las páginas sin traducir se abren en inglés y se indican como inglés.
Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.
Operaciones de insights
Los campos exactos que recibe y devuelve cada operación insights.*.
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 también su espacio de nombres y su agente; consulta identidades y espacios de nombres. El índice de operaciones explica el rol, el tipo y el listado all de MCP. Los campos de entrada desconocidos se atienden y se nombran en ignored_args.
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. |
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. |