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

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

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

# Operaciones de `agents`

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

<!-- 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 completan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token a un servidor de un solo usuario, se usa la org de la instalación en todas las ops excepto `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="agentsconnected"></a>

## `agents.connected`

Los agentes activos en una ventana: última vez visto, operaciones y costo por agente.

`POST /v1/agents.connected` · MCP `loom_agents_connected` · 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 \| None` | `None` | Vacío → resumen de toda la org en todos los espacios de nombres que el llamador puede ver. |
| `window_hours` | `int` | `24` | Cuánto tiempo atrás se consulta. 24 h es el valor adecuado para comprobar si un reinicio surtió efecto; auméntalo para inspeccionar tendencias. |
| `count_only` | `bool` | `False` | La insignia de la barra lateral necesita un solo número (cuántos agentes se vieron por primera vez dentro de la ventana e hicieron algo), no la fila de cada agente. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `rows` | `list[ConnectedAgent]` | Una fila por cada agente visto en la ventana, del visto más recientemente al más antiguo; vacío con `count_only` o cuando el llamador no puede leer ningún espacio de nombres de la org. |
| `window_hours` | `int` | El período de consulta que cubren las filas, en horas (repite el de la solicitud). |
| `new_count` | `int \| None` | Con `count_only`, el número de agentes vistos por primera vez dentro de la ventana con al menos una op; None en caso contrario. |

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