跳转至

尚无译文的页面会以英语打开,并标注为英语。

此机器翻译生成后,英文原文已更新。请阅读英文页面以获取当前说明。

本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.

ops 操作

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

每个操作都是 HTTP 上的 POST /v1/<op>,也是 MCP 工具 loom_<op>。身份字段(org、namespace、agent、user_id、session_id)在传输层能够提供时,由令牌和 MCP 会话填充;对于单用户服务器上不带令牌的 HTTP 调用,除 code.* 和 tracker.*(它们保留各自平面的 org)之外,所有操作都使用该安装的 org,而在部分操作上还会使用其命名空间和 agent;参见身份与命名空间。操作索引说明了角色、类型以及 MCP 的 all 列表。未知的输入字段会照常处理,并列在 ignored_args 中。

ops.capabilities

身份是可选的:客户端可以用手中持有的任意令牌发现接口(仅检查角色,不指定命名空间)。

POST /v1/ops.capabilities · MCP loom_ops_capabilities · 角色 viewer · 读取

输入字段 类型 默认值 含义
org str '' 租户(身份元组的第一个元素)。
consumer str '' 调用方集成的标签,记录在账本行中。
输出字段 类型 含义
build_commit str 构建所运行镜像的 git 提交;从源码运行时为空。
schema_version str 线路 schema 版本,即 X-Schema-Version 头所给出的版本。
ops list[OpCapability] 所有已注册的操作,按名称排序,包括隐藏的操作。
consumer_field str 所有请求模型中指明调用方的每个字段,即存储在每个账本行上的标签。

ops.health

运行部署的自检(schema 约定、嵌入桩、ClickHouse 分片、操作构成、过程平面、worker),并将每项结果报告为 ok、warn 或 fail。

POST /v1/ops.health · MCP loom_ops_health · 角色 org_admin · 幂等 · 不在 MCP all 工具集中列出

输入字段 类型 默认值 含义
org str 必填 租户(身份元组的第一个元素)。
namespace str \| None None 该操作读取或写入的命名空间。
输出字段 类型 含义
checks list[OpsHealthCheck] 每项健康检查一个条目(schema 约定、嵌入桩、分片、操作构成、worker 等),每个条目包含其状态,状态不为 ok 时还包含建议的修复方法。
worker_status dict[str, dict[str, Any]] 此进程中每个后台 worker 的状态:上次运行时间、耗时、结果、上次错误的类型(last_error_kind)、连续失败次数和总运行次数;在任何 worker 运行之前为空。
overall Literal['ok', 'warn', 'fail'] 任一检查失败时为 fail,否则任一检查告警时为 warn,否则为 ok。

ops.projection_failures.list

列出已记录的投影失败:写入未能生成的派生行(嵌入、图边、摘要)。

POST /v1/ops.projection_failures.list · MCP loom_ops_projection_failures_list · 角色 org_admin · 幂等 · 不在 MCP all 工具集中列出

输入字段 类型 默认值 含义
org str 必填 租户(身份元组的第一个元素)。
namespace str \| None None 该操作读取或写入的命名空间。
projection str '' 仅列出此投影的失败(即派生表,例如 memory_chunks 或 entity_edges);为空则列出所有投影。
status Literal['active', 'resolved', 'abandoned', ''] 'active' active 列出未解决的失败,resolved 列出已修复的失败,abandoned 列出修复已放弃的失败(原因在 error_message 中),为空则列出全部。
limit int 100 最多返回这么多条失败,最新的在前。
输出字段 类型 含义
rows list[ProjectionFailureRow] 与过滤条件匹配的已记录失败,最新的在前。
total int 返回的行数(不含超出 limit 的数量)。

ops.projection_failures.resolve

按 id 将投影失败标记为已解决,不重试。

POST /v1/ops.projection_failures.resolve · MCP loom_ops_projection_failures_resolve · 角色 org_admin · 幂等 · 已审计 · 不在 MCP all 工具集中列出

输入字段 类型 默认值 含义
org str 必填 租户(身份元组的第一个元素)。
failure_ids list[str] 必填 要标记为已解决且不重试的失败,1 到 500 个 id。
输出字段 类型 含义
resolved int 提交用于解决的非空 id 数;与任何未解决失败都不匹配的 id 也会计入。

ops.projection_failures.retry

重试某个命名空间下未解决的投影失败,可选择只重试某一种投影。

POST /v1/ops.projection_failures.retry · MCP loom_ops_projection_failures_retry · 角色 org_admin · 幂等 · 已审计 · 不在 MCP all 工具集中列出

输入字段 类型 默认值 含义
org str 必填 租户(身份元组的第一个元素)。
namespace str \| None None 该操作读取或写入的命名空间。
projection str '' 仅重试此投影的失败;为空则重试所有投影。
limit int 50 最多重试这么多条未解决的失败,最新的在前。
输出字段 类型 含义
results list[ProjectionFailureRetryRow] 每个已尝试的失败一个条目,说明是否已重试并解决,以及未成功的原因。
retried int 其投影具有重试路径且已尝试重试的失败数。
resolved int 重试成功并已标记为已解决的失败数。
abandoned int 重试已放弃、现已标记为 abandoned 的失败数。