콘텐츠로 이동

번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.

이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.

decision 오퍼레이션

각 decision.* 오퍼레이션이 받고 반환하는 정확한 필드입니다.

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

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 엣지를 따라 도달한 모든 키. 각각 한 번씩만 나오며 가까운 홉부터 정렬됩니다.

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)을 통해 점수가 부여된 메모리 수입니다.

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 내부 메모리 검색에서 사용한 임베더입니다.

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 후속 작업을 안내하는 일반 텍스트 힌트입니다.