Operações `ops`
Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.
Os campos exatos que cada operação ops.* recebe e retorna.
Toda op é um 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, usa-se a org da instalação em todas as ops, exceto code.* e tracker.* (que mantêm a do seu plano), e em algumas ops também o namespace e o agente; veja identidades e namespaces. O índice de operações explica papel, tipo e a listagem all do MCP. Campos de entrada desconhecidos são atendidos e listados em ignored_args.
ops.capabilities
A identidade é opcional: um cliente descobre a superfície com o token que tiver (apenas verificação de papel; nenhum namespace é endereçado).
POST /v1/ops.capabilities · MCP loom_ops_capabilities · papel viewer · leitura
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
'' |
O tenant (primeiro elemento da tupla de identidade). |
consumer |
str |
'' |
A tag da integração que faz a chamada, registrada na linha do ledger. |
| Campo de saída | Tipo | Significado |
|---|---|---|
build_commit |
str |
O commit do git a partir do qual a imagem em execução foi construída; vazio em uma execução a partir do código-fonte. |
schema_version |
str |
A versão do schema de transmissão, como o cabeçalho X-Schema-Version a nomeia. |
ops |
list[OpCapability] |
Toda operação registrada, ordenada por nome, incluindo as ocultas. |
consumer_field |
str |
Todo campo de todo modelo de requisição que nomeia o consumer — a tag armazenada em cada linha do ledger. |
ops.health
Executa as autoverificações da implantação (contratos de schema, stubs de embedding, partes do ClickHouse, mix de ops, plano de procedimentos, workers) e informa cada uma como ok, warn ou fail.
POST /v1/ops.health · MCP loom_ops_health · papel org_admin · 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 | None |
None |
O namespace que a op lê ou grava. |
| Campo de saída | Tipo | Significado |
|---|---|---|
checks |
list[OpsHealthCheck] |
Uma entrada por verificação de saúde (contratos de schema, stubs de embedding, partes, mix de ops, workers, …), cada uma com seu status e, quando não for ok, um reparo sugerido. |
worker_status |
dict[str, dict[str, Any]] |
Por worker em segundo plano neste processo: hora da última execução, duração, resultado, o tipo do último erro (last_error_kind), falhas consecutivas e total de execuções; vazio antes de qualquer worker ter executado. |
overall |
Literal['ok', 'warn', 'fail'] |
fail quando alguma verificação falhou; senão warn quando alguma emitiu aviso; senão ok. |
ops.projection_failures.list
Lista as falhas de projeção registradas: linhas derivadas (embeddings, arestas de grafo, resumos) que uma gravação não conseguiu produzir.
POST /v1/ops.projection_failures.list · MCP loom_ops_projection_failures_list · papel org_admin · 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 | None |
None |
O namespace que a op lê ou grava. |
projection |
str |
'' |
Somente falhas desta projeção (a tabela derivada, como memory_chunks ou entity_edges); vazio lista todas as projeções. |
status |
Literal['active', 'resolved', 'abandoned', ''] |
'active' |
active lista as falhas abertas, resolved as reparadas, abandoned aquelas das quais o reparo desistiu (o motivo está em error_message), vazio todas. |
limit |
int |
100 |
No máximo esta quantidade de falhas, das mais recentes para as mais antigas. |
| Campo de saída | Tipo | Significado |
|---|---|---|
rows |
list[ProjectionFailureRow] |
As falhas registradas que correspondem aos filtros, das mais recentes para as mais antigas. |
total |
int |
Número de linhas retornadas (não a contagem além de limit). |
ops.projection_failures.resolve
Marca falhas de projeção como resolvidas por id, sem tentar novamente.
POST /v1/ops.projection_failures.resolve · MCP loom_ops_projection_failures_resolve · papel org_admin · idempotente · auditada · 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). |
failure_ids |
list[str] |
obrigatório | As falhas a marcar como resolvidas sem tentar novamente, de 1 a 500 ids. |
| Campo de saída | Tipo | Significado |
|---|---|---|
resolved |
int |
Ids não vazios enviados para resolução; ids que não correspondem a nenhuma falha ativa são contados. |
ops.projection_failures.retry
Tenta novamente as falhas de projeção abertas de um namespace, opcionalmente de um só tipo de projeção.
POST /v1/ops.projection_failures.retry · MCP loom_ops_projection_failures_retry · papel org_admin · idempotente · auditada · 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 | None |
None |
O namespace que a op lê ou grava. |
projection |
str |
'' |
Tenta novamente apenas as falhas desta projeção; vazio tenta novamente todas as projeções. |
limit |
int |
50 |
No máximo esta quantidade de falhas ativas é reprocessada, das mais recentes para as mais antigas. |
| Campo de saída | Tipo | Significado |
|---|---|---|
results |
list[ProjectionFailureRetryRow] |
Uma entrada por falha tentada, indicando se foi reprocessada e resolvida e, caso contrário, por quê. |
retried |
int |
Falhas cuja projeção tem um caminho de nova tentativa e foi tentada. |
resolved |
int |
Falhas cuja nova tentativa teve sucesso e que agora estão marcadas como resolvidas. |
abandoned |
int |
Falhas das quais a nova tentativa desistiu, agora marcadas como abandonadas. |