번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. 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] |
새 그래프에서 도출한 선형 단계 목록입니다. |