번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.
working_memory 연산
각 working_memory.* 연산이 받고 반환하는 정확한 필드입니다.
모든 연산은 HTTP에서는 POST /v1/<op>이고 MCP 도구로는 loom_<op>입니다. 신원 필드(org, namespace, agent, user_id, session_id)는 전송 방식이 가능한 경우 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, code.*와 tracker.*(각자의 plane 값을 유지함)를 제외한 모든 연산에서는 설치의 org가 채워지고, 일부 연산에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 신원과 네임스페이스를 참고하세요. 연산 인덱스에서 role, kind, MCP all 목록을 설명합니다. 알 수 없는 입력 필드는 그대로 처리되며 ignored_args에 이름이 표시됩니다.
working_memory.append
워킹 메모리 블록의 끝에 텍스트를 추가하며, 블록이 없으면 새로 만듭니다.
POST /v1/working_memory.append · MCP loom_working_memory_append · role writer · write
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(identity 튜플의 첫 번째 요소). |
namespace |
str |
필수 | op가 읽거나 쓰는 네임스페이스. |
agent |
str |
필수 | 쓰거나 읽는 에이전트. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 의미합니다. |
user_id |
str |
'-' |
해당 행이 속한 최종 사용자. 없으면 '-'. |
session_id |
str |
'-' |
해당 행이 속한 세션 또는 대화. 없으면 '-'. |
run_id |
str |
'-' |
호출이 속한 에이전트 실행(작업 범위). 없으면 '-'. |
block_key |
str |
'scratchpad' |
내용을 추가할 블록. 블록이 없으면 기본 크기 제한으로 새로 만듭니다. |
addition |
str |
필수 | 블록 끝에 추가할 텍스트. |
separator |
str |
'\n' |
기존 텍스트와 addition 사이에 넣는 구분자. 블록이 새로 만들어지는 경우에는 사용되지 않습니다. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
block_key |
str |
쓰기가 수행된 블록. |
version |
int |
이번 쓰기로 생성된 행의 버전(나노초 타임스탬프). |
char_limit |
int |
쓰기 이후 블록의 크기 제한(문자 수). |
value_length |
int |
쓰기 이후 블록 내용의 길이(문자 수). |
fill_ratio |
float |
value_length / char_limit 값으로, 소수점 셋째 자리까지 표시합니다. 1.0을 넘게 되는 쓰기는 거부됩니다. |
working_memory.delete
워킹 메모리 블록 하나를 삭제합니다.
POST /v1/working_memory.delete · MCP loom_working_memory_delete · 역할 writer · 멱등 · MCP all 툴셋에는 나열되지 않음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(식별 튜플의 첫 번째 요소)입니다. |
namespace |
str |
필수 | op가 읽거나 쓰는 네임스페이스입니다. |
agent |
str |
필수 | 쓰거나 읽는 에이전트입니다. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 의미합니다. |
user_id |
str |
'-' |
행이 속한 최종 사용자입니다. 없으면 '-'입니다. |
session_id |
str |
'-' |
행이 속한 세션 또는 대화입니다. 없으면 '-'입니다. |
run_id |
str |
'-' |
호출이 속한 에이전트 실행(작업 범위)입니다. 없으면 '-'입니다. |
block_key |
str |
'scratchpad' |
삭제할 블록입니다. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
deleted |
bool |
해당 범위에 이 키의 유효한 블록이 없으면 False입니다. |
block_key |
str |
입력 block_key를 그대로 반환한 값입니다. |
working_memory.get
키로 워킹 메모리 블록 하나를 가져옵니다.
POST /v1/working_memory.get · MCP loom_working_memory_get · 역할 viewer · 읽기 · MCP all 툴셋에는 포함되지 않음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(식별 튜플의 첫 번째 요소). |
namespace |
str |
필수 | op가 읽거나 쓰는 네임스페이스. |
agent |
str |
필수 | 쓰거나 읽는 에이전트. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 의미합니다. |
user_id |
str |
'-' |
행이 속한 최종 사용자. 없으면 '-'. |
session_id |
str |
'-' |
행이 속한 세션 또는 대화. 없으면 '-'. |
run_id |
str |
'-' |
호출이 속한 에이전트 실행(작업 범위). 없으면 '-'. |
block_key |
str |
'scratchpad' |
호출자의 (agent, user, session, run) 범위 안에서 읽을 블록. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
found |
bool |
해당 범위에 이 키의 유효한 블록이 없으면 False이며, 이 경우 나머지 필드는 기본값입니다. |
block_key |
str |
블록 키를 그대로 반환한 값. |
content |
str |
블록의 텍스트. 찾지 못하면 비어 있습니다. |
char_limit |
int |
블록의 크기 상한(문자 수). 이를 넘기는 쓰기는 422로 거부됩니다. |
version |
int |
블록의 현재 행 버전(나노초 타임스탬프). 찾지 못하면 0. |
updated_at |
datetime \| None |
블록이 마지막으로 쓰인 시각. 찾지 못하면 None. |
fill_ratio |
float |
len(content) / char_limit. |
working_memory.render
워킹 메모리 블록을 XML 또는 마크다운으로 렌더링합니다. context.pack에는 이미 이 섹션이 포함되어 있으며, 직접 렌더링은 주로 SDK나 커스텀 오케스트레이션 코드에서 사용합니다.
POST /v1/working_memory.render · MCP loom_working_memory_render · role viewer · read
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(식별 튜플의 첫 번째 요소)입니다. |
namespace |
str |
필수 | op가 읽거나 쓰는 네임스페이스입니다. |
agent |
str |
필수 | 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 뜻합니다. |
user_id |
str |
'-' |
행이 속한 최종 사용자입니다. 없으면 '-'입니다. |
session_id |
str |
'-' |
행이 속한 세션 또는 대화입니다. 없으면 '-'입니다. |
run_id |
str |
'-' |
호출이 속한 에이전트 실행(작업 범위)입니다. 없으면 '-'입니다. |
block_keys |
list[str] |
(계산됨) | 지정한 블록만 대상으로 합니다(최대 20개). 비어 있으면 범위 내의 모든 활성 블록입니다. |
format |
Literal['xml', 'markdown'] |
'xml' |
xml은 각 블록을 <working-memory block=...> 태그로 감싸고, markdown은 ## <block_key> 제목 아래에 넣습니다. |
limit |
int |
20 |
block_key 순서로 최대 이 개수만큼의 블록을 반환합니다(1-100). |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
rendered |
str |
선택한 format으로 만든 하나의 텍스트입니다. 범위에 블록이 없으면 비어 있습니다. |
blocks |
list[WorkingMemoryBlock] |
렌더링된 블록과 크기 제한 및 버전 정보이며, block_key 순서입니다. |
block_count |
int |
렌더링된 블록 수입니다. |
total_chars |
int |
블록 콘텐츠 길이의 합계이며, 문자 단위입니다. |
working_memory.replace
워킹 메모리 블록 안의 정확히 일치하는 텍스트를 교체합니다.
POST /v1/working_memory.replace · MCP loom_working_memory_replace · 역할 writer · 멱등 · MCP all 툴셋에는 나열되지 않음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(식별 튜플의 첫 번째 요소)입니다. |
namespace |
str |
필수 | 이 op가 읽거나 쓰는 네임스페이스입니다. |
agent |
str |
필수 | 쓰거나 읽는 에이전트입니다. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 의미합니다. |
user_id |
str |
'-' |
행이 속한 최종 사용자입니다. 없으면 '-'입니다. |
session_id |
str |
'-' |
행이 속한 세션 또는 대화입니다. 없으면 '-'입니다. |
run_id |
str |
'-' |
호출이 속한 에이전트 실행(작업 범위)입니다. 없으면 '-'입니다. |
block_key |
str |
'scratchpad' |
편집할 블록입니다. 블록이 없으면 404입니다. |
old |
str |
필수 | 찾을 텍스트입니다. 일치하는 모든 항목이 교체되며, 텍스트가 없으면 422입니다. |
new |
str |
'' |
대체할 텍스트입니다. 비어 있으면 old와 일치하는 항목이 삭제됩니다. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
block_key |
str |
기록된 블록입니다. |
version |
int |
이 쓰기가 생성한 행의 버전입니다(나노초 타임스탬프). |
char_limit |
int |
쓰기 이후 블록의 크기 상한(문자 수)입니다. |
value_length |
int |
쓰기 이후 블록 내용의 길이(문자 수)입니다. |
fill_ratio |
float |
value_length / char_limit을 소수점 셋째 자리까지 나타낸 값입니다. 1.0을 넘게 되는 쓰기는 거부됩니다. |
working_memory.set
워킹 메모리 블록 하나를 덮어씁니다.
POST /v1/working_memory.set · MCP loom_working_memory_set · role writer · 멱등
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(식별 튜플의 첫 번째 요소). |
namespace |
str |
필수 | op가 읽거나 쓰는 네임스페이스. |
agent |
str |
필수 | 쓰거나 읽는 에이전트. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 의미합니다. |
user_id |
str |
'-' |
행이 속한 최종 사용자. 없으면 '-'. |
session_id |
str |
'-' |
행이 속한 세션 또는 대화. 없으면 '-'. |
run_id |
str |
'-' |
호출이 속한 에이전트 실행(작업 범위). 없으면 '-'. |
block_key |
str |
'scratchpad' |
쓸 블록. 호출자의 (agent, user, session, run) 범위 안에서 지정합니다. |
content |
str |
'' |
기존 내용을 대체할 블록의 전체 새 텍스트. 비어 있으면 빈 블록을 저장합니다. |
char_limit |
int |
4096 |
블록의 크기 상한(문자 수). 이보다 긴 content는 422로 거부됩니다. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
block_key |
str |
쓰기가 수행된 블록. |
version |
int |
이 쓰기로 생성된 행의 버전(나노초 타임스탬프). |
char_limit |
int |
쓰기 이후 블록의 크기 상한(문자 수). |
value_length |
int |
쓰기 이후 블록 내용의 길이(문자 수). |
fill_ratio |
float |
value_length / char_limit, 소수점 셋째 자리까지. 1.0을 넘는 쓰기는 거부됩니다. |