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

# Métadonnées de la base de connaissances

Filtrer lors de la recherche dans une base de connaissances

Les métadonnées sont des informations supplémentaires associées aux fichiers de votre base de connaissances. Vous pouvez les utiliser pour filtrer les résultats de recherche, comme vous le feriez avec les colonnes d’un tableur.

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

## Types de métadonnées

### Métadonnées standard

Héritées automatiquement de la source (nom du fichier, URL source, date d’importation, etc.). Les métadonnées standard sont en lecture seule. Pour les mettre à jour, modifiez la source, puis synchronisez à nouveau.

### Métadonnées personnalisées

Ajoutez à vos fichiers de base de connaissances des paires clé-valeur de votre choix pour organiser et filtrer le contenu selon des critères tels que **Région**, **Produit**, **Public**, ou **Type de contenu**.

{% hint style="success" %}
Les métadonnées personnalisées vous permettent de filtrer directement les fichiers de votre base de connaissances dans les étapes de workflow, sans avoir à les importer dans une grille uniquement pour les baliser et les filtrer.
{% endhint %}

## Ajouter des métadonnées

### Métadonnées personnalisées (interface utilisateur)

1. Cliquez sur n’importe quel fichier de votre base de connaissances pour afficher ses détails.
2. Dans la section **Métadonnées personnalisées** , cliquez sur **Ajouter**
3. Saisissez une **Clé** (par exemple, « country ») et une **Valeur** (par exemple, « France »)
4. Cliquez sur **Enregistrer les modifications**

<figure><img src="https://344527547-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>Ajouter des métadonnées personnalisées à un fichier de base de connaissances.</p></figcaption></figure>

### CSV / Google Sheets

Lors de l’importation d’un fichier CSV ou d’une feuille Google Sheets, toutes les colonnes sont enregistrées comme métadonnées. Vous pouvez choisir les colonnes qui peuvent faire l’objet d’une recherche. Les autres sont tout de même renvoyées comme métadonnées, mais ne peuvent être utilisées que pour le filtrage.

### Autres méthodes

* **API**  - Utilisez le point de terminaison « Update » de l’API [Knowledge Bases](https://docs.airops.com/docs/fr/contexte/knowledge-bases/knowledge-base-api.md#supported-api-calls)
* **Workflow**  - Utilisez l’étape [« Knowledge Base Write »](https://docs.airops.com/docs/fr/actions/workflow-concepts/workflow-steps/memory-steps/memory-write.md)

## Filtrer avec les métadonnées

Utilisez des filtres de métadonnées dans les étapes de workflow liées à la base de connaissances pour limiter les résultats de recherche.

**Exemple :** Si vous avez des études de cas associées à une clé `country` , ajoutez un filtre dans l’étape **Search Knowledge Base** ou **Get Knowledge Base File** où `country` est égal à `"Spain"` pour ne récupérer que les études de cas espagnoles.

{% hint style="info" %}
**Filtrage dynamique :** Utilisez les paramètres d’entrée du workflow pour appliquer des filtres flexibles. Définissez votre filtre sur `country` est égal à `{{input.region}}`, puis transmettez différentes valeurs de région à l’exécution.
{% endhint %}

Pour des exemples détaillés de filtrage, consultez la [documentation de l’étape de recherche dans la base de connaissances](https://docs.airops.com/docs/fr/actions/workflow-concepts/workflow-steps/memory-steps/memory-search.md#filter-the-memory-store-optional).

### Opérateurs de filtrage (éditeur de code)

Pour les filtres complexes, utilisez les opérateurs de requête MongoDB :

| Opérateur          | Description                           |
| ------------------ | ------------------------------------- |
| **$eq**            | Égal à                                |
| **$ne**            | Différent de                          |
| **$gt** / **$gte** | Supérieur à / supérieur ou égal à     |
| **$lt** / **$lte** | Inférieur à / inférieur ou égal à     |
| **$in** / **$nin** | Dans le tableau / pas dans le tableau |

{% hint style="info" %}
Pour les métadonnées de type liste, comme `"genres": ["thriller", "mystery"]`, la recherche renvoie les résultats correspondant à n’importe quelle valeur de la liste.
{% endhint %}

### Filtrage via l’API

Vous pouvez également filtrer à l’aide du [point de terminaison « Search » de l’API Knowledge Bases](https://docs.airops.com/docs/fr/contexte/knowledge-bases/knowledge-base-api.md#supported-api-calls).

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

## Bonnes pratiques

* **Utilisez des clés cohérentes** - Uniformisez les noms des clés (toujours « country », et non parfois « region ») et le format des valeurs (toujours « United States », et non « US » ou « USA »)
* **Planifiez votre stratégie** - Déterminez les dimensions selon lesquelles vous souhaitez filtrer avant d’ajouter des balises au contenu
* **Métadonnées personnalisées ou grilles** - Utilisez les métadonnées personnalisées pour ajouter des balises au niveau des fichiers ; utilisez les grilles pour ajouter des balises au niveau des lignes dans les données structurées


---

# 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/fr/contexte/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.
