콘텐츠로 이동

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

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

context 작업

각 context.* 작업이 받고 반환하는 정확한 필드입니다.

모든 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에 이름이 표시됩니다.

context.fetch

보관된 결과를 키로 다시 읽습니다. 문자 단위 슬라이스(offset/limit)를 읽거나, 정규식과 일치하는 줄만(pattern, context_lines 사용) 읽을 수 있습니다.

POST /v1/context.fetch · MCP loom_context_fetch · role viewer · 읽기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str 필수 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
user_id str '-' 해당 행이 속한 최종 사용자입니다. 없으면 '-'입니다.
session_id str '-' 해당 행이 속한 세션 또는 대화입니다. 없으면 '-'입니다.
run_id str '-' 호출이 속한 에이전트 실행(작업 범위)입니다. 없으면 '-'입니다.
blob_key str 필수 context.offload가 반환한 키입니다.
offset int 0 슬라이스를 시작할 문자 오프셋입니다. pattern과 함께 쓰면 건너뛸 일치 항목 수입니다.
limit int 4000 호출당 최대 문자 수입니다(1-64000).
pattern str '' 정규식입니다(RE2 문법, 대소문자 구분 안 함, 역참조와 lookaround 불가).
context_lines int 0 pattern과 함께 쓰면 각 일치 항목 주변에 표시할 문맥 줄 수입니다(0-10). 문맥 줄은 lineno-, 일치 줄은 lineno:로 번호가 붙습니다.
출력 필드 타입 의미
found bool 네임스페이스에 이 키를 가진 유효하고 만료되지 않은 blob이 없으면 false입니다.
blob_key str 입력한 blob_key를 그대로 반환합니다.
content str 문자 슬라이스입니다. pattern을 쓰면 일치하는 줄이 lineno: text 형식으로 담깁니다.
content_type str blob과 함께 저장된 미디어 타입입니다.
summary str blob과 함께 저장된 요약입니다.
total_chars int 저장된 전체 내용의 문자 수입니다.
total_lines int 저장된 전체 내용의 줄 수입니다.
offset int 입력한 offset을 그대로 반환합니다.
next_offset int 슬라이스(또는 일치 목록)를 모두 읽었으면 -1입니다.
matched_lines int pattern을 쓰면 전체 내용에서 일치하는 줄 수이고, 그렇지 않으면 0입니다.
expires_at datetime \| None blob을 더 이상 가져올 수 없게 되는 시각입니다. 찾지 못하면 None입니다.

context.offload

큰 도구 결과(로그, 페이지, diff, 쿼리 출력)를 모델 컨텍스트 밖에 보관합니다.

POST /v1/context.offload · MCP loom_context_offload · 역할 writer · 멱등 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str 필수 쓰기 또는 읽기를 수행하는 에이전트. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 의미합니다.
user_id str '-' 행이 속한 최종 사용자. 없으면 '-'.
session_id str '-' 행이 속한 세션 또는 대화. 없으면 '-'.
run_id str '-' 호출이 속한 에이전트 실행(태스크 범위). 없으면 '-'.
content str 필수 보관할 텍스트. LOOM_CONTEXT_OFFLOAD_MAX_BYTES(UTF-8 바이트)보다 크면 413이 반환됩니다.
blob_key str '' 비어 있으면 콘텐츠 주소 지정 방식(blob/<sha256 prefix>)을 사용합니다. 같은 출력을 두 번 보관해도 같은 키가 생성되고 저장되는 행은 하나입니다.
content_type str 'text/plain' 콘텐츠와 함께 저장되며 context.fetch가 반환하는 미디어 타입.
summary str '' 호출자가 제공하는 한 줄 요약(도구 이름과 반환된 내용).
ttl_seconds int 604800 blob을 가져올 수 있는 기간(초). 1분에서 90일까지입니다.
출력 필드 타입 의미
blob_key str 콘텐츠를 가져올 때 사용하는 키. 지정한 키 또는 blob/<sha256 prefix>입니다.
content_bytes int 저장된 콘텐츠의 크기(UTF-8 바이트).
content_chars int 저장된 콘텐츠의 길이(문자 수).
sha256 str 콘텐츠의 SHA-256 16진수 다이제스트.
summary str blob과 함께 저장된 요약. 지정한 요약 또는 콘텐츠의 처음 200자입니다.
expires_at datetime blob을 더 이상 가져올 수 없게 되는 시점.
pointer str 트랜스크립트에서 콘텐츠를 대신할 수 있도록 준비된 포인터.

context.pack

작업에 필요한 메모리, 결정, 절차: Loom 훅이 이미 이 세션에 Loom 컨텍스트를 넣어 두었다면 예외이고, 그렇지 않으면 각 작업의 처음에 가장 먼저 호출하세요.

POST /v1/context.pack · MCP loom_context_pack · role viewer · read

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 이 op가 읽거나 쓰는 네임스페이스.
agent str 필수 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
user_id str '-' 팩이 읽는 대상 사용자. "-"는 memories, profile, procedures, runs 섹션에서는 모든 사용자를 읽고, 스택 및 작업 메모리 섹션에서는 사용자에 속하지 않은 행을 읽습니다.
session_id str '-' 팩이 읽는 대상 세션. "-"는 memories 섹션에서는 모든 세션을 읽고, 스택 및 작업 메모리 섹션에서는 세션에 속하지 않은 행을 읽습니다.
run_id str '-' 호출이 속한 에이전트 실행(작업 범위). 없으면 '-'.
query str '' 관련 메모리와 문서를 고르는 데 쓰는 선택적 작업/질문.
situation str '' 절차를 매칭하는 데 쓰는 선택적 상황 설명.
procedure_explore_rate float \| None None procedures 섹션의 탐색 비율. None = 0(탐색 안 함).
token_budget int 2000 렌더링된 전체 팩의 토큰 단위 크기 상한(토큰당 약 4자). 더 긴 팩은 잘리고 truncated가 설정됩니다.
top_k int 5 검색 기반 섹션이 각각 요청하는 결과 수(procedures와 스택의 지식 계층은 최대 5개).
read_scope Literal['namespace', 'own_user', 'own_session'] 'namespace' memory.search.read_scope와 의미가 같으며, 이 op의 user_id / session_id에 바인딩됩니다.
mode Literal['startup', 'task', 'debug', 'handoff'] 'task' 섹션 예산과 검색 방식. 어떤 모드에서도 LLM 호출은 없습니다. startup(빠른 회상, query가 없으면 핀과 최근 메모리를 제공), task와 handoff(균형), debug(품질).
include_knowledge bool False 일치하는 문서 청크로 구성된 knowledge 섹션을 추가합니다. query가 필요합니다.
include_conversations bool False 일치하는 과거 메시지로 구성된 conversations 섹션을 추가합니다. query가 필요합니다.
include_runs bool False runs 매니페스트. 이 식별자의 최근 세션마다 한 줄(날짜, 실행 상태와 목표, 종류별 도구 호출과 오류, 건드린 파일, 요약)을 최신순으로 runs_limit개 행까지 나열합니다.
runs_limit int 12 include_runs가 설정된 경우 runs 매니페스트에 나열할 최근 세션 수(1-50).
include_chunks bool False memories 검색의 리랭커 풀을 최근 후보 20개로 넓힙니다. 리랭커가 없으면 효과가 없습니다.
section_token_budgets dict[str, int] (계산됨) 모드의 기본값을 덮어쓰는 섹션별 토큰 예산. 섹션 이름을 키로 하며, 섹션은 80토큰보다 적게 받지 않습니다.
block_order list[str] (계산됨) 호출자가 지정하는 선택적 블록 순서.
session_block str '' 호출자 자신의 세션 북마크(session:<project>, 플러그인의 Stop 훅 노트).
only_sections list[Literal['working_memory', 'memory_stack', 'profile', 'memories', 'procedures', 'decisions', 'knowledge', 'conversations', 'runs', 'namespace_health', 'namespace_guide', 'mentor']] (계산됨) 팩을 이 섹션들로 제한합니다.
include_decisions bool True decision 타입 결과는 memories 블록에서 빠지고, 구조화된 레코드(시나리오, 결과, 실제 결과)를 담은 별도의 태그 섹션으로 렌더링됩니다.
출력 필드 타입 의미
rendered str 하나의 텍스트로 된 팩. 비어 있지 않은 각 섹션이 <name> 태그로 감싸져 블록 순서대로 들어가며, token_budget에 맞춰 잘립니다.
sections dict[str, str] 블록 순서대로 정렬된, 이름별 각 섹션의 본문. 아무것도 렌더링되지 않은 섹션은 없습니다.
blocks list[ContextBlock] 비어 있지 않은 섹션마다 하나의 항목: 라벨, 본문, 토큰 추정치, 인용, 소스 수, priority(블록 순서에서의 위치).
section_meta dict[str, dict[str, Any]] 이름별 섹션 세부 정보: 소스 수, 인용, 잘렸는지 여부, 크기, 토큰 예산, 채움 비율(1.0을 넘으면 잘렸음을 의미).
section_count int 내용이 렌더링된 섹션 수.
truncated bool 어떤 섹션이나 전체 팩이 예산에 맞춰 잘렸으면 True.
token_budget int 입력 token_budget의 에코.
mode str 입력 mode의 에코.
tokens_estimate int 예산 압박도.
fill_ratio float tokens_estimate / token_budget, 소수점 셋째 자리까지.
stable_sections list[str] rendered의 맨 앞에서 query나 situation에 의존하지 않는 연속 구간. 이 식별자의 작업 메모리, 프로필, 핀이 바뀔 때까지는 어떤 질문을 해도 동일한 바이트입니다.
stable_prefix_chars int rendered에서 그 앞부분의 문자 길이. 첫 섹션이 query에 의존하면 0.
stable_hash str 안정 접두부의 SHA-256. stable_prefix_chars가 0이면 빈 문자열.
procedure_keys list[str] 팩이 에이전트에게 보여 준 절차: 유틸리티에 필요한 원장의 "표시됨" 쪽.
procedure_keys_withheld list[str] 팩이 매칭했지만 의도적으로 보류한 절차: 같은 원장의 "표시되지 않음" 쪽.