コンテンツにスキップ

未翻訳のページは英語で開き、英語と表示されます。

このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 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。