未翻訳のページは英語で開き、英語と表示されます。
このページは英語の原文の機械翻訳です。内容は英語の原文が優先されます。 Machine-translated from the English page, which is authoritative.
extraction_policy オペレーション
各 extraction_policy.* オペレーションが受け取るフィールドと返すフィールドの正確な定義です。
すべてのオペレーションは、HTTP では POST /v1/<op>、MCP ではツール loom_<op> として利用できます。ID フィールド(org、namespace、agent、user_id、session_id)は、トランスポートが対応している場合にトークンと MCP セッションから補完されます。シングルユーザーのサーバーでトークンなしに HTTP で呼び出す場合は、code.* と tracker.*(それぞれのプレーンの値を保持します)を除くすべてのオペレーションで、インストールの org が補完されます。一部のオペレーションでは、名前空間とエージェントも補完されます。詳しくはID と名前空間を参照してください。ロール、種別、MCP の all 一覧についてはオペレーション一覧で説明しています。未知の入力フィールドは処理され、ignored_args に名前が示されます。
extraction_policy.clear
スコープのポリシーを削除します。
POST /v1/extraction_policy.clear · MCP loom_extraction_policy_clear · ロール org_admin · 冪等 · 監査対象 · MCP の all ツールセットには含まれません
| 入力フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
org |
str |
必須 | テナント(ID タプルの最初の要素)。 |
scope |
Literal['org', 'namespace'] |
必須 | org は org 自身のポリシーを削除します。namespace はその名前空間のポリシーを削除し、org のポリシーはそのまま有効です。 |
namespace |
str |
'' |
ポリシーを削除する名前空間。scope が org の場合は無視されます。 |
| 出力フィールド | 型 | 説明 |
|---|---|---|
org |
str |
テナント(ID タプルの最初の要素)。 |
scope |
Literal['org', 'namespace'] |
指定どおりの org または namespace。 |
namespace |
str |
scope が namespace の場合の名前空間。scope が org の場合は ""。 |
policy |
str |
このスコープのポリシー。未設定の場合は ""。 |
updated_by |
str |
設定した主体。未設定の場合は ""。 |
updated_at |
datetime \| None |
設定された日時(UTC)。未設定の場合は None。 |
effective |
str |
このスコープでの抽出が従うポリシー。org のポリシー、続いて名前空間のポリシーの順に適用されます。どちらも未設定の場合は ""。 |
namespace_policies |
list[NamespacePolicy] |
scope が org の場合:独自のポリシーを持つ org 内のすべての名前空間を名前で列挙します。削除済みの名前空間も含まれ、クリアされるまで LOOM_EXTRACTION_POLICY_MAX_NAMESPACES に数えられます。 |
extraction_policy.get
スコープのポリシーと、そのスコープでの抽出が従うポリシーを返します。
POST /v1/extraction_policy.get · MCP loom_extraction_policy_get · ロール org_admin · 冪等 · MCP の all ツールセットには含まれません
| 入力フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
org |
str |
必須 | テナント(ID タプルの最初の要素)。 |
scope |
Literal['org', 'namespace'] |
必須 | org は org 自身のポリシーを読み取ります。namespace は namespace のポリシーを読み取ります。 |
namespace |
str |
'' |
ポリシーを読み取る名前空間。scope が org の場合は無視されます。 |
| 出力フィールド | 型 | 説明 |
|---|---|---|
org |
str |
テナント(ID タプルの最初の要素)。 |
scope |
Literal['org', 'namespace'] |
指定どおりの org または namespace。 |
namespace |
str |
scope が namespace の場合の名前空間。scope が org の場合は ""。 |
policy |
str |
このスコープのポリシー。未設定の場合は ""。 |
updated_by |
str |
設定した主体。未設定の場合は ""。 |
updated_at |
datetime \| None |
設定された日時(UTC)。未設定の場合は None。 |
effective |
str |
このスコープでの抽出が従うポリシー。org のポリシー、続いて名前空間のポリシーの順に適用されます。どちらも未設定の場合は ""。 |
namespace_policies |
list[NamespacePolicy] |
scope が org の場合:独自のポリシーを持つ org 内のすべての名前空間を名前で列挙します。削除済みの名前空間も含まれ、クリアされるまで LOOM_EXTRACTION_POLICY_MAX_NAMESPACES に数えられます。 |
extraction_policy.set
スコープのポリシーを設定し、それまでのポリシーを置き換えます。
POST /v1/extraction_policy.set · MCP loom_extraction_policy_set · ロール org_admin · 冪等 · 監査対象 · MCP の all ツールセットには含まれません
| 入力フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
org |
str |
必須 | テナント(ID タプルの最初の要素)。 |
scope |
Literal['org', 'namespace'] |
必須 | org は org 自身のポリシーを設定し、すべての名前空間がそれに従います(namespace は無視されます)。namespace はその名前空間が org のポリシーに追加するルールを設定します。 |
namespace |
str |
'' |
namespace スコープのポリシーの対象となる名前空間。scope が org の場合は無視されます。 |
policy |
str |
必須 | 平易な言葉で書かれたルール。最大 4,096 文字で、スコープのポリシーを置き換えます。 |
| 出力フィールド | 型 | 説明 |
|---|---|---|
org |
str |
テナント(ID タプルの最初の要素)。 |
scope |
Literal['org', 'namespace'] |
指定どおりの org または namespace。 |
namespace |
str |
scope が namespace の場合の名前空間。scope が org の場合は ""。 |
policy |
str |
このスコープのポリシー。未設定の場合は ""。 |
updated_by |
str |
設定した主体。未設定の場合は ""。 |
updated_at |
datetime \| None |
設定された日時(UTC)。未設定の場合は None。 |
effective |
str |
このスコープでの抽出が従うポリシー。org のポリシー、続いて名前空間のポリシーの順に適用されます。どちらも未設定の場合は ""。 |
namespace_policies |
list[NamespacePolicy] |
scope が org の場合:独自のポリシーを持つ org 内のすべての名前空間を名前で列挙します。削除済みの名前空間も含まれ、クリアされるまで LOOM_EXTRACTION_POLICY_MAX_NAMESPACES に数えられます。 |