extraction_policy 操作
extraction_policy 操作
本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.
每个 extraction_policy.* 操作接受和返回的确切字段。
每个 op 都是 HTTP 上的 POST /v1/<op>,同时也是 MCP 工具 loom_<op>。身份字段(org、namespace、agent、user_id、session_id)在传输层能够提供时,会根据令牌和 MCP 会话自动填充;对于单用户服务器上不带令牌的 HTTP 调用,除 code.* 和 tracker.*(它们沿用各自平面的 org)之外,所有 op 都使用该安装的 org,而在部分 op 上,其命名空间和 agent 也会自动填充;参见身份与命名空间。操作索引说明了角色、类型以及 MCP 的 all 列表。未知的输入字段仍会被处理,并列在 ignored_args 中。
extraction_policy.clear
移除该范围的策略。
POST /v1/extraction_policy.clear · MCP loom_extraction_policy_clear · 角色 org_admin · 幂等 · 已审计 · 不在 MCP all 工具集中列出
| 输入字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
org |
str |
必填 | 租户(身份元组的第一个元素)。 |
scope |
Literal['org', 'namespace'] |
必填 | org 移除该 org 自身的策略;namespace 移除该命名空间的策略,org 的策略仍然生效。 |
namespace |
str |
'' |
要移除策略的命名空间;scope 为 org 时忽略。 |
| 输出字段 | 类型 | 含义 |
|---|---|---|
org |
str |
租户(身份元组的第一个元素)。 |
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 |
必填 | 租户(身份元组的第一个元素)。 |
scope |
Literal['org', 'namespace'] |
必填 | org 读取该 org 自身的策略;namespace 读取 namespace 的策略。 |
namespace |
str |
'' |
要读取策略的命名空间;scope 为 org 时忽略。 |
| 输出字段 | 类型 | 含义 |
|---|---|---|
org |
str |
租户(身份元组的第一个元素)。 |
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 |
必填 | 租户(身份元组的第一个元素)。 |
scope |
Literal['org', 'namespace'] |
必填 | org 设置该 org 自身的策略,所有命名空间都遵循它(忽略 namespace);namespace 设置该命名空间在其基础上追加的规则。 |
namespace |
str |
'' |
namespace 范围的策略所属的命名空间;scope 为 org 时忽略。 |
policy |
str |
必填 | 用自然语言书写的规则,最多 4,096 个字符;会替换该范围的策略。 |
| 输出字段 | 类型 | 含义 |
|---|---|---|
org |
str |
租户(身份元组的第一个元素)。 |
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。 |