Pular para o conteúdo
ClickHouse Loom
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Operações de blacklist

Operações de blacklist

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 blacklist.* recebe e retorna.

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, é usada a org da instalação em toda op, 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 role, kind e a listagem all do MCP. Campos de entrada desconhecidos são atendidos e listados em ignored_args.

blacklist.add

Recusa futuras gravações de memória cujo valor corresponda a um padrão.

POST /v1/blacklist.add · MCP loom_blacklist_add · role writer · idempotente · auditada

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.
pattern str obrigatório O texto a recusar, comparado com diferenciação de maiúsculas e minúsculas ao valor armazenado: como substring ou como regex de no máximo 256 caracteres.
pattern_type Literal['substring', 'regex'] 'substring' substring (texto simples) ou regex (RE2, nas gravações e na varredura; limitado na adição).
scope Literal['namespace', 'org', 'global'] 'namespace' Alcance: namespace (apenas este), org (todos os namespaces; exige admin da org) ou global (todos os tenants; exige admin da plataforma).
reason str '' Por que o padrão existe; é armazenado e listado.
created_by str '' Autor registrado apenas quando a chamada não tem um principal autenticado para carimbar.
sweep bool False Também marca como removidas (tombstone) as linhas ativas que o padrão já corresponde: dentro desta org e, para um padrão com escopo de namespace, dentro do namespace.
Campo de saída Tipo Significado
pattern_id str O id do novo padrão, para blacklist.sweep e blacklist.remove.
created_at datetime Quando o padrão foi armazenado (UTC).
swept int Linhas que a varredura marcou como removidas; 0 sem sweep.
swept_truncated bool Verdadeiro quando mais linhas corresponderam do que uma varredura comporta; chame blacklist.sweep.
sweep_error str “” quando a varredura terminou; caso contrário, o motivo (o padrão é armazenado de qualquer forma): <code>: <message> (execute de novo com blacklist.sweep), o motivo do RE2 quando uma regex não pode ser executada (nenhuma consulta rodou) ou o tipo de erro com que a consulta de correspondência falhou.

blacklist.list

Lista os padrões que impedem o armazenamento de memória.

POST /v1/blacklist.list · MCP loom_blacklist_list · role viewer · leitura · 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.
scope Literal['namespace', 'org', 'global'] | None None scope=None retorna todos os padrões que se aplicam a este (org, namespace), incluindo os de escopo mais alto (da org inteira, globais): o conjunto de regras efetivo, não apenas os fixados literalmente neste escopo.
limit int 100 No máximo esta quantidade de padrões, de 1 a 1000, do mais novo para o mais antigo.
Campo de saída Tipo Significado
rows list[_BlacklistRow] Os padrões ativos que correspondem ao filtro de escopo, do mais novo para o mais antigo.

blacklist.remove

Remove um padrão de blacklist adicionado anteriormente.

POST /v1/blacklist.remove · MCP loom_blacklist_remove · role 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).
pattern_id str obrigatório O padrão a marcar como removido; um padrão de namespace fora do alcance do chamador responde removed=false.
removed_by str '' Registrado apenas no marcador de versão do cache da blacklist, não na linha do padrão.
reason str '' Aceito, mas não armazenado.
Campo de saída Tipo Significado
removed bool Falso quando nenhum padrão ativo com esse id está visível para o chamador.
removed_at datetime | None Quando o padrão foi marcado como removido (UTC); nulo quando nada foi removido.

blacklist.sweep

Marca como removidas as linhas ativas que um padrão existente corresponde.

POST /v1/blacklist.sweep · MCP loom_blacklist_sweep · role writer · 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 obrigatório O namespace que a op lê ou grava.
pattern_id str obrigatório O padrão ativo com o qual varrer; um id desconhecido ou fora do alcance do chamador responde 404.
Campo de saída Tipo Significado
pattern_id str O padrão usado na varredura, repetido.
matched int Linhas ativas que o padrão correspondeu nesta chamada: no máximo 5,000 no ClickHouse, mais, sob a autoridade Postgres, as cabeças estacionadas que esta chamada marcou como removidas.
tombstoned int Linhas que esta chamada marcou como removidas.
truncated bool Verdadeiro quando mais linhas corresponderam do que uma chamada comporta; chame de novo.
error str “” quando a varredura terminou; caso contrário, <code>: <message> depois que linhas podem ter sido gravadas (chame de novo), o motivo do RE2 quando uma regex não pode ser executada (nenhuma consulta rodou) ou o tipo de erro com que a consulta de correspondência falhou; uma falha anterior a isso é da chamada.

Esta página foi útil?