> 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/jp/xin-zhe/studio/data-recipe.md).

# Unslothデータレシピ

Unsloth Studio の Data Recipes では、PDF や CSV ファイルなどのドキュメントをアップロードして、使用可能な / 合成データセットに変換できます。グラフノードのワークフローで、データセットを視覚的に作成・編集できます。このガイドでは、Unsloth Data Recipes に入る前に、基本を紹介します。

<div data-with-frame="true"><figure><img src="/files/1e242ab6bcf04c0b9f709e28e6dc6e17fca1b887" alt=""><figcaption></figcaption></figure></div>

### Data Recipes の仕組み

Data Recipes も基本的には同じ流れです。レシピページを開き、レシピを作成するか選び、エディタでワークフローを組み立て、検証し、プレビューを実行してから、出力が問題なければフルデータセットを実行します。シードデータと生成ブロックを追加し、ワークフローを検証して、サンプル出力をプレビューし、最後にフルデータセットのビルドを実行します。Unsloth Data Recipes は次によって支えられています **NVIDIA NeMo** [**Data Designer**](https://github.com/NVIDIA-NeMo/DataDesigner).

<div data-with-frame="true"><figure><img src="/files/32c0d7501026a7267427f20ae93d1a1d8e08aced" alt=""><figcaption><p>データセット生成とモデルのファインチューニング例</p></figcaption></figure></div>

一見すると、通常のワークフローは次のようになります:

1. レシピページを開きます。
2. 新しいレシピを作成するか、既存のものを開きます。
3. ブロックを追加して、データセットのワークフローを定義します。
4. クリック **検証** して、設定の問題を早めに見つけます。
5. プレビューを実行して、サンプル行をすばやく確認します。
6. レシピの準備ができたら、フルデータセットのビルドを実行します。
7. 進捗と出力をグラフ上または **実行** ビューで詳細を確認します。
8. 結果のデータセットを **Unsloth** で選択して、モデルをファインチューニングします。

### 始める

レシピページは主な प्रवेश点です。レシピはブラウザ内にローカル保存されるため、保存した作業に後で戻れます。ここから、空のレシピを作成するか、ガイド付き学習レシピを開けます。

{% hint style="info" %}
レシピはエクスポートとインポートができるので、他の Unsloth ユーザーとワークフローを簡単に共有できます :tada:。特定のデータセットパターンを作りたい場合は、Unsloth Discord で質問してみてください。すでに共有できるレシピを持っている人がいるかもしれません。
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/7344d86f4f4769ef51f636329654de84eecf6a83" alt="" width="563"><figcaption><p>レシピのランディングページ</p></figcaption></figure></div>

ワークフローの概念に慣れていないなら、学習用レシピは、シードデータ、プロンプト、式、バリデーターが1つの動作する例でどう組み合わさるかを最速で確認できる方法です。すでに欲しいデータセットの形がわかっているなら、最初から空で始めるほうがたいてい早いです。

#### 開始パスを選ぶ

<table><thead><tr><th>次のような場合:</th><th>開始するもの:</th><th data-hidden></th></tr></thead><tbody><tr><td><sub><strong>カスタムワークフローをすばやく構築したい</strong></sub></td><td><sub><strong>空から始める</strong></sub></td><td></td></tr><tr><td><sub><strong>例から製品を学ぶ</strong></sub></td><td><sub><strong>学習用レシピから始める</strong></sub></td><td></td></tr><tr><td><sub><strong>前回の作業を続ける</strong></sub></td><td><sub><strong>保存済みレシピを開く</strong></sub></td><td></td></tr></tbody></table>

### エディタで作成するもの

エディタは、レシピが形になる場所です。ブロックシートからブロックを追加し、ダイアログで設定し、キャンバス上で接続し、最後にワークフローを検証または実行します。

<div data-with-frame="true"><figure><img src="/files/cf3df34ff6fe687b398c6250c7a57ea2ecadfe59" alt="" width="563"><figcaption><p>商品説明ワークフローを構築する例</p></figcaption></figure></div>

{% columns %}
{% column %}
エディタにはいくつかの主要部分があります:

* レシピヘッダー。ここでレシピ名を変更し、次の間を切り替えます **エディタ** と **実行**
* レシピグラフが表示されるキャンバス
* 新しいブロックを追加するブロックシート
* 設定ダイアログ。ここでプロンプト、参照、モデルエイリアス、バリデーター、シード設定を定義します。
* フローティング **実行します** と **検証** コントロール
* ここにはさらに追加する必要があります

{% endcolumn %}

{% column %}
Data Recipes で最も一般的なブロックは次のとおりです:

* **シード** Hugging Face の入力データ、ローカルの構造化ファイル、または行にチャンク化される非構造化ドキュメント用。
* **LLM + モデル** プロバイダー、モデル設定、LLM 生成ブロック、共有ツールプロファイル用。
* **式** LLM 呼び出しを必要としない Jinja2 ベースの変換用。
* **バリデーター** Python、SQL、JavaScript/TypeScript 用の組み込みリンターで、生成された不正なコードを除外するため。
* **サンプラー** カテゴリやサブカテゴリなどの決定的な列用。
  {% endcolumn %}
  {% endcolumns %}

### 参照の仕組み

データを生成するほとんどのブロックは（いくつかの例外を除き）後続のブロックで参照できる参照になります。これが Data Recipes の中心的な考え方の1つです。値は一度作成し、プロンプト、式、構造化出力、検証ステップで再利用します。

{% hint style="info" %}
Jinja 式は、レシピ内にすでに存在する値を扱うのに役立ちます。次のようなネストされたフィールドを参照できます `{{customer.first_name}}` 、値を結合する場合は `{{customer.first_name}} {{customer.last_name}}` 、次のようなパターンで条件ロジックを追加できます `{% if condition %}...{% endif %}`&#x20;
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/7e7cd342df57a0b001404c64d1f9b27c650d1060" alt="" width="563"><figcaption><p>エディタで表示される参照の例</p></figcaption></figure></div>

たとえば:

* という名前のカテゴリブロック `domain` は次のように参照できます `{{ domain }}`
* シード列は LLM プロンプトで直接使えます。シードデータ内の列（例: HF データセットの列、CSV）
* 構造化 LLM 出力は、後続のプロンプト用のフィールドを公開できます
* 式ブロックは、別のモデル呼び出しなしで前段の値を組み合わせられます

### その後は？

プレビュー実行は素早い反復のためのものです。エディタにサンプル行と分析を返すので、フル実行する前に生成データを確認できます。

フル実行では、永続化されたローカルデータセット成果物が作成されます。その出力は後で Unsloth のローカルデータセット選択画面に表示され、再確認してファインチューニングに使用できます。必要に応じて、データセットを Hugging Face リポジトリに公開することもできます。

### 主要な構成ブロック

{% columns %}
{% column %}

<div data-with-frame="true"><figure><img src="/files/9ee25c6ae48ab326e0fbc99ac91e6ad789d53330" alt="" width="188"><figcaption><p>主要な構成ブロック</p></figcaption></figure></div>
{% endcolumn %}

{% column %}

<div data-with-frame="true"><figure><img src="/files/3d0ec1704cfb2b1012068b94511a130c05c174b5" alt="" width="188"><figcaption><p>モデルと LLM ブロック</p></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

#### モデル設定は、次の2つの使いやすいレイヤーに分かれています:

* **モデルプロバイダー** エンドポイントと認証を定義します
* **モデル設定** モデル名と推論設定を定義します

この構成は、ホスト型プロバイダー、自前でホストするエンドポイント、 `vLLM` , `llama.cpp` 、または Unsloth の外で実行する任意の OpenAI 互換 API に対応します。

{% hint style="info" %}
レシピは1つのモデルに限定されません。複数の **モデルプロバイダー** と **モデル設定** ブロックを追加して、ステップごとに異なるモデルを使えます。たとえば、1つはコーディング用、別の1つは一般的なテキストタスク用にできます。
{% endhint %}

モデル設定の後は、4種類の LLM ブロックを使えます:

| ブロック     | 出力       | 最適用途                              |
| -------- | -------- | --------------------------------- |
| LLM テキスト | 自由形式テキスト | 指示、説明、会話、説明文                      |
| LLM 構造化  | JSON     | 固定フィールドと予測可能な構造が必要な出力             |
| LLM コード  | コード      | Python、SQL、TypeScript などのコード生成タスク |
| LLM ジャッジ | スコア付き評価  | 1つ以上のユーザー定義スコアで出力を採点              |

#### ツールプロファイル

{% columns %}
{% column %}
ツールプロファイルブロックは、1つ以上の LLM ブロックに共通の MCP ベースのツールアクセスを定義します。生成ステップでツールが必要な場合に使用します。たとえば、次を通じてコードドキュメントを参照する場合などです `Context7`.

左の画像は、Context7 MCP が追加され、ツールプロファイルブロックのダイアログで設定されている様子を示しています:
{% endcolumn %}

{% column %}

<div data-with-frame="true"><figure><img src="/files/eab65245f7e3d6de7068fc9b5a891075e78c552f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

#### バリデーター

{% columns %}
{% column %}
バリデーターブロックは主に LLM コードブロックを対象とし、生成されたコード出力をリンターと構文検証に通します。これにより、不正または無効なコード行をフィルタリングして最終データセットに入らないようにできます。組み込みオプションは Python、SQL、JavaScript/TypeScript の検証をカバーします。
{% endcolumn %}

{% column %}

<div data-with-frame="true"><figure><img src="/files/ce4f23aaa3ae3169c903d20a40ac8ed365db53a4" alt=""><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

### 検証、プレビュー、実行

レシピのワークフローが整ったら、次は実行です。推奨パターンは、まず検証し、次にプレビューで素早くフィードバックを得て、実行ビューで生成データを確認し、出力が計画に合っていると感じたらフルデータセットを実行することです。

実行コントロールを次の順序で使います:

{% stepper %}
{% step %}

#### 検証

クリック **検証** 設定の問題を見つけるために。
{% endstep %}

{% step %}

#### プレビュー

プレビューを実行して、サンプル行と分析を確認します
{% endstep %}

{% step %}

#### 改善

プロンプト、参照、シード設定、またはバリデーターを調整します。

生成データに満足できるまで反復します
{% endstep %}

{% step %}

#### フルデータセットのビルドを実行します

{% endstep %}
{% endstepper %}

<figure><img src="/files/7e3f4283b74218ef2a075e2d1c87ee5a36cc4064" 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://unsloth.ai/docs/jp/xin-zhe/studio/data-recipe.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.