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

# Operações `ui`

<!-- i18n: source=docs/reference/operations/ui.md blob=ffd7cacce585a7ebb18bf539ea2b742d0fd333e1 model=claude-sonnet-5-5 -->
> Esta página é uma tradução automática da [página em inglês](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/ui.md), que prevalece.
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/ui.md), which is authoritative.


Os campos exatos que cada operação `ui.*` 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 toda op, 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](/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 nomeados em `ignored_args`.

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

<a id="uivitals"></a>

## `ui.vitals`

Registra os web vitals de uma página do painel; a linha do ledger por op que o transporte grava carrega os campos.

`POST /v1/ui.vitals` · MCP `loom_ui_vitals` · role `viewer` · idempotente · não listada no toolset `all` do MCP

| Campo de entrada | Tipo | Padrão | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obrigatório | O tenant (primeiro elemento da tupla de identidade). |
| `namespace` | `str` | obrigatório | O namespace que a op lê ou grava. |
| `agent` | `str` | `'loom-ui'` | O agente que grava ou lê; `'-'` ou `'*'` significa qualquer agente onde a op permitir. |
| `route` | `str` | obrigatório | O id da rota do painel (`memories`, `knowledge`, `admin/usage`...). |
| `lcp_ms` | `int \| None` | `None` | Largest contentful paint da primeira visualização da sessão, em ms; None em uma navegação no cliente (o navegador reporta o LCP uma vez por documento). |
| `long_task_ms` | `int` | `0` | Long tasks da thread principal (>50 ms) somadas ao longo da visualização, em ms. |
| `inp_ms` | `int \| None` | `None` | A interação mais longa da visualização (a duração de uma entrada de event-timing: atraso de entrada + processamento + apresentação), em ms; None quando nenhuma atingiu o limite do cliente. |
| `dom_nodes` | `int` | `0` | Elementos no documento quando a visualização foi descarregada (a contagem de `*`). |
| `api_calls` | `int` | `0` | Chamadas /v1 que a visualização fez e o intervalo entre o início da primeira requisição e o fim da última resposta, em ms. |
| `api_ms` | `int` | `0` | Uma visualização mantida aberta por uma hora de polls dura mais de 600 s. |
| `build` | `str` | `''` | O build do servidor que serviu o bundle (build_commit do health). |
| `cold` | `bool` | `True` | True para a primeira visualização da sessão (um carregamento de documento), False para uma navegação dentro da SPA. |

| Campo de saída | Tipo | Significado |
| --- | --- | --- |
| `recorded` | `bool` | Sempre true: os vitals vão na linha do ledger que o transporte grava para a chamada. |
| `route` | `str` | O id da rota que a chamada reportou (repete o da requisição). |

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