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

Operações de decision

Operações de decision

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

Toda operação é 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 fazer isso. Em uma chamada HTTP sem token em um servidor de usuário único, é usada a org da instalação em todas as operações, exceto code.* e tracker.* (que mantêm a org do seu próprio plano), e em algumas operações 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.

decision.chain

Rastreia a cadeia causal de uma decisão: a montante (o que a causou ou influenciou) e/ou a jusante (o que ela passou a causar), com até 4 saltos sobre o grafo criado manualmente.

POST /v1/decision.chain · MCP loom_decision_chain · role viewer · leitura · não listado 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 escreve.
memory_key str obrigatório A chave a partir da qual iniciar a navegação, geralmente a de uma decisão.
direction Literal['upstream', 'downstream', 'both'] 'both' upstream segue o que levou até aqui, downstream o que decorreu daqui, both percorre os dois sentidos.
max_hops int 3 A quantas arestas de distância navegar, de 1 a 4.
Campo de saída Tipo Significado
seed str A chave inicial, devolvida como foi enviada.
seed_decision DecisionRow | None O registro de decisão da chave inicial; nulo quando a chave inicial não é uma decisão ativa.
nodes list[ChainNodeRow] Cada chave alcançada por arestas caused, influenced ou derived_from, uma única vez, começando pelo salto mais próximo.

decision.outcome

Feche o ciclo de uma decisão depois que a realidade respondeu: registre o que de fato aconteceu e se funcionou (success).

POST /v1/decision.outcome · MCP loom_decision_outcome · role writer · write · audited · não listado 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.
memory_key str obrigatório A decisão ativa a ser atualizada; responde 404 quando não há nenhuma, ou quando o escritor do registro não tem uma linha de decisão ativa sob a chave.
realized_outcome str obrigatório O que de fato aconteceu, armazenado no registro da decisão.
success bool | None None None mantém o veredito do registro; True/False o define e credita (ou marca) as memórias da execução que decidiu.
agent str '*' O agente que escreve ou lê; '-' ou '*' significa qualquer agente onde a op permitir.
Campo de saída Tipo Significado
memory_key str A chave da decisão, devolvida como recebida.
updated bool Sempre true: uma decisão inexistente responde 404 em vez disso.
memories_credited int Memórias creditadas por meio do ledger de execuções (run.complete memories_used).

decision.precedents

ANTES de decidir, pergunte o que foi decidido em situações semelhantes: busca semântica sobre decisões passadas (opcionalmente dentro de uma categoria), cada uma com seu raciocínio, alternativas rejeitadas e — quando conhecido…

POST /v1/decision.precedents · MCP loom_decision_precedents · role viewer · leitura · não listado 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 escreve.
agent str '*' O agente que escreve ou lê; '-' ou '*' significa qualquer agente onde a op permitir.
query str obrigatório O cenário em questão, descrito como o agente que decide o vê.
category str '' Somente decisões desta categoria (sem diferenciar maiúsculas de minúsculas); “” pesquisa todas as categorias.
top_k int 5 No máximo este número de precedentes, 1-25.
with_outcome_only bool False Somente decisões cujo resultado realizado é conhecido (decision.outcome foi chamado).
Campo de saída Tipo Significado
precedents list[DecisionRow] Decisões passadas ativas, com a declaração de decisão mais semelhante primeiro.
embedding_model str O embedder que a busca de memória subjacente usou.

decision.record

Registre uma DECISÃO como um objeto de primeira classe — chame-a sempre que escolher entre opções que importarão depois (um fornecedor, um design, uma correção, um rollback).

POST /v1/decision.record · MCP loom_decision_record · papel 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 escreve.
agent str obrigatório O agente que escreve ou lê; '-' ou '*' significa qualquer agente onde a op permitir.
user_id str '-' O usuário final a quem a linha pertence; '-' para nenhum.
session_id str '-' A sessão ou conversa a que a linha pertence; '-' para nenhuma.
run_id str '-' A execução em que esta decisão foi tomada (run.begin).
category str obrigatório category + scenario identificam a decisão: decidir de novo o mesmo cenário substitui o registro anterior (o histórico o mantém).
scenario str obrigatório A situação que precisava de uma decisão; decision.precedents compara uma consulta com o enunciado da decisão, que começa com o cenário.
reasoning str obrigatório Por que este resultado foi escolhido.
outcome str obrigatório O que foi decidido.
alternatives list[str] (calculado) O que foi considerado e não escolhido — o campo de que toda pergunta do tipo “por que não X” precisa e que a maioria dos registros de decisão omite.
confidence float 0.0 A confiança de quem decidiu, de 0 a 1; 0 não registra nenhuma (a linha de memória e as arestas passam a carregar 1.0).
stage Literal['decided', 'proposed'] 'decided' “decided” (padrão), ou “proposed” para uma opção apresentada e ainda não escolhida nem implementada (uma proposta, um plano, um item de ação); sem relação com o proposed de memory.set, um fato em avaliação.
decision_maker str '' Quem decidiu, uma pessoa ou um agente; “” registra o agent que fez a chamada.
caused_by list[str] (calculado) memory_keys (decisões, fatos, procedimentos) que CAUSARAM ou INFLUENCIARAM esta decisão; cada um vira uma aresta autoral (memory.link) tendo esta chamada como evidência.
influenced_by list[str] (calculado) Chaves que moldaram a decisão sem causá-la; cada uma vira uma aresta influenced.
tags list[str] (calculado) Tags extras na linha de memória, além de decision e decision:category:<category>; uma tag decision:proposed aqui é descartada (defina-a com stage).
valid_at datetime | None None Momento no mundo real em que a decisão passou a valer; None = agora.
files list[str] | None None Os arquivos do repositório que esta decisão rege (caminho relativo ao repositório ou nome simples de arquivo); memory.for_file a serve antes de uma edição deles.
source_class Literal['derived', 'external', 'imported'] | None None Declara que esta decisão foi derivada de outro conteúdo (derived) ou veio de fora (external, imported).
source_resource_id str '' O caminho de arquivo, id de documento ou URL de onde esta decisão foi tirada, citado nos seus resultados.
Campo de saída Tipo Significado
memory_key str A chave da decisão, derivada de category + scenario; passe-a para decision.outcome e decision.chain.
record_id str O id da versão do registro decision gravada.
superseded_prior bool True quando existia uma decisão ativa para o mesmo category + scenario e ela agora foi substituída por esta.
edges_written int Quantas arestas caused / influenced foram gravadas; um link que falha é ignorado.
next str Dica em texto simples que indica as operações seguintes.

Esta página foi útil?