---
title: "Operações de `decision`"
---

<!-- i18n: source=docs/reference/operations/decision.md blob=9fbe60affa0e34bb6463c05d33129561f188a162 model=claude-sonnet-5-5 -->
> Esta página é uma tradução automática da [página em inglês](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/decision.md), que prevalece.
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/decision.md), which is authoritative.

<a id="decision-operations"></a>

Os campos exatos que cada operação `decision.*` recebe e retorna.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

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](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) também o namespace e o agente. Veja [identidades e namespaces](/docs/pt-BR/concepts/identities-and-namespaces). O [índice de operações](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica role, kind e a listagem `all` do MCP. Campos de entrada desconhecidos são atendidos e listados em `ignored_args`.

<!-- prettier-ignore-start -->

<a id="decisionchain"></a>

## `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. |

<a id="decisionoutcome"></a>

## `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). |

<a id="decisionprecedents"></a>

## `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. |

<a id="decisionrecord"></a>

## `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. |

<!-- prettier-ignore-end -->
