> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/contexto/memory-stores/memory-stores-metadata.md).

# Metadatos de la base de conocimiento

Filtrar al buscar en una base de conocimiento

Los metadatos son información adicional adjunta a los archivos de tu Base de conocimientos que puedes usar para filtrar al buscar, de forma similar a filtrar columnas en una hoja de cálculo.

{% @arcade/embed url="<https://app.arcade.software/share/y41OGVJZuh8LHtOtcWlz>" flowId="y41OGVJZuh8LHtOtcWlz" %}

## Tipos de metadatos

### Metadatos estándar

Se heredan automáticamente de la fuente (nombre del archivo, URL de origen, fecha de carga, etc.). Los metadatos estándar son de solo lectura. Para actualizarlos, realiza cambios en la fuente y vuelve a sincronizar.

### Metadatos personalizados

Etiqueta los archivos de la Base de conocimientos con tus propios pares clave-valor para organizar y filtrar el contenido por dimensiones como **Región**, **Producto**, **Audiencia**, o **Tipo de contenido**.

{% hint style="success" %}
Los metadatos personalizados te permiten filtrar archivos de la Base de conocimientos directamente en los pasos del flujo de trabajo, sin necesidad de importarlos a una Grid solo para etiquetar y filtrar contenido.
{% endhint %}

## Añadir metadatos

### Metadatos personalizados (UI)

1. Haz clic en cualquier archivo de tu Base de conocimientos para abrir su sección de detalles
2. En el **Metadatos personalizados** sección, haz clic en **Añadir**
3. Introduce un **Clave** (p. ej., "país") y **Valor** (p. ej., "Francia")
4. Haz clic en **Guardar cambios**

### CSV / Hojas de cálculo de Google

Al subir un CSV o una Hoja de cálculo de Google, todas las columnas se almacenan como metadatos. Puedes elegir qué columnas son buscables. El resto también se devuelven como metadatos, pero solo pueden usarse para filtrar.

### Otros métodos

* **API** - Usa el [endpoint "Update" de la API de Bases de conocimientos](/docs/es/contexto/memory-stores/memory-stores-api.md#supported-api-calls)
* **Flujo de trabajo** - Usa el [paso "Knowledge Base Write"](/docs/es/acciones/workflow-concepts/workflow-steps/memory-steps/memory-write.md)

## Filtrar con metadatos

Usa filtros de metadatos en los pasos de Base de conocimientos de tu flujo de trabajo para delimitar los resultados de búsqueda.

**Ejemplo:** Si tienes casos de éxito etiquetados con una `country` clave, añade un filtro en tu **Buscar en la base de conocimientos** o **Obtener archivo de la base de conocimientos** paso donde `country` es igual a `"España"` para recuperar solo casos de éxito españoles.

{% hint style="info" %}
**Filtrado dinámico:** Usa entradas del flujo de trabajo para un filtrado flexible. Establece tu filtro en `country` es igual a `{{input.region}}`, y luego pasa distintos valores de región en tiempo de ejecución.
{% endhint %}

Para ver ejemplos detallados de filtrado, consulta la [documentación del paso Knowledge Base Search](/docs/es/acciones/workflow-concepts/workflow-steps/memory-steps/memory-search.md#filter-the-memory-store-optional).

### Operadores de filtro (Editor de código)

Para filtros complejos, usa operadores de consulta de MongoDB:

| Operador           | Descripción                   |
| ------------------ | ----------------------------- |
| **$eq**            | Igual a                       |
| **$ne**            | Diferente de                  |
| **$gt** / **$gte** | Mayor que / Mayor que o igual |
| **$lt** / **$lte** | Menor que / Menor que o igual |
| **$in** / **$nin** | En lista / No en lista        |

{% hint style="info" %}
Para metadatos de lista como `"genres": ["thriller", "mystery"]`, la búsqueda coincide con cualquier valor de la lista.
{% endhint %}

### Filtrado mediante API

También puedes filtrar usando el [endpoint "Search" de la API de Bases de conocimientos](/docs/es/contexto/memory-stores/memory-stores-api.md#supported-api-calls).

{% @arcade/embed url="<https://app.arcade.software/share/1qOMDldFNqFWJ15cm6Wb>" flowId="1qOMDldFNqFWJ15cm6Wb" %}

## Mejores prácticas

* **Usa claves coherentes** - Estandariza los nombres de las claves (siempre "country", no a veces "region") y los formatos de los valores (siempre "Estados Unidos", no "US" ni "USA")
* **Planifica tu estrategia** - Decide por qué dimensiones necesitas filtrar antes de etiquetar el contenido
* **Metadatos personalizados frente a Grids** - Usa metadatos personalizados para etiquetar a nivel de archivo; usa Grids para etiquetar a nivel de fila datos estructurados


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/contexto/memory-stores/memory-stores-metadata.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.