<a id="extraction_policy-operations"></a>

# `extraction_policy` 操作

<!-- i18n: source=docs/reference/operations/extraction_policy.md blob=28a735779ebc56e685a83b284c4e4f5f7f959a2e model=claude-sonnet-5-5 -->
> 本页由机器从[英文原文](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/extraction_policy.md)翻译，内容以英文原文为准。
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/extraction_policy.md), which is authoritative.


每个 `extraction_policy.*` 操作接受和返回的确切字段。

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

每个 op 都是 HTTP 上的 `POST /v1/<op>`，同时也是 MCP 工具 `loom_<op>`。身份字段（`org`、`namespace`、`agent`、`user_id`、`session_id`）在传输层能够提供时，会根据令牌和 MCP 会话自动填充；对于单用户服务器上不带令牌的 HTTP 调用，除 `code.*` 和 `tracker.*`（它们沿用各自平面的 org）之外，所有 op 都使用该安装的 org，而在[部分 op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) 上，其命名空间和 agent 也会自动填充；参见[身份与命名空间](/zh-CN/concepts/identities-and-namespaces)。[操作索引](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)说明了角色、类型以及 MCP 的 `all` 列表。未知的输入字段仍会被处理，并列在 `ignored_args` 中。

<!-- prettier-ignore-start -->

<a id="extraction_policyclear"></a>

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

<a id="extraction_policyget"></a>

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

<a id="extraction_policyset"></a>

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

<!-- prettier-ignore-end -->
