> Source: https://clickhouse.github.io/loom/ko/reference/operations/context/ (Markdown: https://clickhouse.github.io/loom/ko/reference/operations/context.md)

<!-- i18n: source=docs/reference/operations/context.md blob=093091d1e021fa46a119227148999d3ff22b0ac2 model=claude-sonnet-5-5 -->
> 이 페이지는 [영어 원문](https://clickhouse.github.io/loom/reference/operations/context/)을 기계 번역한 것이며, 영어 원문이 기준입니다.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/context/), which is authoritative.

<a id="context-operations"></a>

# `context` 작업

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

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

모든 op는 HTTP에서는 `POST /v1/<op>`이고, MCP에서는 `loom_<op>` 도구입니다. 전송 방식이 지원하는 경우 식별 필드(`org`, `namespace`, `agent`, `user_id`, `session_id`)는 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, `code.*`와 `tracker.*`(각자 자신의 플레인을 유지함)를 제외한 모든 op에서 설치의 org가 사용되며, [일부 op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)에서는 네임스페이스와 에이전트도 채워집니다. [식별자와 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)를 참고하세요. [작업 색인](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)에서 role, kind, MCP `all` 목록을 설명합니다. 알 수 없는 입력 필드도 처리되며 `ignored_args`에 이름이 표시됩니다.

<!-- prettier-ignore-start -->

<a id="contextfetch"></a>

## `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입니다. |

<a id="contextoffload"></a>

## `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` | 트랜스크립트에서 콘텐츠를 대신할 수 있도록 준비된 포인터. |

<a id="contextpack"></a>

## `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 블록에서 빠지고, 구조화된 레코드(시나리오, 결과, 실제 결과)를 담은 별도의 태그 <decisions> 섹션으로 렌더링됩니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `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]` | 팩이 매칭했지만 의도적으로 보류한 절차: 같은 원장의 "표시되지 않음" 쪽. |

<!-- prettier-ignore-end -->
