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

Operações `insights`

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 insights.* 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, vale a org da instalação em todas as ops, exceto code.* e tracker.* (que mantêm a do seu plano), e, em algumas ops, 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 nomeados em ignored_args.

insights.catalog

Lista as tabelas que insights.query pode ler: cada coluna com seu tipo e significado, como ler a tabela corretamente (uma linha ativa por chave, ou uma linha por evento) e os limites sob os quais uma instrução é executada.

POST /v1/insights.catalog · MCP loom_insights_catalog · role viewer · read · 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.
Campo de saída Tipo Significado
tables list[CatalogTable] As tabelas que insights.query lê, com suas colunas e como lê-las.
max_result_rows int O máximo de linhas que uma instrução retorna; além disso, a resposta é truncada.
max_execution_s float O maior tempo que uma instrução roda antes de o ClickHouse interrompê-la (limite desta réplica; durante um roll, o perfil de limites armazenado pode ser diferente).
max_rows_to_read int O máximo de linhas que uma instrução pode ler; acima disso, adicione um filtro de tempo ou de chave.

insights.query

Executa uma única instrução SQL SELECT (ou WITH) somente leitura sobre as tabelas que insights.catalog lista, para perguntas que nenhuma outra leitura responde: contagens, rankings e tendências sobre memórias, conflitos, uso, documentos e o…

POST /v1/insights.query · MCP loom_insights_query · role viewer · read · 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.
sql str obrigatório Uma instrução SELECT ou WITH sobre as tabelas que insights.catalog lista; ela lê apenas as linhas deste namespace.
limit int 100 O máximo de linhas a retornar (padrão 100); o limite do deployment (LOOM_CH_ANALYSIS_MAX_RESULT_ROWS) prevalece quando for menor.
Campo de saída Tipo Significado
columns list[AnalysisColumn] As colunas de resultado da instrução, cada uma com seu tipo no ClickHouse.
rows list[list[Any]] Uma lista por linha, na ordem de columns; datas, UUIDs e decimais como strings.
row_count int Quantas linhas rows contém, no máximo limit.
truncated bool Mais linhas correspondem do que limit; restrinja a instrução ou agregue.
sql_digest str O digest que o ledger de requisições registra para sql (sha256:<hex>/<length>), contra o qual a citação da instrução é verificada.

Esta página foi útil?