未翻訳のページは英語で開き、英語と表示されます。
このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 Machine-translated from the English page, which is authoritative.
profile_schema 操作
各 profile_schema.* 操作が受け取るフィールドと返すフィールドの詳細です。
すべての op は HTTP の POST /v1/<op> と MCP ツール loom_<op> で呼び出せます。ID フィールド(org、namespace、agent、user_id、session_id)は、トランスポートが対応している場合にトークンと MCP セッションから補完されます。シングルユーザーのサーバーでトークンなしに HTTP 呼び出しを行う場合は、code.* と tracker.*(それぞれのプレーンの値を保持します)を除くすべての op でインストールの org が補完され、一部の op では名前空間とエージェントも補完されます。詳しくは ID と名前空間を参照してください。ロール、種別、MCP の all 一覧については操作の索引で説明しています。未知の入力フィールドは受け付けられ、ignored_args に名前が記録されます。
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。 |
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。 |
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。 |