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

<!-- i18n: source=docs/reference/operations/memory_schema.md blob=7c1e29147620aa0eb8e394ad2da9710d2e44ca26 model=claude-sonnet-5-5 -->
> このページは[英語の原文](https://clickhouse.github.io/loom/reference/operations/memory_schema/)の機械翻訳です。内容は英語の原文が優先されます。
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/memory_schema/), which is authoritative.

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

# `memory_schema` オペレーション

各 `memory_schema.*` オペレーションが受け取るフィールドと返すフィールドの詳細です。

<!-- 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 が使われ、[一部のオペレーション](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)を参照してください。ロール、種別、MCP の `all` 一覧については[オペレーション一覧](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)で説明しています。未知の入力フィールドは処理され、`ignored_args` に名前が示されます。

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

<a id="memory_schemaapprove"></a>

## `memory_schema.approve`

提案されたレコードスキーマを承認（有効化）または却下します。

`POST /v1/memory_schema.approve` · MCP `loom_memory_schema_approve` · ロール `admin` · 書き込み · 監査対象 · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | オペレーションが読み書きする名前空間。 |
| `name` | `str` | 必須 | 判定対象のスキーマ名。 |
| `decision` | `Literal['approve', 'reject']` | 必須 | `approve` はスキーマを `active` にし、`reject` は `rejected` にします。 |
| `reviewed_by` | `str` | `''` | レビュアーのフォールバック。リクエストに記録できるプリンシパルがない場合にのみ保存されます。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `name` | `str` | スキーマ名（入力のエコー）。 |
| `status` | `str` | 保存された現在のステータス（`active` または `rejected`）。その名前のスキーマがない場合は空です。 |
| `updated` | `bool` | その名前のスキーマがなく、何も書き込まれなかった場合は False。 |

<a id="memory_schemalist"></a>

## `memory_schema.list`

名前空間のレコードスキーマを一覧表示します。`include_proposed` を指定しない限り、有効なものだけを返します。

`POST /v1/memory_schema.list` · MCP `loom_memory_schema_list` · ロール `viewer` · 読み取り · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | オペレーションが読み書きする名前空間。 |
| `include_proposed` | `bool` | `False` | False では `active` のスキーマのみ、True では廃棄されていないすべてのステータスのスキーマを返します。 |
| `limit` | `int` | `100` | 返すスキーマの最大数（1～500）。名前順です。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `schemas` | `list[MemorySchemaSummary]` | 名前空間のスキーマとそのフィールド。名前順です。 |

<a id="memory_schemapropose"></a>

## `memory_schema.propose`

レコードスキーマを `proposed` として登録し、管理者による承認または却下を待ちます。

`POST /v1/memory_schema.propose` · MCP `loom_memory_schema_propose` · ロール `writer` · 書き込み · 監査対象 · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | オペレーションが読み書きする名前空間。 |
| `name` | `str` | 必須 | スキーマの名前。memory.record.write とクエリはこの名前でスキーマを指定します。 |
| `description` | `str` | `''` | スキーマとともに保存され、memory_schema.list が返す自由記述のテキスト。 |
| `fields` | `list[SchemaFieldInput]` | 必須 | フィールドの定義（1～64）。不正な型、制約、パターンは登録時に拒否されます。 |
| `created_by` | `str` | `''` | 作成者のフォールバック。リクエストに記録できるプリンシパルがない場合にのみ保存されます。 |
| `status` | `Literal['active', 'proposed']` | `'active'` | `active` はすぐに書き込み可能になり、`proposed` は memory_schema.approve を待ちます。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `schema_id` | `str` | 新しいスキーマの ID。登録呼び出しのたびに新しい ID が発行されます。 |
| `name` | `str` | スキーマ名（入力のエコー）。 |
| `field_count` | `int` | スキーマが宣言するフィールドの数。 |
| `status` | `str` | 保存時のステータス（`active` または `proposed`）。 |

<a id="memory_schemaregister"></a>

## `memory_schema.register`

名前空間に型付きレコードのスキーマ（名前付きフィールド）を登録します。型付きレコードはこのスキーマに対して書き込まれます。

`POST /v1/memory_schema.register` · MCP `loom_memory_schema_register` · ロール `admin` · 書き込み · 監査対象

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | オペレーションが読み書きする名前空間。 |
| `name` | `str` | 必須 | スキーマの名前。memory.record.write とクエリはこの名前でスキーマを指定します。 |
| `description` | `str` | `''` | スキーマとともに保存され、memory_schema.list が返す自由記述のテキスト。 |
| `fields` | `list[SchemaFieldInput]` | 必須 | フィールドの定義（1～64）。不正な型、制約、パターンは登録時に拒否されます。 |
| `created_by` | `str` | `''` | 作成者のフォールバック。リクエストに記録できるプリンシパルがない場合にのみ保存されます。 |
| `status` | `Literal['active', 'proposed']` | `'active'` | `active` はすぐに書き込み可能になり、`proposed` は memory_schema.approve を待ちます。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `schema_id` | `str` | 新しいスキーマの ID。登録呼び出しのたびに新しい ID が発行されます。 |
| `name` | `str` | スキーマ名（入力のエコー）。 |
| `field_count` | `int` | スキーマが宣言するフィールドの数。 |
| `status` | `str` | 保存時のステータス（`active` または `proposed`）。 |

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