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

# Obtenir le fichier de la base de connaissances

Lisez les données de vos bases de connaissances à l'aide de filtres.

## Qu’est-ce qu’une étape de lecture de base de connaissances ?

L’étape de lecture de base de connaissances vous permet d’interroger vos bases de connaissances à l’aide de filtres afin d’obtenir des données pertinentes à utiliser dans vos workflows. Cette fonctionnalité est particulièrement utile pour la [génération augmentée par récupération](https://en.wikipedia.org/wiki/Retrieval-augmented_generation) (RAG).

La principale différence entre cette étape et 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) est que, tandis que l’étape de recherche permet d’effectuer des requêtes et d’obtenir des blocs de texte, l’étape de lecture permet d’appliquer des filtres et d’obtenir des documents complets.

Pour en savoir plus sur la configuration d’une base de connaissances, consultez notre page de documentation [ici](https://docs.airops.com/docs/fr/contexte/knowledge-bases.md).

## Comment configurer une étape de lecture de base de connaissances <a href="#how-to-configure-a-memory-search-step" id="how-to-configure-a-memory-search-step"></a>

### Sélectionner une base de connaissances

Sélectionnez dans le menu déroulant la base de connaissances que vous souhaitez utiliser.

<figure><img src="https://344527547-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>Sélectionnez la base de connaissances à lire.</p></figcaption></figure>

### Sélectionner des fichiers spécifiques (facultatif)

Vous pouvez sélectionner plusieurs documents à lire dans une liste (facultatif) :

<figure><img src="https://344527547-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>Sélectionnez éventuellement les fichiers à lire.</p></figcaption></figure>

### Ajouter des filtres (facultatif)

Vous pouvez ajouter des filtres pour affiner les résultats en fonction des champs de métadonnées. Cela inclut :

* **Métadonnées standard** héritées de la source (par exemple, nom du fichier, URL de la source)
* **Métadonnées personnalisées** que vous avez ajoutées pour étiqueter les fichiers (par exemple, pays, produit, public)
* **Colonnes CSV/de feuille de calcul** lorsque la base de connaissances contient des données structurées

**Exemple : filtrer par métadonnées personnalisées**

Si vous avez étiqueté des études de cas clients avec un champ de métadonnées personnalisées `country` , vous pouvez appliquer un filtre pour récupérer uniquement les études de cas d’une région donnée :

<figure><img src="https://344527547-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>Filtrez les enregistrements par métadonnées ou par colonnes CSV.</p></figcaption></figure>

{% hint style="success" %}
**Filtrage dynamique**

Utilisez les entrées du workflow pour rendre les filtres dynamiques. Par exemple, définissez le filtre sur `country` est égal à `{{input.region}}` et le workflow récupérera les fichiers correspondant à la région transmise lors de son exécution.
{% endhint %}

Pour que le filtrage soit efficace, nous vous recommandons de consulter la documentation sur les [métadonnées des bases de connaissances](https://docs.airops.com/docs/fr/contexte/knowledge-bases/knowledge-base-metadata.md) afin d’apprendre à ajouter des balises de métadonnées personnalisées aux fichiers de votre base de connaissances.

## Résultat de l’étape de lecture de base de connaissances

L’étape de lecture de base de connaissances renvoie une liste de documents et leurs enregistrements respectifs. Dans notre exemple précédent de produits filtrés, le résultat se présentera ainsi :

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

Vous pouvez remarquer que :

* Seuls les documents sélectionnés dans la liste déroulante sont renvoyés.
* Chaque document contient une liste d’enregistrements. Comme il s’agit de fichiers CSV, chaque enregistrement correspond à une ligne différente.
* Seuls les enregistrements correspondant aux filtres sélectionnés sont renvoyés (United Kingdom et UnitPrice < 3).
* Il existe un champ spécial "\_\_text" qui indique le texte indexé pour la recherche sélectionné lors de l’importation du fichier CSV. Dans ce cas, seules les colonnes "Description" et "Country" ayant été sélectionnées comme champs de recherche, ce sont celles qui sont intégrées au champ "\_\_text".

Voici un exemple de résultat obtenu lors de la récupération d’un document 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"
        ],
      }
    ]
  }
]
```

## Utiliser la sortie de l’étape pour effectuer du RAG

Nous pouvons transmettre la sortie de l’étape de récupération de la base de connaissances à une étape LLM pour effectuer une génération augmentée par récupération.

En reprenant notre exemple de produits, nous pouvons récupérer la liste complète des produits et la transmettre à une étape LLM comme ceci :

<figure><img src="https://344527547-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>Transmettez les enregistrements récupérés à une étape LLM.</p></figcaption></figure>

<figure><img src="https://344527547-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>Le LLM répond en s’appuyant sur les enregistrements récupérés.</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/fr/actions/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.
