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

# `ui` 操作

<!-- i18n: source=docs/reference/operations/ui.md blob=ffd7cacce585a7ebb18bf539ea2b742d0fd333e1 model=claude-sonnet-5-5 -->
> 本页由机器从[英文原文](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/ui.md)翻译，内容以英文原文为准。
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/ui.md), which is authoritative.


每个 `ui.*` 操作接受和返回的确切字段。

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

每个 op 都是 HTTP 上的 `POST /v1/<op>`，也是 MCP 工具 `loom_<op>`。身份字段（`org`、`namespace`、`agent`、`user_id`、`session_id`）在传输层能够提供时，会根据令牌和 MCP 会话自动填充；对于单用户服务器上不带令牌的 HTTP 调用，除 `code.*` 和 `tracker.*`（它们沿用各自平面的 org）之外，所有 op 都使用该安装的 org，而[部分 op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) 还会使用其命名空间和 agent；参见[身份与命名空间](/zh-CN/concepts/identities-and-namespaces)。[操作索引](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)说明了角色、类型以及 MCP `all` 列表。未知的输入字段照常处理，并列在 `ignored_args` 中。

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

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

## `ui.vitals`

记录一个控制台页面的 web vitals；传输层写入的每个 op 的账本行会携带这些字段。

`POST /v1/ui.vitals` · MCP `loom_ui_vitals` · 角色 `viewer` · 幂等 · 不在 MCP `all` 工具集中列出

| 输入字段 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| `org` | `str` | 必填 | 租户（身份元组的第一个元素）。 |
| `namespace` | `str` | 必填 | 该 op 读取或写入的命名空间。 |
| `agent` | `str` | `'loom-ui'` | 写入或读取的 agent；`'-'` 或 `'*'` 表示在 op 允许时的任意 agent。 |
| `route` | `str` | 必填 | 控制台路由 id（`memories`、`knowledge`、`admin/usage`...）。 |
| `lcp_ms` | `int \| None` | `None` | 会话首个视图的最大内容绘制时间，单位 ms；在客户端导航时为 None（浏览器每个文档只报告一次 LCP）。 |
| `long_task_ms` | `int` | `0` | 该视图内主线程长任务（>50 ms）的总和，单位 ms。 |
| `inp_ms` | `int \| None` | `None` | 该视图中最长的一次交互（事件计时条目的持续时间，即输入延迟 + 处理 + 呈现），单位 ms；若没有交互达到客户端的阈值则为 None。 |
| `dom_nodes` | `int` | `0` | 视图被刷新时文档中的元素数量（`*` 的计数）。 |
| `api_calls` | `int` | `0` | 该视图发出的 /v1 调用数，以及从第一个请求开始到最后一个响应结束的时间跨度，单位 ms。 |
| `api_ms` | `int` | `0` | 保持打开一小时并持续轮询的视图，其跨度会超过 600 s。 |
| `build` | `str` | `''` | 提供该 bundle 的服务器构建（health 的 build_commit）。 |
| `cold` | `bool` | `True` | 会话的首个视图（文档加载）为 True，SPA 内部导航为 False。 |

| 输出字段 | 类型 | 含义 |
| --- | --- | --- |
| `recorded` | `bool` | 始终为 true：vitals 随传输层为该调用写入的账本行一同记录。 |
| `route` | `str` | 该调用报告的路由 id（回显请求中的值）。 |

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