コンテンツにスキップ

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

このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 Machine-translated from the English page, which is authoritative.

memory_schema オペレーション

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

すべてのオペレーションは、HTTP では POST /v1/<op>、MCP ツールでは loom_<op> として利用できます。ID フィールド(org、namespace、agent、user_id、session_id)は、トランスポートが対応している場合にトークンと MCP セッションから補完されます。シングルユーザーサーバーでトークンなしに HTTP で呼び出した場合は、code.* と tracker.*(それぞれのプレーンの値を保持します)を除くすべてのオペレーションでインストールの org が使われ、一部のオペレーションでは名前空間とエージェントも補完されます。詳しくはアイデンティティと名前空間を参照してください。ロール、種別、MCP の all 一覧についてはオペレーション一覧で説明しています。未知の入力フィールドは処理され、ignored_args に名前が示されます。

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。

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] 名前空間のスキーマとそのフィールド。名前順です。

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)。

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)。