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

<!-- i18n: source=docs/reference/operations/mentor.md blob=7893c77086ab087e1a7a997a0a406af5c6c3016a 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/mentor/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/mentor/), which is authoritative.

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

# Operaciones de `mentor`

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

<!-- 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 usa 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="mentorbrief"></a>

## `mentor.brief`

El perfil de uso de un agente y las sugerencias del almacén.

`POST /v1/mentor.brief` · MCP `loom_mentor_brief` · rol `viewer` · lectura

| 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. |
| `agent` | `str` | `''` | El agente que escribe o lee; `'-'` o `'*'` significa cualquier agente donde la op lo permita. |
| `window_seconds` | `int` | `604800` | Hasta dónde llega hacia atrás la lectura del registro, en segundos; de 1 hora a 90 días. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `org` | `str` | El tenant (primer elemento de la tupla de identidad). |
| `namespace` | `str` | El espacio de nombres que la op lee o escribe. |
| `agent` | `str` | El agente que escribe o lee; `'-'` o `'*'` significa cualquier agente donde la op lo permita. |
| `window_seconds` | `int` | La ventana sobre la que se calculó el perfil, en segundos; un perfil servido desde la caché conserva la ventana con la que se calculó. |
| `computed_at` | `datetime` | Cuándo se calculó el perfil (UTC); anterior a la llamada cuando se sirve desde la caché. |
| `sessions` | `int` | Sesiones distintas con nombre de cliente de este agente en la ventana (`-` y `*` no cuentan). |
| `usage` | `dict[str, int]` | Llamadas por operación de este agente en la ventana. |
| `planes` | `list[MentorPlane]` | Cada plano que el mentor conoce, con las llamadas de este agente a él y si está disponible. |
| `hints` | `list[MentorHint]` | Las reglas que se activaron para este agente, cada una con los recuentos que la activaron; vacío si no hay ninguna. |
| `adoption` | `list[MentorAdoption]` | Por código de sugerencia, las sesiones en las que se mostró y en las que se siguió, de más a menos mostrada; vacío si ninguna sugerencia llegó al agente o la lectura falló. |
| `usage_evidence` | `list[UsageRung]` | El uso de Loom por parte del agente en la ventana, un peldaño cada uno, de la afirmación más débil a la más fuerte: desde una llamada realizada hasta una ejecución evaluada. |
| `ledger_from` | `datetime \| None` | La fila más antigua del registro de este agente en la ventana, de cualquier tipo; None cuando no hay ninguna o la lectura falló. |
| `ledger_retention_days` | `int \| None` | Días que la retención configurada conserva las filas del registro de llamadas de este espacio de nombres; 0 las conserva hasta que se borren, None cuando la lectura falló. |
| `agents` | `list[str]` | Los agentes que escriben en el espacio de nombres en la ventana, del más activo al menos; el brief usa por defecto el primero cuando quien llama no tiene un nombre de agente propio (el dashboard); `agent_defaulted` lo indica. |
| `agent_defaulted` | `bool` | True cuando quien llama no indicó ningún agente real y el brief eligió al principal escritor de `agents`. |
| `skipped` | `list[str]` | Datos que el brief no pudo leer, con el formato "paso: motivo". |
| `healthy` | `bool` | No hay ninguna sugerencia de advertencia ni crítica. |

<a id="mentorguide"></a>

## `mentor.guide`

La guía del agente que distribuye este servidor; es la misma para todos los que llaman.

`POST /v1/mentor.guide` · MCP `loom_mentor_guide` · rol `viewer` · lectura · no aparece en el conjunto de herramientas `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | `''` | El tenant (primer elemento de la tupla de identidad). |
| `part` | `Literal['skill', 'reference', 'all']` | `'skill'` | Qué parte: `skill` (el bucle y las reglas, el valor por defecto), `reference` (cada plano) o `all`. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `version` | `str` | La versión de la guía (`metadata.version` de skills/loom/SKILL.md). |
| `part` | `Literal['skill', 'reference', 'all']` | La parte devuelta, tal como se pidió. |
| `text` | `str` | La guía en Markdown, sin el frontmatter de la skill. |

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