> Source: https://clickhouse.github.io/loom/es/reference/operations/extraction_policy/ (Markdown: https://clickhouse.github.io/loom/es/reference/operations/extraction_policy.md)

<!-- i18n: source=docs/reference/operations/extraction_policy.md blob=28a735779ebc56e685a83b284c4e4f5f7f959a2e model=claude-sonnet-5-5 -->
> Esta página es una traducción automática de la [página en inglés](https://clickhouse.github.io/loom/reference/operations/extraction_policy/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/extraction_policy/), which is authoritative.

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

# Operaciones de `extraction_policy`

Los campos exactos que recibe y devuelve cada operación `extraction_policy.*`.

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

Cada op es `POST /v1/<op>` sobre HTTP y la herramienta MCP `loom_<op>`. Los campos de identidad (`org`, `namespace`, `agent`, `user_id`, `session_id`) se rellenan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token en un servidor de un solo usuario, se usa la org de la instalación en todas las ops salvo `code.*` y `tracker.*` (que conservan la de su plano), y en [algunas ops](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) también su espacio de nombres y su agente; consulta [identidades y espacios de nombres](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md). El [índice de operaciones](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica el rol, el tipo y el listado `all` de MCP. Los campos de entrada desconocidos se atienden y se nombran en `ignored_args`.

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

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

## `extraction_policy.clear`

Elimina la política del ámbito.

`POST /v1/extraction_policy.clear` · MCP `loom_extraction_policy_clear` · rol `org_admin` · idempotente · auditada · no aparece en el conjunto de herramientas `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `scope` | `Literal['org', 'namespace']` | obligatorio | `org` elimina la política propia de la org; `namespace` elimina la de ese espacio de nombres y deja vigente la de la org. |
| `namespace` | `str` | `''` | El espacio de nombres cuya política se elimina; se ignora con el ámbito `org`. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `org` | `str` | El tenant (primer elemento de la tupla de identidad). |
| `scope` | `Literal['org', 'namespace']` | `org` o `namespace`, según lo solicitado. |
| `namespace` | `str` | El espacio de nombres para el ámbito `namespace`; "" para el ámbito `org`. |
| `policy` | `str` | La política de este ámbito; "" cuando no hay ninguna. |
| `updated_by` | `str` | Quién la estableció; "" cuando no hay ninguna. |
| `updated_at` | `datetime \| None` | Cuándo se estableció (UTC); None cuando no hay ninguna. |
| `effective` | `str` | Bajo qué política se ejecutan las extracciones en este ámbito: la de la org y luego la del espacio de nombres; "" cuando no hay ninguna. |
| `namespace_policies` | `list[NamespacePolicy]` | Para el ámbito `org`: cada espacio de nombres de la org que tiene una política propia, por nombre, incluido el de un espacio de nombres eliminado, que sigue contando para LOOM_EXTRACTION_POLICY_MAX_NAMESPACES hasta que se borra. |

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

## `extraction_policy.get`

La política del ámbito y la bajo la que se ejecutan sus extracciones.

`POST /v1/extraction_policy.get` · MCP `loom_extraction_policy_get` · rol `org_admin` · idempotente · no aparece en el conjunto de herramientas `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `scope` | `Literal['org', 'namespace']` | obligatorio | `org` lee la política propia de la org; `namespace` lee la de `namespace`. |
| `namespace` | `str` | `''` | El espacio de nombres cuya política se lee; se ignora con el ámbito `org`. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `org` | `str` | El tenant (primer elemento de la tupla de identidad). |
| `scope` | `Literal['org', 'namespace']` | `org` o `namespace`, según lo solicitado. |
| `namespace` | `str` | El espacio de nombres para el ámbito `namespace`; "" para el ámbito `org`. |
| `policy` | `str` | La política de este ámbito; "" cuando no hay ninguna. |
| `updated_by` | `str` | Quién la estableció; "" cuando no hay ninguna. |
| `updated_at` | `datetime \| None` | Cuándo se estableció (UTC); None cuando no hay ninguna. |
| `effective` | `str` | Bajo qué política se ejecutan las extracciones en este ámbito: la de la org y luego la del espacio de nombres; "" cuando no hay ninguna. |
| `namespace_policies` | `list[NamespacePolicy]` | Para el ámbito `org`: cada espacio de nombres de la org que tiene una política propia, por nombre, incluido el de un espacio de nombres eliminado, que sigue contando para LOOM_EXTRACTION_POLICY_MAX_NAMESPACES hasta que se borra. |

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

## `extraction_policy.set`

Establece la política del ámbito y reemplaza la que tenía.

`POST /v1/extraction_policy.set` · MCP `loom_extraction_policy_set` · rol `org_admin` · idempotente · auditada · no aparece en el conjunto de herramientas `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `scope` | `Literal['org', 'namespace']` | obligatorio | `org` establece la política propia de la org, que siguen todos los espacios de nombres (`namespace` se ignora); `namespace` establece las reglas que ese espacio de nombres añade a ella. |
| `namespace` | `str` | `''` | El espacio de nombres al que se aplica una política de ámbito `namespace`; se ignora con el ámbito `org`. |
| `policy` | `str` | obligatorio | Las reglas en lenguaje natural, como máximo 4,096 caracteres; reemplaza la política del ámbito. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `org` | `str` | El tenant (primer elemento de la tupla de identidad). |
| `scope` | `Literal['org', 'namespace']` | `org` o `namespace`, según lo solicitado. |
| `namespace` | `str` | El espacio de nombres para el ámbito `namespace`; "" para el ámbito `org`. |
| `policy` | `str` | La política de este ámbito; "" cuando no hay ninguna. |
| `updated_by` | `str` | Quién la estableció; "" cuando no hay ninguna. |
| `updated_at` | `datetime \| None` | Cuándo se estableció (UTC); None cuando no hay ninguna. |
| `effective` | `str` | Bajo qué política se ejecutan las extracciones en este ámbito: la de la org y luego la del espacio de nombres; "" cuando no hay ninguna. |
| `namespace_policies` | `list[NamespacePolicy]` | Para el ámbito `org`: cada espacio de nombres de la org que tiene una política propia, por nombre, incluido el de un espacio de nombres eliminado, que sigue contando para LOOM_EXTRACTION_POLICY_MAX_NAMESPACES hasta que se borra. |

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