콘텐츠로 이동

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

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

procedure 연산

각 procedure.* 연산이 받고 반환하는 정확한 필드입니다.

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

procedure.add

절차 메모리를 등록합니다. 구조화된 (name, situation, steps) 필드로 이루어진 'X를 하는 방법' 레시피입니다.

POST /v1/procedure.add · MCP loom_procedure_add · 역할 writer · 쓰기

입력 필드 타입 기본값 의미
org str 필수 테넌트(ID 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
user_id str '-' 행이 속한 최종 사용자입니다. 없으면 '-'입니다.
session_id str '-' 행이 속한 세션 또는 대화입니다. 없으면 '-'입니다.
name str 필수 절차 이름입니다. 메모리 키는 procedure_<slug of name>이므로 같은 이름이면 덮어씁니다.
situation str 필수 절차가 적용되는 상황(전제 조건)입니다. 이 텍스트가 procedure.match를 좌우합니다.
steps list[str] 필수 최소 두 개가 필요합니다. 단계가 하나뿐이면 절차가 아니라 교훈입니다(마이너도 같은 기준을 적용합니다).
tags list[str] (계산됨) 절차에 저장되는 호출자 태그입니다. 행에는 태그 procedure도 추가됩니다.
metadata dict[str, Any] (계산됨) 선택적 구조화 메타데이터입니다(키-값 형태의 전제 조건, 기대 출력 등).
graph dict[str, Any] \| None None 선택적 실행 가능 그래프입니다(노드 = 단계 / 메모리 / 통합 / 결정, 엣지 = dep / dataflow / branch).
출력 필드 타입 의미
memory_key str 절차 행의 키입니다(procedure_<slug>).
memory_id str 기록된 메모리 버전의 ID입니다.
version int 기록된 행의 버전 번호입니다.

procedure.evolve

프로시저에 누적된 실행 트레이스를 개선된 그래프로 통합합니다. 성공한 순회 횟수를 기준으로 검증된 경로의 순위를 매기고, 어떤 실행에서도 사용되지 않은 단계는 막다른 길로 표시하며, 위치한 단계와 전이도 표시합니다…

POST /v1/procedure.evolve · MCP loom_procedure_evolve · role writer · write · MCP all 툴셋에는 포함되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트입니다(식별 튜플의 첫 번째 요소).
namespace str 필수 이 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
user_id str '-' 행이 속한 최종 사용자입니다. 없으면 '-'입니다.
session_id str '-' 행이 속한 세션 또는 대화입니다. 없으면 '-'입니다.
memory_key str 필수 발전시킬 프로시저의 키입니다(procedure_<slug>).
min_runs int 3 가지치기가 근거에 따라 동작하기 전에 반영되어야 하는 최소 실행 횟수입니다.
gate_mode Literal['sprt', 'margin'] 'sprt' 보류 중인 리비전에 대한 수락 게이트입니다.
gate_min_runs int 3 어떤 판정이든 내리기 전에 검증 중인 리비전에서 필요한 실행 횟수입니다.
gate_margin float 0.05 margin 모드: 되돌림을 일으키는 성공률 하락폭입니다.
gate_min_drop float 0.15 sprt 모드: 되돌릴 만한 하락폭, 오류율, 그리고 그 실행 횟수를 넘으면 점추정값이 결정하는 기준입니다.
gate_alpha float 0.05 sprt 모드: 잘못 되돌릴 오류율입니다. 낮을수록 되돌리기 전에 더 많은 근거가 필요합니다.
gate_beta float 0.2 sprt 모드: 하락을 놓칠 오류율입니다. 낮을수록 수락하기 전에 더 많은 근거가 필요합니다.
gate_max_runs int 50 sprt 모드: 이 리비전에서 이 실행 횟수에 도달하면 점추정값이 결정합니다.
strike_limit int \| None None 프로시저를 격리하는 연속 실패 실행 횟수입니다. None = LOOM_PROCEDURE_STRIKE_LIMIT (3), 0 = 격리 안 함.
gate_cost_tolerance float 0.25 수락된 리비전에 대한 비용 동점 처리: 성공한 실행의 비용이 이전 리비전보다 이 비율을 초과하여 높으면 되돌립니다(소요 시간, 단계 수, 토큰 중 양쪽이 모두 보고하는 첫 번째 항목). 허용치와 정확히 같은 경우는 이 조건을 충족하지 않습니다. 양쪽 모두 gate_cost_min_samples만큼의 비용이 기록된 성공 실행이 필요합니다…
gate_cost_min_samples int \| None None 비용 확인을 위해 각 쪽에 필요한 비용이 기록된 성공 실행 횟수입니다. None = gate_min_runs.
출력 필드 타입 의미
memory_key str 발전된 프로시저의 키입니다.
version int 이 호출이 기록한 프로시저 행의 버전입니다.
revision int 이 호출 이후 프로시저의 토폴로지 리비전입니다(되돌리면 새 리비전이 열립니다).
changed bool 이 호출이 그래프의 플래그나 격리 상태를 변경했으면 True입니다.
template bool 프로시저가 이제 재사용 가능한 템플릿이면 True입니다(안정적이고, 대체로 성공하며, 격리되지 않음).
folded_runs int 이 호출로 그래프에 반영된 원장 행의 수입니다.
gate Literal['none', 'undecided', 'accept', 'revert'] 보류 중인 리비전에 대한 수락 게이트: none(보류 중인 것 없음), undecided(아직 실행이 충분하지 않음), accept, revert.
gate_mode str 사용된 게이트 모드(sprt 또는 margin)입니다. 보류 중인 리비전이 없었으면 ""입니다.
gate_llr float sprt: 누적 로그 우도비입니다(양수이면 "리비전이 상황을 악화시켰다"를 지지). 경계를 넘으면 판정이 내려집니다.
gate_before dict[str, int] {total, ok} 이전 리비전
gate_after dict[str, int] {total, ok} 검증 중인 리비전
gate_cost_before dict[str, float] 각 쪽의 성공한 실행의 비용 중앙값, 그리고 성공 게이트를 통과한 리비전이 그래도 되돌려진 이유("cost")입니다.
gate_cost_after dict[str, float] 검증 중인 리비전에서 성공한 실행의 비용 중앙값입니다.
gate_reason str 되돌림 시 success 또는 cost, 그 외에는 ""입니다.
dead_end_steps list[str] 반영된 어떤 실행도 순회하지 않은 단계 텍스트입니다(선형 steps에서 강등됨).
fail_prone_steps list[str] 결과 대조: 실패한 실행에 불균형하게 많이 나타나는 단계 / 전이입니다(실패 비중 >= 프로시저 기본 실패율 + 마진, 충분한 실행 횟수).
fail_prone_transitions list[str] 실패한 실행에 불균형하게 많이 나타나는 전이로, src -> dst 노드 id로 표시됩니다.
run_stats dict[str, int] 이 호출 이후 프로시저에 반영된 {total, ok}입니다.
strikes int 트레이스 로그 끝에서의 연속 실패 실행 횟수, 그리고 프로시저가 아웃되었는지 여부입니다.
quarantined bool 프로시저가 아웃되어 격리되었으면 True입니다(strike_limit 참조).
retention dict[str, float] 트레이스 로그에 대한 성공 유지율: 첫 번째가 성공한 연속 실행 쌍, 그중 두 번째도 성공한 수, 그리고 비율입니다.

procedure.fork

호출자가 읽을 수 있는 네임스페이스의 프로시저를 요청 네임스페이스로 복사하고, 증거(evidence)는 초기화합니다.

POST /v1/procedure.fork · MCP loom_procedure_fork · 역할 writer · 쓰기 · 감사 대상 · MCP all 툴셋에는 포함되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 대상(요청 네임스페이스. 연산이 WRITER 권한을 강제함)
agent str '-' 쓰거나 읽는 에이전트. '-' 또는 '*'는 연산이 허용하는 경우 모든 에이전트를 의미합니다.
user_id str '-' 행이 속한 최종 사용자. 없으면 '-'.
session_id str '-' 행이 속한 세션 또는 대화. 없으면 '-'.
from_namespace str 필수 복사해 올 네임스페이스. 호출자에게 읽기 권한이 필요합니다.
from_org str '' 기본값은 org
memory_key str 필수 from_namespace에서 복사할 프로시저의 키.
new_name str '' 가져오면서 이름을 변경합니다(메모리 키는 이름에서 파생됩니다).
reason str '' 프로시저를 가져온 이유. forked_from에 저장됩니다.
출력 필드 타입 의미
memory_key str 대상 네임스페이스에 생성된 새 프로시저의 키.
version int 기록된 행의 버전.
name str 새 프로시저의 이름(new_name 또는 원본의 이름).
steps list[str] 복사된 단계.
forked_from dict[str, Any] 계보 정보: 원본 org, 네임스페이스, 키, 리비전, 다이제스트, 템플릿 플래그, 실행 통계, 포크한 사람, 이유, 시각.

procedure.list

네임스페이스에 등록된 프로시저를 나열합니다(memory_key 접두사 또는 태그로 필터링할 수 있습니다).

POST /v1/procedure.list · MCP loom_procedure_list · 역할 viewer · 읽기 · MCP all 툴셋에는 포함되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '*' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
user_id str '-' 행이 속한 최종 사용자. 없으면 '-'.
session_id str '-' 행이 속한 세션 또는 대화. 없으면 '-'.
prefix str '' 키가 procedure_ + 이 값으로 시작하는 프로시저만 반환합니다. ""이면 모두 나열합니다.
tags list[str] (계산됨) 이 태그 중 하나 이상을 가진 프로시저만 반환합니다. 비어 있으면 태그 필터가 없습니다.
limit int 50 읽을 프로시저 행의 최대 개수(서버에서 500으로 제한합니다).
출력 필드 타입 의미
procedures list[_ProcedureSummary] 네임스페이스의 프로시저(이름, 상황, 태그, 키, 생성 시각).

procedure.locate

이 절차에서 현재 어디에 있고, 다음에는 무엇이 오는가?

POST /v1/procedure.locate · MCP loom_procedure_locate · 역할 viewer · 읽기 · MCP all 툴셋에는 포함되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '*' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
user_id str '-' 행이 속한 최종 사용자. 없으면 '-'.
session_id str '-' 행이 속한 세션 또는 대화. 없으면 '-'.
memory_key str 필수 에이전트가 따르고 있는 절차의 키(procedure_<slug>).
at str '' 에이전트의 현재 위치: 노드 id 또는 가장 최근 호출의 툴 이름.
recent_path list[str] (계산됨) 이번 실행에서 에이전트가 최근에 거친 노드 id 또는 툴 이름. 오래된 것부터 나열하며 revisits와 looping에 사용됩니다.
hops int 2 앞으로 얼마나 멀리까지 보여줄지. 다음 결정에는 2면 충분하며, 더 크면 토큰이 더 듭니다.
include_notes bool True 앞쪽 전이에 대해 원장(ledger)에 있는 최근 실패 노트를 첨부합니다.
max_notes int 5 실패 노트의 최대 개수. 0이면 첨부하지 않습니다.
출력 필드 타입 의미
memory_key str 읽은 절차의 키.
name str 절차의 이름.
status Literal['template', 'exercised', 'authored', 'candidate', 'quarantined'] template, exercised, authored, candidate, quarantined 중 하나.
matched bool at(또는 recent_path의 마지막 값)이 그래프의 노드를 가리키면 True.
active dict[str, Any] \| None 에이전트가 있는 노드. 일치하지 않으면 None.
hops list[list[dict[str, Any]]] hops[0] = 한 단계 앞, hops[1] = 두 단계 앞, ... (막다른 길은 제외).
entry_nodes list[str] 일치하지 않을 때: 들어오는 간선이 없는 노드 id, 즉 절차가 시작되는 지점.
dominant_next list[str] 현재 노드에서 검증된 경로를 따라 이어지는 다음 노드 id.
revisits dict[str, int] 궤적 윈도우: 이번 실행에서 노드별 방문 횟수, 현재 노드를 다시 방문하는 중인지 여부, 그 노드에서 택하지 않은 출구.
looping bool 현재 노드가 recent_path의 앞부분에 이미 나타나면 True.
exits list[str] 루프 중일 때: 현재 노드에서 도달할 수 있으나 이번 실행에서 아직 방문하지 않은 노드 id. 그 외에는 비어 있습니다.
failure_notes list[dict[str, Any]] 앞쪽 전이에서 실패한 실행에 에이전트가 남긴 노트.
rendered str 위 내용을 결정적으로 렌더링한 텍스트로, 프롬프트에 바로 넣을 수 있습니다.
run_stats dict[str, int] 절차의 집계된 {total, ok}.
for_agent dict[str, int] 호출한 에이전트의 {total, ok}. *, -이거나 실행 기록이 없으면 비어 있습니다.

procedure.match

호출자가 설명한 상황과 situation 필드가 의미상 가장 가까운 프로시저를 찾습니다.

POST /v1/procedure.match · MCP loom_procedure_match · role viewer · read

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '*' 기본 팬아웃 — 범위 안의 모든 에이전트의 프로시저
user_id str '-' 행이 속한 최종 사용자. 없으면 '-'.
session_id str '-' 행이 속한 세션 또는 대화. 없으면 '-'.
situation str 필수 에이전트가 처한 상태. 각 프로시저에 저장된 situation과 비교됩니다.
top_k int 5 검색하는 후보의 최대 개수(1–50). 필터 때문에 더 적게 반환될 수 있습니다.
tags list[str] (계산됨) 이 태그 중 하나 이상을 가진 프로시저만 반환합니다. 비어 있으면 태그 필터를 적용하지 않습니다.
namespace_scope Literal['this', 'all_mine'] 'all_mine' all_mine은 호출자 본인의 다른 네임스페이스까지(팬아웃 상한까지) 검색하고, this는 namespace만 검색합니다.
templates_only bool False true이면 재사용 가능한 템플릿으로 승격된 프로시저(검증되고 충분히 실행된 워크플로 토폴로지)만 반환합니다.
include_candidates bool True 후보는 아직 한 번도 실행되지 않았고 사람이 작성하지도 않은 프로시저입니다.
include_quarantined bool False 격리된 프로시저(최근 strike_limit번의 실행이 모두 실패한 경우)는 요청하지 않으면 제외되며, 포함할 때는 표시와 함께 맨 마지막에 반환됩니다.
recent_tools list[str] (계산됨) 에이전트가 이 작업에서 최근 호출한 도구.
tool_boost float 0.2 통합 score에서 tool_overlap이 차지하는 가중치. 0이면 recent_tools를 무시합니다.
utility_weight float \| None None 통합 점수에서 원장(ledger)에서 파생된 유용성 항의 가중치: score = similarity + tool_boost*overlap + weight * ((ok+1)/(total+2) - 0.5).
goal str \| None None 에이전트가 처한 상태와는 구별되는, 에이전트가 추구하는 목표.
출력 필드 타입 의미
matches list[_ProcedureMatch] 일치하는 프로시저. 상태 티어(후보와 격리된 항목이 마지막), 그다음 score 순으로 정렬됩니다.
matched int 원장에 기록되는 적중률 — 일치한 개수, 최상위 프로시저, 그 점수(out_matched / out_procedure_key / out_score).
procedure_key str 최상위 일치 항목의 메모리 키. 일치하는 항목이 없으면 "".
score float 최상위 일치 항목의 통합 점수. 일치하는 항목이 없으면 0.

procedure.record_run

프로시저를 한 번 실행한 결과를 보고하여 loom이 실제로 어떤 경로가 잘 동작하는지 학습할 수 있게 합니다.

POST /v1/procedure.record_run · MCP loom_procedure_record_run · 역할 writer · 쓰기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
user_id str '-' 행이 속한 최종 사용자. 없으면 '-'.
session_id str '-' 행이 속한 세션 또는 대화. 없으면 '-'.
memory_key str 필수 실행한 프로시저의 키(procedure_<slug>).
path list[str] (계산됨) 에이전트가 이번 실행에서 실제로 방문한 노드 id를 순서대로 나열한 목록.
ok bool True 실행이 성공했는지 여부.
note str '' 실행에 대한 자유 형식 메모(실패한 이유 등). procedure.locate는 실패한 실행의 메모를 보여 줍니다.
ts str '' 저장되지 않음: 원장이 각 실행에 서버 시간을 기록합니다.
steps_taken int \| None None 실행에 든 비용.
duration_ms int 0 실행에 걸린 시간(밀리초). 0은 알 수 없음을 의미합니다.
tokens int 0 실행에 사용한 토큰 수. 0은 알 수 없음을 의미합니다.
출력 필드 타입 의미
memory_key str 실행이 기록된 프로시저의 키.
version int 항상 0: 실행은 원장에 기록되며 프로시저 행은 다시 쓰이지 않습니다.
run_stats dict[str, int] 이번 실행을 포함한 {total, ok, unfolded}. unfolded는 procedure.evolve가 아직 반영하지 않은 원장 실행의 수입니다.

procedure.revise

프로시저의 수정된 토폴로지를 제안합니다. 사용자가 정제자(refiner) 역할을 맡습니다.

POST /v1/procedure.revise · MCP loom_procedure_revise · 역할 writer · 쓰기 · 감사됨 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
user_id str '-' 해당 행이 속한 최종 사용자입니다. 없으면 '-'입니다.
session_id str '-' 해당 행이 속한 세션 또는 대화입니다. 없으면 '-'입니다.
memory_key str 필수 수정할 프로시저의 키입니다(procedure_<slug>).
graph dict[str, Any] 필수 제안하는 토폴로지입니다(전체 그래프. 변경되지 않은 노드는 id를 그대로 유지하여 통계가 이어집니다).
reason str '' 수정 이유입니다. 실패한 실행에서 드러난 점과 이번 수정이 바꾸는 내용을 적습니다.
force bool False 게이트가 이미 거부한 토폴로지라도 그대로 제안합니다.
출력 필드 타입 의미
memory_key str 수정된 프로시저의 키입니다.
version int 이번 호출이 기록한 프로시저 행의 버전입니다.
revision int 새 리비전 번호입니다. 이후 기록되는 실행은 이 리비전에 집계됩니다.
prior_revision int 이 리비전이 대체하는 이전 리비전입니다(게이트가 되돌리면 복원됩니다).
digest str 제안된 토폴로지의 해시입니다. 게이트가 거부된 토폴로지를 알아보는 데 사용합니다.
steps list[str] 새 그래프에서 도출한 선형 단계 목록입니다.