As páginas sem tradução abrem em inglês e são identificadas como inglês.
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.
Operações de decision
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. |