> 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/acciones/workflow-concepts/workflow-steps/memory-steps/knowledge-base-read.md).

# Obtener archivo de la base de conocimientos

Lee datos de tus bases de conocimiento usando filtros.

## ¿Qué es un paso de lectura de la base de conocimientos?

El paso de lectura de la base de conocimientos te permite consultar tus bases de conocimientos mediante filtros para obtener datos relevantes que puedas usar en tus flujos de trabajo. Esto resulta especialmente útil al realizar [generación aumentada por recuperación](https://en.wikipedia.org/wiki/Retrieval-augmented_generation)  (RAG).

La principal diferencia entre este paso y el paso de [búsqueda en la base de conocimientos](https://docs.airops.com/docs/es/acciones/workflow-concepts/workflow-steps/memory-steps/memory-search.md) es que, mientras que en el paso de búsqueda puedes hacer consultas y obtener fragmentos de texto, el paso de lectura te permite aplicar filtros y obtener documentos completos.

Para obtener más información sobre cómo configurar una base de conocimientos, consulta nuestra página de documentación [aquí](https://docs.airops.com/docs/es/contexto/knowledge-bases.md).

## Cómo configurar un paso de lectura de la base de conocimientos <a href="#how-to-configure-a-memory-search-step" id="how-to-configure-a-memory-search-step"></a>

### Selecciona una base de conocimientos

Selecciona en el menú desplegable la base de conocimientos que quieras usar.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-156b4e9680ccc76892cabd1dd789d66311d255f7%2Fkb-fetch-step-01-select-kb.png?alt=media" alt="Get Knowledge Base File step with the Knowledge Base dropdown open and Products selected"><figcaption><p>Selecciona la base de conocimientos de la que quieres leer.</p></figcaption></figure>

### Selecciona archivos específicos (opcional)

Puedes seleccionar opcionalmente varios documentos de una lista para leerlos:

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-7bf235014e7a8bf37e56a8def0eec672d8f31bdf%2Fkb-fetch-step-02-select-files.png?alt=media" alt="Get Knowledge Base File step with marketing_data.csv and marketing_data_2.csv selected"><figcaption><p>Selecciona opcionalmente los archivos que quieras leer.</p></figcaption></figure>

### Añade filtros (opcional)

Puedes añadir filtros para acotar los resultados según los campos de metadatos. Estos incluyen:

* **Metadatos estándar** heredados del origen (p. ej., nombre del archivo, URL del origen)
* **Metadatos personalizados** que hayas añadido para etiquetar archivos (p. ej., país, producto, público)
* **Columnas de CSV/hoja de cálculo** cuando la base de conocimientos contiene datos estructurados

**Ejemplo: filtrar por metadatos personalizados**

Si tienes estudios de casos de clientes etiquetados con un campo de metadatos personalizados `country` , puedes aplicar un filtro para recuperar solo los estudios de casos de una región específica:

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-52f3db88479573aaed3f9de4cf13ba919d0b93fa%2Fkb-fetch-step-03-filters.png?alt=media" alt="Get Knowledge Base File filters for Country equal United Kingdom and UnitPrice less than 3"><figcaption><p>Filtra los registros por metadatos o columnas CSV.</p></figcaption></figure>

{% hint style="success" %}
**Filtrado dinámico**

Usa las entradas del flujo de trabajo para que los filtros sean dinámicos. Por ejemplo, configura el filtro para que `country` sea igual a `{{input.region}}` y el flujo de trabajo recuperará archivos que coincidan con la región que se proporcione en tiempo de ejecución.
{% endhint %}

Para que el filtrado sea eficaz, te recomendamos leer [Metadatos de las bases de conocimientos](https://docs.airops.com/docs/es/contexto/knowledge-bases/knowledge-base-metadata.md) para aprender a añadir etiquetas de metadatos personalizados a los archivos de tu base de conocimientos.

## Salida del paso de lectura de la base de conocimientos

El paso de lectura de la base de conocimientos genera una lista de documentos con sus respectivos registros. En el ejemplo anterior de productos filtrados, el resultado sería el siguiente:

```json
[
  {
    "document_name": "marketing_data.csv",
    "records": [
      {
        "__text": "WHITE HANGING HEART T-LIGHT HOLDER\n\n-----\n\nUnited Kingdom",
        "InvoiceNo": 536365,
        "StockCode": "85123A",
        "Description": "WHITE HANGING HEART T-LIGHT HOLDER",
        "Quantity": 6,
        "InvoiceDate": "12/1/2010 8:26",
        "UnitPrice": 2.55,
        "CustomerID": 17850,
        "Country": "Reino Unido"
      },
      ...
    ]
  },
  {
    "document_name": "marketing_data_2.csv",
    "records": [
      {
        "__text": "COLGADOR DE CORAZONES DE CUPIDO COLOR CREMA\n\n-----\n\nReino Unido",
        "InvoiceNo": 536365,
        "StockCode": "84406B",
        "Description": "COLGADOR DE CORAZONES DE CUPIDO COLOR CREMA",
        "Quantity": 8,
        "InvoiceDate": "12/1/2010 8:26",
        "UnitPrice": 2.75,
        "CustomerID": 17850,
        "Country": "Reino Unido"
      },
      ...
    ]
  }
]
```

Puedes observar que:

* Solo se devuelven los documentos seleccionados en el menú desplegable.
* Cada documento tiene una lista de registros asociada. Como estos documentos son archivos CSV, cada registro representa una fila distinta.
* Solo se devuelven los registros que coinciden con los filtros seleccionados (Reino Unido y UnitPrice < 3).
* Hay un campo especial "\_\_text" que muestra el texto de búsqueda seleccionado durante la carga del archivo CSV. En este caso, como solo se seleccionaron las columnas "Description" y "Country" para las búsquedas, esas son las columnas que se incluyen en el campo "\_\_text".

A continuación se muestra un ejemplo de resultado al recuperar un documento PDF:

```json
[
  {
    "document_name": "US_Congress-2023-SB546-Enrolled.pdf",
    "records": [
      {
        "__text": "S. 546  \n\nOne Hundred Eighteenth Congress of the United States of America\n\nAT T H E S E C O N D S E S S I O N\n\nBegun and held at the City of Washington on Wednesday, the third day of January, two thousand and twenty four\n\nAn Act\n\nTo amend the Omnibus Crime Control and Safe Streets Act of 1968 to authorize law enforcement agencies to use COPS grants for recruitment activities, and for other purposes...",
        "__languages": [
          "eng"
        ],
      }
    ]
  }
]
```

## Uso de la salida del paso para realizar RAG

Podemos pasar la salida del paso de recuperación de la base de conocimiento a un paso de LLM para generar respuestas con recuperación aumentada (RAG).

Siguiendo con el ejemplo de nuestros productos, podemos recuperar la lista completa de productos y pasarla a un paso de LLM de esta manera:

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-ebd8daf0a590d8381a6257fa6b065127bb72af42%2Fkb-fetch-step-04-rag-workflow.png?alt=media" alt="UK Product Finder Workflow passing the Get Knowledge Base File output into a Prompt LLM step"><figcaption><p>Pasa los registros recuperados a un paso de LLM.</p></figcaption></figure>

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-68a19f1b74f47559da563ce92f93816ea64d842e%2Fkb-fetch-step-05-rag-llm.png?alt=media" alt="Prompt LLM step that references the fetched records, with its answer listing three products under the step on the canvas"><figcaption><p>El LLM responde usando los registros recuperados.</p></figcaption></figure>


---

# 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/acciones/workflow-concepts/workflow-steps/memory-steps/knowledge-base-read.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.
