> 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/kontext/knowledge-bases/knowledge-base-metadata.md).

# Metadaten der Wissensdatenbank

Beim Durchsuchen einer Wissensdatenbank filtern

Metadaten sind zusätzliche Informationen, die an Dateien in Ihrer Knowledge Base angehängt sind und nach denen Sie bei der Suche filtern können – ähnlich wie beim Filtern von Spalten in einer Tabellenkalkulation.

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

## Arten von Metadaten

### Standardmetadaten

Werden automatisch von der Quelle übernommen (Dateiname, Quell-URL, Upload-Datum usw.). Standardmetadaten sind schreibgeschützt. Um sie zu aktualisieren, nehmen Sie die Änderungen an der Quelle vor und synchronisieren Sie sie erneut.

### Benutzerdefinierte Metadaten

Versehen Sie Dateien in Ihrer Knowledge Base mit eigenen Schlüssel-Wert-Paaren, um Inhalte nach Dimensionen wie **Region**, **Produkt**, **Zielgruppe**oder **Inhaltstyp**.

{% hint style="success" %}
Mit benutzerdefinierten Metadaten können Sie Dateien in Ihrer Knowledge Base direkt in Workflow-Schritten filtern. Sie müssen Inhalte also nicht erst in ein Grid importieren, nur um sie zu taggen und zu filtern.
{% endhint %}

## Metadaten hinzufügen

### Benutzerdefinierte Metadaten (Benutzeroberfläche)

1. Klicken Sie auf eine beliebige Datei in Ihrer Knowledge Base, um ihre Details zu öffnen.
2. Klicken Sie im Abschnitt **Benutzerdefinierte Metadaten** auf **Hinzufügen**
3. Geben Sie einen **Schlüssel** (z. B. „country“) und einen **Wert** (z. B. „France“) ein.
4. Klicken Sie auf **Änderungen speichern**

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-52948fcc8499dafc67e51e4c6f7866005b244f9d%2Fkb-metadata-01-custom-metadata.png?alt=media" alt="Knowledge Base file details with custom metadata for country and product"><figcaption><p>Fügen Sie einer Datei in der Knowledge Base benutzerdefinierte Metadaten hinzu.</p></figcaption></figure>

### CSV / Google Sheets

Beim Hochladen einer CSV-Datei oder eines Google Sheets werden alle Spalten als Metadaten gespeichert. Sie können auswählen, welche Spalten durchsuchbar sind. Die übrigen Spalten werden weiterhin als Metadaten zurückgegeben, können aber nur zum Filtern verwendet werden.

### Weitere Methoden

* **API** – Verwenden Sie den [Knowledge Bases API „Update“-Endpunkt](https://docs.airops.com/docs/de/kontext/knowledge-bases/knowledge-base-api.md#supported-api-calls)
* **Workflow** – Verwenden Sie den [Schritt „Knowledge Base Write“](https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/memory-steps/memory-write.md)

## Mit Metadaten filtern

Verwenden Sie in den Knowledge-Base-Schritten Ihres Workflows Metadatenfilter, um die Suchergebnisse einzugrenzen.

**Beispiel:** Wenn Sie Fallstudien mit einem `country` Schlüssel versehen haben, fügen Sie in Ihrem Schritt **Knowledge Base durchsuchen** oder **Knowledge-Base-Datei abrufen** einen Filter hinzu, bei dem `country` gleich `"Spain"` ist, um nur spanische Fallstudien abzurufen.

{% hint style="info" %}
**Dynamische Filterung:** Verwenden Sie Workflow-Eingaben für flexible Filter. Legen Sie Ihren Filter wie folgt fest: `country` ist gleich `{{input.region}}`, und übergeben Sie zur Laufzeit unterschiedliche Werte für die Region.
{% endhint %}

Ausführliche Beispiele zum Filtern finden Sie in der Dokumentation zum [Schritt „Knowledge Base Search“](https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/memory-steps/memory-search.md#filter-the-memory-store-optional).

### Filteroperatoren (Code-Editor)

Verwenden Sie für komplexe Filter MongoDB-Abfrageoperatoren:

| Operator           | Beschreibung                          |
| ------------------ | ------------------------------------- |
| **$eq**            | Gleich                                |
| **$ne**            | Ungleich                              |
| **$gt** / **$gte** | Größer als / größer als oder gleich   |
| **$lt** / **$lte** | Kleiner als / kleiner als oder gleich |
| **$in** / **$nin** | In der Liste / nicht in der Liste     |

{% hint style="info" %}
Bei Listen-Metadaten wie `"genres": ["thriller", "mystery"]`, findet die Suche jeden Wert in der Liste.
{% endhint %}

### Filtern über die API

Sie können auch über den Endpunkt [„Search“ der Knowledge Bases API](https://docs.airops.com/docs/de/kontext/knowledge-bases/knowledge-base-api.md#supported-api-calls).

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

## Bewährte Vorgehensweisen

* **Einheitliche Schlüssel verwenden** - Standardisieren Sie Schlüsselnamen (immer "country", nicht manchmal "region") und Werteformate (immer "United States", nicht "US" oder "USA").
* **Strategie planen** - Legen Sie fest, nach welchen Dimensionen Sie filtern möchten, bevor Sie Inhalte mit Tags versehen.
* **Benutzerdefinierte Metadaten oder Grids** - Verwenden Sie benutzerdefinierte Metadaten für Tags auf Dateiebene und Grids für Tags auf Zeilenebene bei strukturierten Daten.


---

# 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/kontext/knowledge-bases/knowledge-base-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.
