> Source: https://clickhouse.github.io/loom/ko/reference/operations/decision/ (Markdown: https://clickhouse.github.io/loom/ko/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. -->

모든 op는 HTTP에서는 `POST /v1/<op>`이고 MCP 도구로는 `loom_<op>`입니다. 신원 필드(`org`, `namespace`, `agent`, `user_id`, `session_id`)는 전송 방식이 지원하는 경우 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, `code.*`와 `tracker.*`(각자 자신의 플레인을 유지함)를 제외한 모든 op에서 설치 환경의 org가 사용되며, [일부 op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 [신원과 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)를 참고하세요. [오퍼레이션 색인](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)에서 role, kind, MCP `all` 목록을 설명합니다. 알 수 없는 입력 필드는 그대로 처리되며 `ignored_args`에 이름이 표시됩니다.

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

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

## `decision.chain`

결정의 인과 체인을 추적합니다. 작성된 그래프를 따라 최대 4홉까지 업스트림(결정을 일으켰거나 영향을 준 요소), 다운스트림(결정이 이후에 일으킨 요소), 또는 둘 다 추적합니다.

`POST /v1/decision.chain` · MCP `loom_decision_chain` · role `viewer` · 읽기 · 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` 엣지를 따라 도달한 모든 키. 각각 한 번씩만 나오며 가까운 홉부터 정렬됩니다. |

<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이면 판정을 설정하며 결정을 내린 실행의 메모리에 점수를 부여(또는 표시)합니다. |
| `agent` | `str` | `'*'` | 쓰거나 읽는 에이전트입니다. `'-'` 또는 `'*'`는 op가 허용하는 경우 모든 에이전트를 의미합니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `memory_key` | `str` | 결정의 키이며, 입력값을 그대로 반환합니다. |
| `updated` | `bool` | 항상 true입니다. 결정이 없으면 404로 응답합니다. |
| `memories_credited` | `int` | 실행 원장(run.complete memories_used)을 통해 점수가 부여된 메모리 수입니다. |

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

## `decision.precedents`

결정을 내리기 전에, 비슷한 상황에서 무엇을 결정했는지 확인합니다. 과거 결정을 대상으로 한 시맨틱 검색(선택적으로 카테고리 내)이며, 각 결과에는 근거, 기각된 대안, 그리고 알려진 경우…

`POST /v1/decision.precedents` · MCP `loom_decision_precedents` · role `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` | 필수 | 테넌트(식별 튜플의 첫 번째 요소)입니다. |
| `namespace` | `str` | 필수 | 이 op가 읽거나 쓰는 네임스페이스입니다. |
| `agent` | `str` | 필수 | 쓰거나 읽는 에이전트입니다. op가 허용하는 경우 `'-'` 또는 `'*'`는 모든 에이전트를 뜻합니다. |
| `user_id` | `str` | `'-'` | 행이 속한 최종 사용자입니다. 없으면 `'-'`입니다. |
| `session_id` | `str` | `'-'` | 행이 속한 세션 또는 대화입니다. 없으면 `'-'`입니다. |
| `run_id` | `str` | `'-'` | 이 결정을 내린 run입니다(run.begin). |
| `category` | `str` | 필수 | category + scenario가 결정을 식별합니다. 같은 scenario를 다시 결정하면 이전 기록을 대체합니다(이력에는 남습니다). |
| `scenario` | `str` | 필수 | 결정이 필요했던 상황입니다. `decision.precedents`는 쿼리를 결정의 설명문과 대조하며, 설명문은 scenario로 시작합니다. |
| `reasoning` | `str` | 필수 | 이 결과를 선택한 이유입니다. |
| `outcome` | `str` | 필수 | 결정된 내용입니다. |
| `alternatives` | `list[str]` | *(계산됨)* | 검토했지만 선택하지 않은 대안입니다. 모든 "왜 X는 안 되나" 질문에 필요하지만 대부분의 결정 로그에서 빠져 있는 필드입니다. |
| `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]` | *(계산됨)* | 이 결정을 유발했거나 영향을 준 memory_key(결정, 사실, 절차)입니다. 각 키는 이 호출을 근거로 하는 작성된 엣지(memory.link)가 됩니다. |
| `influenced_by` | `list[str]` | *(계산됨)* | 결정을 유발하지는 않았지만 형성에 영향을 준 키입니다. 각 키는 `influenced` 엣지가 됩니다. |
| `tags` | `list[str]` | *(계산됨)* | `decision` 및 `decision:category:<category>`와 함께 메모리 행에 붙는 추가 태그입니다. 여기에 넣은 `decision:proposed` 태그는 제거됩니다(`stage`로 설정하세요). |
| `valid_at` | `datetime \| None` | `None` | 결정이 효력을 갖게 된 실제 시각입니다. None이면 현재입니다. |
| `files` | `list[str] \| None` | `None` | 이 결정이 적용되는 저장소 파일입니다(저장소 상대 경로 또는 파일 이름만). memory.for_file이 해당 파일을 편집하기 전에 이 결정을 제공합니다. |
| `source_class` | `Literal['derived', 'external', 'imported'] \| None` | `None` | 이 결정이 다른 콘텐츠에서 파생되었는지(`derived`) 외부에서 왔는지(`external`, `imported`) 선언합니다. |
| `source_resource_id` | `str` | `''` | 이 결정의 출처가 된 파일 경로, 문서 id 또는 URL입니다. 검색 결과에 인용됩니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `memory_key` | `str` | category + scenario에서 만들어지는 결정의 키입니다. `decision.outcome`과 `decision.chain`에 전달하세요. |
| `record_id` | `str` | 기록된 `decision` 레코드 버전의 id입니다. |
| `superseded_prior` | `bool` | 같은 category + scenario의 활성 결정이 있었고 이번 결정으로 대체된 경우 True입니다. |
| `edges_written` | `int` | 기록된 `caused` / `influenced` 엣지 수입니다. 링크에 실패하면 건너뜁니다. |
| `next` | `str` | 후속 작업을 안내하는 일반 텍스트 힌트입니다. |

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