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