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

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

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

# `profile_schema` 操作

各 `profile_schema.*` 操作が受け取るフィールドと返すフィールドの詳細です。

<!-- 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>` で呼び出せます。ID フィールド（`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) では名前空間とエージェントも補完されます。詳しくは [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="profile_schemaclear"></a>

## `profile_schema.clear`

スキーマを削除します。名前空間のプロファイルは構築も再構築もされなくなり、読み取りは `no_schema` を返します。

`POST /v1/profile_schema.clear` · MCP `loom_profile_schema_clear` · ロール `admin` · 冪等 · 監査対象 · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | op が読み書きする名前空間。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `found` | `bool` | 名前空間にプロファイルスキーマがない場合は False。 |
| `json_schema` | `dict[str, Any]` | 管理者が設定したスキーマ（キーの順序も設定どおり）。見つからない場合は {}。 |
| `schema_sha256` | `str` | スキーマの properties（title や順序は含まない）の SHA-256。各プロファイルがこの値を参照します。 |
| `updated_by` | `str` | 最後にスキーマを設定または削除したアクター（`human:<subject>` または `process:<subject>`）。見つからない場合、または単一ユーザーに絞られたトークンの場合は空。 |
| `updated_at` | `datetime \| None` | 最後に設定または削除された日時。見つからない場合は None。 |

<a id="profile_schemaget"></a>

## `profile_schema.get`

名前空間のプロファイルスキーマ、そのハッシュ、設定者と設定日時を返します。

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

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | op が読み書きする名前空間。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `found` | `bool` | 名前空間にプロファイルスキーマがない場合は False。 |
| `json_schema` | `dict[str, Any]` | 管理者が設定したスキーマ（キーの順序も設定どおり）。見つからない場合は {}。 |
| `schema_sha256` | `str` | スキーマの properties（title や順序は含まない）の SHA-256。各プロファイルがこの値を参照します。 |
| `updated_by` | `str` | 最後にスキーマを設定または削除したアクター（`human:<subject>` または `process:<subject>`）。見つからない場合、または単一ユーザーに絞られたトークンの場合は空。 |
| `updated_at` | `datetime \| None` | 最後に設定または削除された日時。見つからない場合は None。 |

<a id="profile_schemaset"></a>

## `profile_schema.set`

名前空間のプロファイルスキーマを設定します。

`POST /v1/profile_schema.set` · MCP `loom_profile_schema_set` · ロール `admin` · 冪等 · 監査対象 · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | op が読み書きする名前空間。 |
| `json_schema` | `dict[str, Any]` | 必須 | 1〜64 個の `properties` を持つ JSON Schema オブジェクト。各プロパティには `type` と `description` が必要です（最大 16 KiB）。名前空間のスキーマを置き換え、properties が変更されるとすべてのプロファイルが古い状態になります。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `found` | `bool` | 名前空間にプロファイルスキーマがない場合は False。 |
| `json_schema` | `dict[str, Any]` | 管理者が設定したスキーマ（キーの順序も設定どおり）。見つからない場合は {}。 |
| `schema_sha256` | `str` | スキーマの properties（title や順序は含まない）の SHA-256。各プロファイルがこの値を参照します。 |
| `updated_by` | `str` | 最後にスキーマを設定または削除したアクター（`human:<subject>` または `process:<subject>`）。見つからない場合、または単一ユーザーに絞られたトークンの場合は空。 |
| `updated_at` | `datetime \| None` | 最後に設定または削除された日時。見つからない場合は None。 |

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