跳到内容
ClickHouse Loom
Esc
↑↓导航↵打开⌘J预览
本页内容

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

这个页面有帮助吗?