> Source: https://clickhouse.github.io/loom/ja/reference/operations/decision/ (Markdown: https://clickhouse.github.io/loom/ja/reference/operations/decision.md)

<!-- i18n: source=docs/reference/operations/decision.md blob=9fbe60affa0e34bb6463c05d33129561f188a162 model=claude-sonnet-5-5 -->
> このページは[英語の原文](https://clickhouse.github.io/loom/reference/operations/decision/)の機械翻訳です。内容は英語の原文が優先されます。
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/decision/), which is authoritative.

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

# `decision` オペレーション

各 `decision.*` オペレーションが受け取るフィールドと返すフィールドを正確に示します。

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

すべてのオペレーションは、HTTP では `POST /v1/<op>`、MCP ツールでは `loom_<op>` として呼び出せます。ID フィールド（`org`、`namespace`、`agent`、`user_id`、`session_id`）は、トランスポートが対応している場合にトークンと MCP セッションから補完されます。単一ユーザーのサーバーでトークンなしに HTTP 呼び出しを行うと、`code.*` と `tracker.*`（それぞれのプレーンの値を保持します）を除くすべてのオペレーションでインストールの org が使われ、[一部のオペレーション](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)では名前空間とエージェントも補完されます。詳しくは[ID と名前空間](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)を参照してください。ロール、種別、MCP の `all` 一覧については[オペレーション一覧](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)で説明しています。未知の入力フィールドは処理されたうえで、`ignored_args` に名前が示されます。

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

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

## `decision.chain`

決定の因果連鎖をたどります。上流（その決定を引き起こした、または影響を与えたもの）と下流（その決定が引き起こしたもの）のどちらか、または両方を、作成済みのグラフ上で最大 4 ホップまでたどります。

`POST /v1/decision.chain` · MCP `loom_decision_chain` · role `viewer` · read · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（識別タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | op が読み取りまたは書き込みを行う名前空間。 |
| `memory_key` | `str` | 必須 | たどり始めるキー。通常は決定のキーです。 |
| `direction` | `Literal['upstream', 'downstream', 'both']` | `'both'` | `upstream` はここに至った原因を、`downstream` はここから生じた結果をたどります。`both` は両方をたどります。 |
| `max_hops` | `int` | `3` | たどるエッジの数。1〜4。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `seed` | `str` | 開始キー（そのまま返されます）。 |
| `seed_decision` | `DecisionRow \| None` | シードの決定レコード。シードが有効な決定でない場合は null。 |
| `nodes` | `list[ChainNodeRow]` | `caused`、`influenced`、`derived_from` のエッジをたどって到達したすべてのキー。各キーは 1 回だけ含まれ、近いホップから順に並びます。 |

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

## `decision.outcome`

現実の結果が出たあとに決定のループを閉じます。実際に何が起きたか、またそれがうまくいったか（success）を記録します。

`POST /v1/decision.outcome` · MCP `loom_decision_outcome` · ロール `writer` · 書き込み · 監査対象 · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（アイデンティティタプルの最初の要素）。 |
| `namespace` | `str` | 必須 | この op が読み書きする名前空間。 |
| `memory_key` | `str` | 必須 | 更新対象の有効な決定。該当する決定がない場合、またはレコードの書き込み元に、このキーの有効な決定行がない場合は 404 を返します。 |
| `realized_outcome` | `str` | 必須 | 実際に起きたこと。決定レコードに保存されます。 |
| `success` | `bool \| None` | `None` | None の場合はレコードの判定をそのまま維持します。True/False を指定すると判定を設定し、決定を下した run のメモリにクレジットを付与（またはマーク）します。 |
| `agent` | `str` | `'*'` | 書き込みまたは読み取りを行うエージェント。`'-'` または `'*'` は、op が許可する場合に任意のエージェントを意味します。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `memory_key` | `str` | 決定のキー（そのまま返されます）。 |
| `updated` | `bool` | 常に true です。決定が存在しない場合は代わりに 404 を返します。 |
| `memories_credited` | `int` | run 台帳を通じてクレジットされたメモリの数（run.complete の memories_used）。 |

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

## `decision.precedents`

決定を下す前に、似た状況で何が決定されたかを確認します。過去の決定に対するセマンティック検索（カテゴリを指定することも可能）で、それぞれの決定について、その理由、却下された代替案、そして判明している場合は…

`POST /v1/decision.precedents` · MCP `loom_decision_precedents` · ロール `viewer` · 読み取り · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（識別タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | この op が読み書きする名前空間。 |
| `agent` | `str` | `'*'` | 書き込みまたは読み取りを行うエージェント。`'-'` または `'*'` は、op が許可する場合に任意のエージェントを意味します。 |
| `query` | `str` | 必須 | 決定を下すエージェントから見た、現在のシナリオ。 |
| `category` | `str` | `''` | このカテゴリの決定のみを対象にします（大文字と小文字を区別しません）。"" の場合は全カテゴリを検索します。 |
| `top_k` | `int` | `5` | 返す先例の最大件数。1〜25。 |
| `with_outcome_only` | `bool` | `False` | 実現した結果が判明している決定のみを対象にします（decision.outcome が呼び出されたもの）。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `precedents` | `list[DecisionRow]` | 有効な過去の決定。決定内容が最も類似するものが先頭になります。 |
| `embedding_model` | `str` | 内部のメモリ検索が使用したエンベッダー。 |

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

## `decision.record`

DECISION を第一級のオブジェクトとして記録します。後で影響する選択（ベンダー、設計、修正、ロールバックなど）で選択肢のうちどれかを選ぶたびに呼び出してください。

`POST /v1/decision.record` · MCP `loom_decision_record` · ロール `writer` · 冪等 · 監査対象 · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | この op が読み書きする名前空間。 |
| `agent` | `str` | 必須 | 書き込みまたは読み取りを行うエージェント。op が許す場合、`'-'` または `'*'` は任意のエージェントを意味します。 |
| `user_id` | `str` | `'-'` | 行が属するエンドユーザー。なしの場合は `'-'`。 |
| `session_id` | `str` | `'-'` | 行が属するセッションまたは会話。なしの場合は `'-'`。 |
| `run_id` | `str` | `'-'` | この decision が行われた run（run.begin）。 |
| `category` | `str` | 必須 | category と scenario で decision が識別されます。同じ scenario を再度決定すると、以前の記録は置き換えられます（履歴には残ります）。 |
| `scenario` | `str` | 必須 | 決定が必要だった状況。`decision.precedents` はクエリを decision の statement と照合し、statement は scenario で始まります。 |
| `reasoning` | `str` | 必須 | この結果を選んだ理由。 |
| `outcome` | `str` | 必須 | 決定した内容。 |
| `alternatives` | `list[str]` | *（算出）* | 検討したが選ばれなかったもの。「なぜ X ではないのか」という質問に必要でありながら、多くの decision ログに欠けているフィールドです。 |
| `confidence` | `float` | `0.0` | 決定者の確信度（0〜1）。0 は記録なしを意味します（その場合、メモリ行とエッジは 1.0 を持ちます）。 |
| `stage` | `Literal['decided', 'proposed']` | `'decided'` | "decided"（デフォルト）、または、まだ選ばれても実装されてもいない案（提案、計画、アクションアイテム）を示す "proposed"。memory.set の `proposed`（検証中の事実）とは無関係です。 |
| `decision_maker` | `str` | `''` | 決定した人またはエージェント。"" の場合は呼び出し元の `agent` を記録します。 |
| `caused_by` | `list[str]` | *（算出）* | この decision の原因となった、または影響を与えた memory_key（decision、事実、手順）。それぞれが、この呼び出しを根拠とする作成済みエッジ（memory.link）になります。 |
| `influenced_by` | `list[str]` | *（算出）* | 原因とはならずに decision を形作ったキー。それぞれが `influenced` エッジになります。 |
| `tags` | `list[str]` | *（算出）* | `decision` と `decision:category:<category>` に加えて、メモリ行に付ける追加のタグ。ここに `decision:proposed` タグを指定しても無視されます（`stage` で設定してください）。 |
| `valid_at` | `datetime \| None` | `None` | decision が有効になった実世界の時刻。None の場合は現在。 |
| `files` | `list[str] \| None` | `None` | この decision が適用されるリポジトリのファイル（リポジトリ相対パスまたはファイル名のみ）。memory.for_file は、それらのファイルを編集する前にこの decision を返します。 |
| `source_class` | `Literal['derived', 'external', 'imported'] \| None` | `None` | この decision が他のコンテンツから導出された（`derived`）、または外部から来た（`external`、`imported`）ことを宣言します。 |
| `source_resource_id` | `str` | `''` | この decision の取得元のファイルパス、ドキュメント ID または URL。ヒットに引用されます。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `memory_key` | `str` | category + scenario から導出される decision のキー。`decision.outcome` と `decision.chain` に渡します。 |
| `record_id` | `str` | 書き込まれた `decision` レコードバージョンの ID。 |
| `superseded_prior` | `bool` | 同じ category + scenario の有効な decision が存在し、今回の decision に置き換えられた場合は True。 |
| `edges_written` | `int` | 書き込まれた `caused` / `influenced` エッジの数。リンクに失敗したものはスキップされます。 |
| `next` | `str` | 後続の操作を示すプレーンテキストのヒント。 |

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