> 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/memory-stores/memory-stores-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 à vos fichiers de base de connaissances que vous pouvez filtrer lors de la recherche, un peu comme filtrer des colonnes dans un tableur. {% @arcade/embed url="" flowId="y41OGVJZuh8LHtOtcWlz" %} ## Types de métadonnées ### Métadonnées standard Héritées automatiquement de la source (nom de fichier, URL de la source, date de téléversement, etc.). Les métadonnées standard sont en lecture seule. Pour les mettre à jour, apportez des modifications à la source puis resynchronisez. ### Métadonnées personnalisées Étiquetez les fichiers de la base de connaissances avec vos propres paires clé-valeur pour organiser et filtrer le contenu selon des dimensions comme **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 la base de connaissances dans les étapes du workflow, sans avoir besoin de les importer dans une grille juste pour étiqueter et filtrer le contenu. {% endhint %} ## Ajout de métadonnées ### Métadonnées personnalisées (interface utilisateur) 1. Cliquez sur n’importe quel fichier de votre base de connaissances pour ouvrir sa fiche détaillée 2. Dans le **Métadonnées personnalisées** section, cliquez sur **Ajouter** 3. Saisissez un **Clé** (p. ex., "country") et **Valeur** (p. ex., "France") 4. Cliquez sur **Enregistrer les modifications** ### CSV / Google Sheets Lors du téléversement d’un CSV ou d’une feuille Google, toutes les colonnes sont stockées comme métadonnées. Vous pouvez choisir quelles colonnes sont recherchables. Les autres sont toujours renvoyées comme métadonnées, mais elles ne peuvent être utilisées que pour le filtrage. ### Autres méthodes * **API** - Utilisez le [point de terminaison "Update" de l’API Knowledge Bases](/docs/fr/contexte/memory-stores/memory-stores-api.md#supported-api-calls) * **Workflow** - Utilisez le [étape "Knowledge Base Write"](/docs/fr/actions/workflow-concepts/workflow-steps/memory-steps/memory-write.md) ## Filtrage avec les métadonnées Utilisez des filtres de métadonnées dans vos étapes Knowledge Base de workflow pour circonscrire vos résultats de recherche. **Exemple :** Si vous avez des études de cas étiquetées avec une `country` clé, ajoutez un filtre dans votre **Rechercher dans la base de connaissances** ou **Obtenir un fichier de la base de connaissances** étape où `country` est égal à `"Spain"` pour récupérer uniquement les études de cas espagnoles. {% hint style="info" %} **Filtrage dynamique :** Utilisez les entrées du workflow pour un filtrage flexible. 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 Knowledge Base Search](/docs/fr/actions/workflow-concepts/workflow-steps/memory-steps/memory-search.md#filter-the-memory-store-optional). ### Opérateurs de filtre (é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 liste comme `"genres": ["thriller", "mystery"]`, la recherche correspond à 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](/docs/fr/contexte/memory-stores/memory-stores-api.md#supported-api-calls). {% @arcade/embed url="" flowId="1qOMDldFNqFWJ15cm6Wb" %} ## Bonnes pratiques * **Utilisez des clés cohérentes** - Standardisez les noms de clés (toujours "country", jamais parfois "region") et les formats de valeurs (toujours "United States", pas "US" ni "USA") * **Planifiez votre stratégie** - Déterminez selon quelles dimensions vous devez filtrer avant d’étiqueter le contenu * **Métadonnées personnalisées vs. grilles** - Utilisez les métadonnées personnalisées pour l’étiquetage au niveau des fichiers ; utilisez les grilles pour l’étiquetage au niveau des lignes des 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/memory-stores/memory-stores-metadata.md?ask=&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.