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

# Datei aus Wissensdatenbank abrufen

Lesen Sie Daten aus Ihren Wissensdatenbanken mithilfe von Filtern.

## Was ist ein Knowledge-Base-Leseschritt?

Mit dem Knowledge-Base-Leseschritt können Sie Ihre Knowledge Bases mithilfe von Filtern abfragen, um relevante Daten für Ihre Workflows abzurufen. Das ist besonders hilfreich bei der [Retrieval-Augmented Generation](https://en.wikipedia.org/wiki/Retrieval-augmented_generation) (RAG).

Der Hauptunterschied zwischen diesem Schritt und dem [Knowledge-Base-Suchschritt](https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/memory-steps/memory-search.md) besteht darin, dass Sie beim Suchschritt Abfragen durchführen und Textabschnitte abrufen können, während Sie beim Leseschritt Filter anwenden und vollständige Dokumente abrufen können.

Weitere Informationen zur Einrichtung einer Knowledge Base finden Sie auf unserer Dokumentationsseite [hier](https://docs.airops.com/docs/de/kontext/knowledge-bases.md).

## So konfigurieren Sie einen Knowledge-Base-Leseschritt <a href="#how-to-configure-a-memory-search-step" id="how-to-configure-a-memory-search-step"></a>

### Knowledge Base auswählen

Wählen Sie im Dropdown-Menü die Knowledge Base aus, die Sie verwenden möchten.

<figure><img src="https://1960680173-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>Wählen Sie die Knowledge Base aus, aus der gelesen werden soll.</p></figcaption></figure>

### Bestimmte Dateien auswählen (optional)

Optional können Sie in einer Liste mehrere Dokumente auswählen, aus denen gelesen werden soll:

<figure><img src="https://1960680173-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>Wählen Sie optional die zu lesenden Dateien aus.</p></figcaption></figure>

### Filter hinzufügen (optional)

Sie können Filter hinzufügen, um die Ergebnisse anhand von Metadatenfeldern einzugrenzen. Dazu gehören:

* **Standardmetadaten** aus der Quelle übernommen (z. B. Dateiname, Quell-URL)
* **Benutzerdefinierte Metadaten** die Sie zum Kennzeichnen von Dateien hinzugefügt haben (z. B. Land, Produkt, Zielgruppe)
* **CSV-/Tabellenspalten** wenn die Knowledge Base strukturierte Daten enthält

**Beispiel: Filtern nach benutzerdefinierten Metadaten**

Wenn Sie Kundenfallstudien mit einem benutzerdefinierten Metadatenfeld namens `country` gekennzeichnet haben, können Sie filtern, um nur Fallstudien für eine bestimmte Region abzurufen:

<figure><img src="https://1960680173-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>Datensätze nach Metadaten oder CSV-Spalten filtern.</p></figcaption></figure>

{% hint style="success" %}
**Dynamische Filterung**

Verwenden Sie Workflow-Eingaben, um Filter dynamisch zu gestalten. Legen Sie den Filter beispielsweise auf `country` ist gleich `{{input.region}}` fest. Der Workflow ruft dann Dateien ab, die der zur Laufzeit übergebenen Region entsprechen.
{% endhint %}

Damit die Filterung effektiv ist, empfehlen wir Ihnen, die Dokumentation zu [Metadaten von Knowledge Bases](https://docs.airops.com/docs/de/kontext/knowledge-bases/knowledge-base-metadata.md) zu lesen. Dort erfahren Sie, wie Sie benutzerdefinierte Metadaten-Tags zu Ihren Knowledge-Base-Dateien hinzufügen.

## Ausgabe des Knowledge-Base-Leseschritts

Der Knowledge-Base-Leseschritt gibt eine Liste von Dokumenten mit den zugehörigen Datensätzen aus. Im vorherigen Beispiel zum Filtern von Produkten sieht die Ausgabe so aus:

```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": "United Kingdom"
      },
      ...
    ]
  },
  {
    "document_name": "marketing_data_2.csv",
    "records": [
      {
        "__text": "CREAM CUPID HEARTS COAT HANGER\n\n-----\n\nUnited Kingdom",
        "InvoiceNo": 536365,
        "StockCode": "84406B",
        "Description": "CREAM CUPID HEARTS COAT HANGER",
        "Quantity": 8,
        "InvoiceDate": "12/1/2010 8:26",
        "UnitPrice": 2.75,
        "CustomerID": 17850,
        "Country": "United Kingdom"
      },
      ...
    ]
  }
]
```

Beachten Sie Folgendes:

* Es werden nur die Dokumente zurückgegeben, die im Dropdown-Menü ausgewählt wurden.
* Jedes Dokument enthält eine Liste von Datensätzen. Da es sich bei diesen Dokumenten um CSV-Dateien handelt, entspricht jeder Datensatz einer anderen Zeile.
* Es werden nur die Datensätze zurückgegeben, die den ausgewählten Filtern entsprechen (United Kingdom und UnitPrice < 3).
* Es gibt ein spezielles Feld „\_\_text“, das den durchsuchbaren Text anzeigt, der beim Hochladen der CSV-Datei ausgewählt wurde. Da in diesem Fall nur die Spalten „Description“ und „Country“ als durchsuchbar ausgewählt wurden, sind diese Spalten im Feld „\_\_text“ eingebettet.

Im Folgenden sehen Sie ein Beispiel für die Ausgabe beim Abrufen eines PDF-Dokuments:

```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"
        ],
      }
    ]
  }
]
```

## Die Ausgabe des Schritts für RAG verwenden

Wir können die Ausgabe des Schritts „Knowledge Base Fetch“ an einen LLM-Schritt übergeben, um Retrieval Augmented Generation durchzuführen.

Wie in unserem Produktbeispiel können wir die vollständige Produktliste abrufen und sie wie folgt an einen LLM-Schritt übergeben:

<figure><img src="https://1960680173-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>Die abgerufenen Datensätze an einen LLM-Schritt übergeben.</p></figcaption></figure>

<figure><img src="https://1960680173-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>Das LLM antwortet anhand der abgerufenen Datensätze.</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/de/aktionen/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.
