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

<!-- i18n: source=docs/reference/operations/agents.md blob=11cf9820829edf06a3d6f59c965320b48916ba68 model=claude-sonnet-5-5 -->
> Esta página é uma tradução automática da [página em 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>

# Operações de `agents`

Os campos exatos que cada operação `agents.*` recebe e retorna.

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

Toda op é `POST /v1/<op>` via HTTP e a ferramenta MCP `loom_<op>`. Os campos de identidade (`org`, `namespace`, `agent`, `user_id`, `session_id`) são preenchidos a partir do token e da sessão MCP quando o transporte consegue; em uma chamada HTTP sem token em um servidor de usuário único, vale a org da instalação em todas as ops, exceto `code.*` e `tracker.*` (que mantêm a do seu plano), e, em [algumas ops](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request), também o namespace e o agente; veja [identidades e namespaces](https://clickhouse.github.io/loom/pt-BR/concepts/identities-and-namespaces/). O [índice de operações](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica role, kind e a listagem `all` do MCP. Campos de entrada desconhecidos são atendidos e listados em `ignored_args`.

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

<a id="agentsconnected"></a>

## `agents.connected`

Os agentes ativos em uma janela: última vez visto, operações e custo por agente.

`POST /v1/agents.connected` · MCP `loom_agents_connected` · role `viewer` · read

| Campo de entrada | Tipo | Padrão | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obrigatório | O tenant (primeiro elemento da tupla de identidade). |
| `namespace` | `str \| None` | `None` | Vazio → consolidação em toda a org, em todos os namespaces que o chamador pode ver. |
| `window_hours` | `int` | `24` | Até quanto tempo atrás consultar. 24h é o padrão adequado para a verificação "minha reinicialização surtiu efeito"; aumente para inspeção de tendências. |
| `count_only` | `bool` | `False` | O selo da barra lateral quer um único número (quantos agentes foram vistos pela primeira vez dentro da janela e fizeram algo), não a linha de cada agente. |

| Campo de saída | Tipo | Significado |
| --- | --- | --- |
| `rows` | `list[ConnectedAgent]` | Uma linha por agente visto na janela, do visto mais recentemente para o mais antigo; vazio com `count_only` ou quando o chamador não pode ler nenhum namespace da org. |
| `window_hours` | `int` | O período de consulta que as linhas cobrem, em horas (repete o valor da requisição). |
| `new_count` | `int \| None` | Com `count_only`, o número de agentes vistos pela primeira vez dentro da janela com pelo menos uma op; None caso contrário. |

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