> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/fr/nouveau/studio/data-recipe.md).

# Recettes de données Unsloth

Découvrez comment créer, construire et modifier des jeux de données avec les recettes de données d'Unsloth Studio.

Data Recipes d'Unsloth Studio vous permet de téléverser des documents comme des fichiers PDF ou CSV et de les transformer en jeux de données utilisables / synthétiques. Créez et modifiez visuellement des jeux de données via un flux de travail en graphe de nœuds. Ce guide vous permettra d’aborder les bases avant de plonger dans Unsloth Data Recipes.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FQ6e19jESrJg0VjHnX58c%2Fdata%20recipes%20final.png?alt=media&amp;token=8d74e453-815d-4790-83d1-76d0bc80a3ce" alt=""><figcaption></figcaption></figure></div>

### Comment fonctionne Data Recipes

Data Recipes suit le même parcours de base. Vous ouvrez la page des recettes, créez ou choisissez une recette, construisez le flux de travail dans l’éditeur, le validez, exécutez un aperçu, puis lancez le jeu de données complet une fois que le résultat semble correct. Ajoutez des données d’amorçage et des blocs de génération, validez le flux de travail, prévisualisez un exemple de sortie, puis lancez la création du jeu de données complet. Unsloth Data Recipes est propulsé par **NVIDIA NeMo** [**Data Designer**](https://github.com/NVIDIA-NeMo/DataDesigner).

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fc5m3JX1kUA3UwmdcJcxH%2FArea.gif?alt=media&amp;token=33bbd908-7d6c-456a-bc58-ce495c0adca1" alt=""><figcaption><p>Exemple de génération d’un jeu de données et de fine-tuning d’un modèle</p></figcaption></figure></div>

À première vue, un flux de travail habituel devrait ressembler à ceci :

1. Ouvrez la page des recettes.
2. Créez une nouvelle recette ou ouvrez-en une existante.
3. Ajoutez des blocs pour définir le flux de travail de votre jeu de données.
4. Cliquez sur **Valider** pour détecter rapidement les problèmes de configuration.
5. Exécutez un aperçu pour inspecter rapidement des lignes d’exemple.
6. Lancez une création complète du jeu de données lorsque la recette est prête.
7. Suivez la progression et la sortie en direct dans le graphe ou dans **Exécutions** vue pour plus de détails sur le mode.
8. Sélectionnez le jeu de données obtenu dans **Unsloth** et affinez un modèle.

### Commencer

La page des recettes est le point d’entrée principal. Les recettes sont stockées localement dans le navigateur, ce qui vous permet de revenir plus tard sur votre travail sauvegardé. Depuis ici, vous pouvez créer une recette vierge ou ouvrir une recette d’apprentissage guidée.

{% hint style="info" %}
Les recettes peuvent être exportées et importées, il est donc facile de partager des flux de travail avec d’autres utilisateurs d’Unsloth :tada:. Si vous essayez de construire un type de jeu de données précis, demandez sur le Discord d’Unsloth. Quelqu’un a peut-être déjà une recette à partager.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FAwKh7speKv3eXERFhPg2%2FScreenshot%202026-03-13%20at%2008.26.11.png?alt=media&amp;token=809ac83f-75c8-4ef2-9721-65971b3faaa5" alt="" width="563"><figcaption><p>Page d’accueil des recettes</p></figcaption></figure></div>

Si vous découvrez le concept des flux de travail, les recettes d’apprentissage sont le moyen le plus rapide de voir comment les données d’amorçage, les prompts, les expressions et les validateurs s’articulent dans un exemple fonctionnel. Si vous connaissez déjà la forme du jeu de données que vous voulez, partir de zéro est généralement plus rapide.

#### Choisissez un point de départ

<table><thead><tr><th>Si vous souhaitez :</th><th>Commencez avec :</th><th data-hidden></th></tr></thead><tbody><tr><td><sub><strong>Construire rapidement un flux de travail personnalisé</strong></sub></td><td><sub><strong>Commencer à vide</strong></sub></td><td></td></tr><tr><td><sub><strong>Apprendre le produit à partir d’un exemple</strong></sub></td><td><sub><strong>Commencer à partir d’une recette d’apprentissage</strong></sub></td><td></td></tr><tr><td><sub><strong>Continuer le travail précédent</strong></sub></td><td><sub><strong>Ouvrir une recette enregistrée</strong></sub></td><td></td></tr></tbody></table>

### Ce que vous construisez dans l’éditeur

L’éditeur est l’endroit où la recette prend forme. Vous ajoutez des blocs depuis la feuille de blocs, les configurez dans des boîtes de dialogue, les reliez sur le canevas, puis validez ou exécutez le flux de travail.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2F6A2uN85dkYAdP7v0eUyX%2Fworkflow.gif?alt=media&amp;token=b44d9682-1825-4ddb-88f6-485a2aea3359" alt="" width="563"><figcaption><p>Exemple de création d’un flux de travail de description de produit</p></figcaption></figure></div>

{% columns %}
{% column %}
L’éditeur comporte quelques éléments principaux :

* L’en-tête de la recette, où vous renommez la recette et basculez entre **Éditeur** et **Exécutions**
* Le canevas, où le graphe de la recette est affiché
* La feuille de blocs, où vous ajoutez de nouveaux blocs
* Les boîtes de dialogue de configuration, où vous définissez les prompts, les références, les alias de modèles, les validateurs et les paramètres d’amorçage.
* Les **Exécuter** et **Valider** commandes flottantes
* il faut ajouter plus ici

{% endcolumn %}

{% column %}
Les blocs les plus courants dans une recette sont :

* **Graine** pour les données d’entrée provenant de Hugging Face, de fichiers locaux structurés (ou de documents non structurés qui sont découpés en lignes.
* **LLM + Modèles** pour les fournisseurs, les configurations de modèle, les blocs de génération LLM et les profils d’outils partagés.
* **Expression** pour les transformations basées sur Jinja2 qui ne nécessitent pas d’appel à un LLM.
* **Validateurs** pour filtrer le code généré incorrect grâce à des linters intégrés pour Python, SQL et JavaScript/TypeScript.
* **Échantillonneurs** pour les colonnes déterministes telles que les catégories et sous-catégories.
  {% endcolumn %}
  {% endcolumns %}

### Comment fonctionnent les références

La plupart des blocs qui produisent des données (avec quelques exceptions) deviennent une référence pour les blocs ultérieurs. C’est l’une des idées principales derrière Data Recipes. Vous créez une valeur une fois, puis vous la réutilisez dans les prompts, les expressions, les sorties structurées et les étapes de validation.

{% hint style="info" %}
Les expressions Jinja vous aident à travailler avec des valeurs qui existent déjà dans la recette. Vous pouvez référencer des champs imbriqués comme `{{customer.first_name}}` , combiner des valeurs comme `{{customer.first_name}} {{customer.last_name}}` et ajouter une logique conditionnelle avec des motifs tels que `{% if condition %}...{% endif %}`&#x20;
{% endhint %}

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FNJYWKeIDC6aqgT2dShsB%2FScreenshot%202026-03-13%20at%2010.06.14.png?alt=media&amp;token=9d20bb8c-8a25-4395-9616-6429021d76f0" alt="" width="563"><figcaption><p>Exemple de références affichées dans l’éditeur</p></figcaption></figure></div>

Par exemple :

* Un bloc de catégorie nommé `domaine` peut être référencé comme `{{ domain }}`
* une colonne d’amorçage peut être utilisée directement dans un prompt LLM, les colonnes de vos données d’amorçage (par ex. colonnes d’un jeu de données HF, csv)
* une sortie LLM structurée peut exposer des champs pour les prompts ultérieurs
* un bloc d’expression peut combiner des valeurs antérieures sans autre appel au modèle

### Que se passe-t-il ensuite ?

Les exécutions d’aperçu servent à itérer rapidement. Elles renvoient des lignes d’exemple et des analyses dans l’éditeur afin que vous puissiez inspecter les données générées avant de lancer une exécution complète.

Les exécutions complètes créent un artefact de jeu de données local et persistant. Ce résultat apparaît ensuite dans le sélecteur de jeux de données local d’Unsloth, où vous pouvez l’inspecter à nouveau et l’utiliser pour le fine-tuning. Vous pouvez éventuellement publier votre jeu de données dans votre dépôt Hugging Face.

### Blocs de construction principaux

{% columns %}
{% column %}

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FuphMi76re2aUX7JvFNce%2FScreenshot%202026-03-13%20at%2011-35-45%20Unsloth%20Studio.png?alt=media&amp;token=674eb5ef-5acb-4b32-ab85-11a2af2e210f" alt="" width="188"><figcaption><p>Blocs de construction principaux</p></figcaption></figure></div>
{% endcolumn %}

{% column %}

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FsdoYKdurtGeu4YgVqu0q%2FScreenshot%202026-03-13%20at%2011-38-59%20Unsloth%20Studio.png?alt=media&amp;token=328c7ea6-591e-43fa-9e87-c71277a54736" alt="" width="188"><figcaption><p>Blocs de modèle et de LLM</p></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

#### La configuration du modèle est répartie en deux couches utilisables :

* **Fournisseur de modèle** définit le point de terminaison et l’authentification
* **Configuration du modèle** définit le nom du modèle et les paramètres d’inférence

Cette configuration fonctionne avec des fournisseurs hébergés, des points de terminaison auto-hébergés, `vLLM` , `llama.cpp` , ou toute API compatible OpenAI que vous exécutez en dehors d’Unsloth.

{% hint style="info" %}
Les recettes ne se limitent pas à un seul modèle. Vous pouvez ajouter plusieurs **Fournisseurs de modèle** et **Configuration du modèle** blocs, puis utiliser différents modèles pour différentes étapes, par exemple un pour le code et un autre pour les tâches de texte général.
{% endhint %}

Après la configuration du modèle, vous pouvez utiliser quatre types de blocs LLM :

| Bloc          | Sortie           | Idéal pour                                                               |
| ------------- | ---------------- | ------------------------------------------------------------------------ |
| Texte LLM     | Texte libre      | Instructions, explications, conversations et descriptions                |
| LLM structuré | JSON             | Sortie nécessitant des champs fixes et une structure prévisible          |
| Code LLM      | Code             | Python, SQL, TypeScript et autres tâches de génération de code           |
| LLM juge      | Évaluation notée | Noter les sorties avec une ou plusieurs notes définies par l’utilisateur |

#### Profils d’outils

{% columns %}
{% column %}
Les blocs de profil d’outil définissent un accès partagé aux outils basé sur MCP pour un ou plusieurs blocs LLM. Utilisez-les lorsqu’une étape de génération a besoin d’outils, par exemple pour consulter la documentation du code via `Context7`.

L’image à gauche montre Context7 MCP ajouté et configuré dans la boîte de dialogue du bloc Profil d’outil :
{% endcolumn %}

{% column %}

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fu4GbfrjuQyiU7cN15fDY%2FScreenshot%202026-03-13%20at%2010.50.01.png?alt=media&amp;token=889a9425-bb40-4e41-9dab-5408b03bd3ca" alt="" width="375"><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

#### Validateurs

{% columns %}
{% column %}
Le bloc Validateur cible principalement les blocs de code LLM en exécutant les sorties de code générées via un linter et une validation de syntaxe. Cela vous aide à exclure les lignes de code mauvaises ou invalides du jeu de données final en les filtrant. Les options intégrées couvrent la validation Python, SQL et JavaScript/TypeScript.
{% endcolumn %}

{% column %}

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FobyvYzcfyJkloHfHMyVC%2FScreenshot%202026-03-13%20at%2011-39-08%20Unsloth%20Studio.png?alt=media&amp;token=19c8dbfa-c876-4f6e-9e62-5b8df515dc7b" alt=""><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

### Valider, prévisualiser et exécuter

Une fois le flux de travail de la recette en place, l’étape suivante est l’exécution. Le schéma recommandé est : valider d’abord, prévisualiser pour obtenir un retour rapide et inspecter les données générées dans la vue des exécutions, puis lancer le jeu de données complet lorsque vous estimez que le résultat satisfait votre plan.

Utilisez les contrôles d’exécution dans cet ordre :

{% stepper %}
{% step %}

#### Valider

Cliquez sur **Valider** pour détecter les problèmes de configuration.
{% endstep %}

{% step %}

#### Prévisualiser

Exécutez un aperçu pour inspecter des lignes d’exemple et des analyses
{% endstep %}

{% step %}

#### Affiner

Affinez les prompts, les références, les paramètres d’amorçage ou les validateurs.

Itérez jusqu’à vous sentir satisfait des données générées
{% endstep %}

{% step %}

#### Lancez la création complète du jeu de données

{% endstep %}
{% endstepper %}

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FFCcEaVt8xsaNsMFi2MoZ%2Funsloth%20chef.png?alt=media&amp;token=0266aa36-4ba7-4364-be59-5fe57936ef7f" alt="" width="188"><figcaption></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://unsloth.ai/docs/fr/nouveau/studio/data-recipe.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.
