> Source: https://clickhouse.github.io/loom/ja/reference/operations/context/ (Markdown: https://clickhouse.github.io/loom/ja/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. -->

すべてのオペレーションは、HTTP では `POST /v1/<op>`、MCP ツールでは `loom_<op>` として呼び出せます。ID フィールド（`org`、`namespace`、`agent`、`user_id`、`session_id`）は、トランスポートが対応している場合、トークンと MCP セッションから補完されます。シングルユーザーサーバーでトークンなしの HTTP 呼び出しを行う場合、`code.*` と `tracker.*` 以外のすべてのオペレーションではインストールの org が使われ（この 2 つはそれぞれのプレーンの org を維持します）、[一部のオペレーション](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)では名前空間とエージェントも補完されます。詳しくは[ID と名前空間](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)を参照してください。ロール、種別、MCP の `all` 一覧については、[オペレーション一覧](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)で説明しています。未知の入力フィールドは受け付けられ、`ignored_args` に名前が記録されます。

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

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

## `context.fetch`

パークされた結果をキーで読み戻します。文字単位のスライス（offset/limit）か、正規表現（pattern、context_lines 付き）に一致する行のみを取得できます。

`POST /v1/context.fetch` · MCP `loom_context_fetch` · ロール `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 回の呼び出しで返す内容の最大文字数（1-64000）。 |
| `pattern` | `str` | `''` | 正規表現（RE2 構文、大文字小文字を区別しない。後方参照と先読み・後読みは不可）。 |
| `context_lines` | `int` | `0` | `pattern` 指定時に、各一致の前後に表示するコンテキスト行数（0-10）。コンテキスト行には `lineno-`、一致行には `lineno:` が付きます。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `found` | `bool` | 名前空間内にこのキーを持つ有効で期限切れでないブロブがない場合は false。 |
| `blob_key` | `str` | 入力の `blob_key` のエコー。 |
| `content` | `str` | 文字スライス。`pattern` 指定時は、一致した行を `lineno: text` 形式で返します。 |
| `content_type` | `str` | ブロブとともに保存されたメディアタイプ。 |
| `summary` | `str` | ブロブとともに保存された要約。 |
| `total_chars` | `int` | 保存されたコンテンツ全体の文字数。 |
| `total_lines` | `int` | 保存されたコンテンツ全体の行数。 |
| `offset` | `int` | 入力の `offset` のエコー。 |
| `next_offset` | `int` | スライス（または一致リスト）を読み尽くした場合は -1。 |
| `matched_lines` | `int` | `pattern` 指定時は、コンテンツ全体で一致した行数。それ以外は 0。 |
| `expires_at` | `datetime \| None` | ブロブが取得できなくなる時刻。見つからない場合は 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>`）になります。同じ出力を 2 回退避しても、同じキーになり、保存される行は 1 つです。 |
| `content_type` | `str` | `'text/plain'` | コンテンツとともに保存され、`context.fetch` が返すメディアタイプ。 |
| `summary` | `str` | `''` | 呼び出し側が指定する 1 行の要約（ツール名と返された内容）。 |
| `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` · ロール `viewer` · 読み取り

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（識別タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | op が読み書きする名前空間。 |
| `agent` | `str` | 必須 | 書き込みまたは読み取りを行うエージェント。op が許す場合、`'-'` または `'*'` は任意のエージェントを意味します。 |
| `user_id` | `str` | `'-'` | パックの読み取り対象のユーザー。"-" の場合、memories、profile、procedures、runs の各セクションではすべてのユーザーを読み、stack と working-memory の各セクションではユーザーに紐づかない行を読みます。 |
| `session_id` | `str` | `'-'` | パックの読み取り対象のセッション。"-" の場合、memories セクションではすべてのセッションを読み、stack と working-memory の各セクションではセッションに紐づかない行を読みます。 |
| `run_id` | `str` | `'-'` | 呼び出しが属するエージェントの実行（タスクスコープ）。なしの場合は `'-'`。 |
| `query` | `str` | `''` | 関連するメモリやドキュメントを選ぶために使う、任意のタスクまたは質問。 |
| `situation` | `str` | `''` | 手順の照合に使う、任意の状況の説明。 |
| `procedure_explore_rate` | `float \| None` | `None` | procedures セクションの探索率。None は 0（探索しない）。 |
| `token_budget` | `int` | `2000` | レンダリングしたパック全体のサイズ上限（トークン単位、1 トークンは約 4 文字）。これより長いパックは切り詰められ、`truncated` が設定されます。 |
| `top_k` | `int` | `5` | 検索に基づく各セクションが要求するヒット数（procedures と stack のナレッジ層は上限が 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 マニフェスト。この識別情報の最近のセッションを 1 件 1 行で、新しい順に `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` | 1 つのテキストにしたパック。空でない各セクションを `<name>` タグで囲み、ブロック順に並べ、`token_budget` で切り詰めます。 |
| `sections` | `dict[str, str]` | 名前ごとの各セクションの本文（ブロック順）。何もレンダリングされなかったセクションは含まれません。 |
| `blocks` | `list[ContextBlock]` | 空でないセクションごとに 1 エントリ：ラベル、本文、トークン推定値、引用、ソース数、`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`（小数第 3 位まで）。 |
| `stable_sections` | `list[str]` | `rendered` の先頭から続く、`query` や `situation` に依存しない部分。この識別情報のワーキングメモリ、プロフィール、ピンが変わるまで、どの質問に対しても同じバイト列になります。 |
| `stable_prefix_chars` | `int` | `rendered` のその先頭部分の文字数。最初のセクションがクエリに依存する場合は 0。 |
| `stable_hash` | `str` | 安定した先頭部分の SHA-256。`stable_prefix_chars` が 0 の場合は空。 |
| `procedure_keys` | `list[str]` | パックがエージェントに提示した手順：ユーティリティが必要とする台帳の「提示した」側。 |
| `procedure_keys_withheld` | `list[str]` | パックが一致と判定したうえで、意図的に提示しなかった手順：同じ台帳の「提示しなかった」側。 |

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