> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

> W&B を使用して OpenAI モデルをファインチューニングし、トレーニングメトリクスをログする、ジョブを監視する、モデル性能を経時的に比較するといった作業を行います。

# OpenAI ファインチューニング

export const ColabLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="colab-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01.21.03zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z" />
    </svg>
    Try in Colab
  </a>;

<ColabLink url="https://wandb.me/openai-colab" />

このページでは、OpenAI GPT-3.5 または GPT-4 モデルのファインチューニングのメトリクスと設定を W\&B にログする方法を説明します。W\&B を OpenAI のファインチューニング API と統合すると、ファインチューニングの実験、モデル、データセットを一か所でトラッキングし、結果を同僚と共有できます。OpenAI モデルをファインチューンする際に、実験管理を一元化し、トレーニングデータと生成されたモデルをバージョン管理したい場合は、このインテグレーションを使用してください。

<Note>
  ファインチューンできるモデルの一覧については、[OpenAI ドキュメント](https://platform.openai.com/docs/guides/fine-tuning/which-models-can-be-fine-tuned)を参照してください。
</Note>

ファインチューニング向けに W\&B を OpenAI と統合する方法の補足情報については、OpenAI ドキュメントの [W\&B Integration](https://developers.openai.com/cookbook/examples/third_party/gpt_finetuning_with_wandb) セクションを参照してください。

<h2 id="install-or-update-openai-python-api">
  OpenAI Python API のインストールまたは更新
</h2>

ファインチューニングの結果を同期する前に、互換性のあるバージョンの OpenAI Python クライアントがインストールされていることを確認してください。W\&B の OpenAI ファインチューニングインテグレーションは、OpenAI バージョン 1.0 以降に対応しています。[OpenAI Python API](https://pypi.org/project/openai/) ライブラリの最新バージョンについては、PyPI のドキュメントを参照してください。

OpenAI Python API をインストールするには、次のコマンドを実行します。

```bash theme={"system"}
pip install openai
```

OpenAI Python API がすでにインストールされている場合は、次のコマンドで更新します。

```bash theme={"system"}
pip install -U openai
```

<h2 id="sync-your-openai-fine-tuning-results">
  OpenAI のファインチューニング結果を同期する
</h2>

このセクションでは、OpenAI のファインチューニングジョブのメトリクスと設定を W\&B に送信し、他の実験と並べて確認できるようにする方法を説明します。そのためには、`wandb.integration.openai.fine_tuning` モジュールの `WandbLogger` クラスを使用します。

```python theme={"system"}
from wandb.integration.openai.fine_tuning import WandbLogger

# ファインチューニングの処理

WandbLogger.sync(fine_tune_job_id=FINETUNE_JOB_ID)
```

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/open_ai_auto_scan.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=9d681535cdda2798ca81208609ede18b" alt="OpenAI 自動スキャン機能" width="1557" height="735" data-path="products/wandb/_media/open_ai_auto_scan.png" />
</Frame>

<h3 id="sync-your-fine-tunes">
  ファインチューンを同期する
</h3>

スクリプトから結果を同期します。次の例では、1 行だけの最小限の呼び出しと、同期の動作を制御するために指定できるすべてのオプションのパラメーターの両方を示します。

```python theme={"system"}
from wandb.integration.openai.fine_tuning import WandbLogger

# 1 行で実行する場合
WandbLogger.sync()

# オプションのパラメーターを指定する場合
WandbLogger.sync(
    fine_tune_job_id=None,
    num_fine_tunes=None,
    project="OpenAI-Fine-Tune",
    entity=None,
    overwrite=False,
    model_artifact_name="model-metadata",
    model_artifact_type="model",
    **kwargs_wandb_init
)
```

<h3 id="reference">
  リファレンス
</h3>

次の表は、`WandbLogger.sync` が受け付ける各引数の説明です。

| 引数 | 説明 |
| - | - |
| `fine_tune_job_id` | `client.fine_tuning.jobs.create` でファインチューンジョブを作成したときに取得する OpenAI のファインチューニング ID です。この引数が `None` (デフォルト) の場合、W\&B はまだ同期されていないすべての OpenAI ファインチューンジョブを同期します。 |
| `openai_client` | 初期化済みの OpenAI クライアントを `sync` に渡します。クライアントを指定しない場合は、ロガーがクライアントを初期化します。デフォルトは `None` です。 |
| `num_fine_tunes` | ID を指定しない場合、W\&B は未同期のすべてのファインチューンをログします。この引数では、同期する最新のファインチューンの件数を指定できます。`num_fine_tunes` が 5 の場合、W\&B は最新の 5 件のファインチューンを選択します。 |
| `project` | W\&B がファインチューンのメトリクス、モデル、データなどをログするプロジェクト名です。デフォルトのプロジェクト名は `"OpenAI-Fine-Tune"` です。 |
| `entity` | run の送信先となる W\&B のユーザー名またはチーム名です。デフォルトでは、W\&B はデフォルトの entity (通常はユーザー名) を使用します。 |
| `overwrite` | 強制的にログを実行し、同じファインチューンジョブの既存の `wandb` run を上書きします。デフォルトは `False` です。 |
| `wait_for_job_success` | OpenAI のファインチューニングジョブは、開始から完了までに時間がかかります。ファインチューンジョブの完了後すぐに W\&B がメトリクスをログできるよう、この設定では 60 秒ごとにファインチューンジョブのステータスが `succeeded` に変わったかどうかを確認します。ファインチューンジョブが成功すると、W\&B はメトリクスを自動的に同期します。デフォルトは `True` です。 |
| `model_artifact_name` | ログされるモデル アーティファクトの名前です。デフォルトは `"model-metadata"` です。 |
| `model_artifact_type` | ログされるモデル アーティファクトのタイプです。デフォルトは `"model"` です。 |
| `**kwargs_wandb_init` | [`wandb.init()`](/ja/products/wandb/ref/python/functions/init) に直接渡される追加の引数です。 |

<h2 id="dataset-versioning-and-visualization">
  データセットのバージョン管理と可視化
</h2>

ファインチューニングジョブを同期すると、W\&B はトレーニングデータと検証データも取得します。これにより、データのバージョン管理やインタラクティブな探索が可能になります。以下のサブセクションでは、W\&B がトラッキングする内容と、その確認方法について説明します。

<h3 id="versioning">
  バージョン管理
</h3>

ファインチューニングのために OpenAI にアップロードしたトレーニングデータと検証データは、W\&B Artifacts として自動的にログされるため、バージョン管理が容易になります。次の画像は、Artifacts でトレーニングファイルを表示した例です。このファイルをログした W\&B run、ログされた日時、データセットのバージョン、メタデータ、そしてトレーニングデータからトレーニング済みモデルに至る DAG リネージを確認できます。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/openai_data_artifacts.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=fdffde1b7ccdc84eaacb60ef7df7f9cc" alt="トレーニングデータセットを含む W&B Artifacts" width="3342" height="1166" data-path="products/wandb/_media/openai_data_artifacts.png" />
</Frame>

<h3 id="visualization">
  可視化
</h3>

W\&B はデータセットを W\&B 表として可視化するため、データセットの探索や検索、インタラクティブな操作が可能です。次の画像は、W\&B 表で可視化したトレーニングサンプルの例です。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/openai_data_visualization.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=8afc52341cfc0247f4ca0ec2d5fdb07c" alt="OpenAI データ" width="2758" height="1294" data-path="products/wandb/_media/openai_data_visualization.png" />
</Frame>

<h2 id="the-fine-tuned-model-and-model-versioning">
  ファインチューニングしたモデルとモデルのバージョン管理
</h2>

OpenAI はファインチューニングしたモデルの基盤となる重みを公開していないため、W\&B は代わりにモデルのメタデータを取得してトラッキングします。OpenAI からは、ファインチューニングしたモデルの ID が提供されます。モデルの重みにはアクセスできないため、`WandbLogger` はモデルの詳細情報 (ハイパーパラメーター、データファイル ID など) を `fine_tuned_model` ID とあわせて `model_metadata.json` ファイルにまとめ、W\&B Artifactsとしてログします。

このモデル (メタデータ) アーティファクトは、[Registry](/ja/products/registry) 内のモデルにリンクできます。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/openai_model_metadata.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=590d049063991a49392df0c508ce99fa" alt="OpenAI モデルのメタデータ" width="3342" height="1512" data-path="products/wandb/_media/openai_model_metadata.png" />
</Frame>

<h2 id="frequently-asked-questions">
  よくある質問
</h2>

以下のセクションでは、OpenAI から同期したファインチューニングの run の共有、整理、復元に関するよくある質問にお答えします。

<h3 id="share-fine-tune-results-with-your-team">
  ファインチューンの結果をチームと共有する
</h3>

次のコードで、ファインチューンジョブをチームアカウントにログします。

```python theme={"system"}
WandbLogger.sync(entity="<your-team-name>")
```

<h3 id="organize-your-runs">
  run を整理する
</h3>

W\&B は run を自動的に整理します。ジョブタイプ、ベースモデル、学習率、トレーニングファイル名、その他のハイパーパラメーターなど、任意の設定パラメーターに基づいて run をフィルターしたり並べ替えたりできます。

また、run をリネームしたり、メモを追加したり、タグを作成して run をグループ化したりすることもできます。

満足のいく状態になったら、Workspace を保存し、それを使って report を作成しましょう。その際、run や保存済みのアーティファクト (トレーニングファイルと検証ファイル) からデータをインポートできます。

<h3 id="access-your-fine-tuned-model">
  ファインチューニングしたモデルにアクセスする
</h3>

W\&B は、ファインチューニングしたモデルのモデル ID を、アーティファクト (`model_metadata.json`) と設定の両方にログします。

```python theme={"system"}
import wandb
    
with wandb.init(project="OpenAI-Fine-Tune", entity="<your-team-name>") as run:
    ft_artifact = run.use_artifact("<entity>/<project>/model_metadata:<version>")
    artifact_dir = ft_artifact.download()
```

`<version>` プレースホルダーには、次のいずれかを指定します。

* `v2` などのバージョン番号
* `ft-xxxxxxxxx` などのファインチューニング ID
* `latest` などの自動的に追加されるエイリアス、または手動で追加したエイリアス

その後、ダウンロードした `model_metadata.json` ファイルを読み込むと、`fine_tuned_model` ID を取得できます。

<h3 id="recover-a-fine-tune-that-didnt-sync">
  同期されなかったファインチューンを復旧する
</h3>

ファインチューンが W\&B に正常にログされなかった場合は、`overwrite=True` を使用して、ファインチューンジョブ ID を渡します。

```python theme={"system"}
WandbLogger.sync(
    fine_tune_job_id="<fine-tune-job-id>",
    overwrite=True,
)
```

<h3 id="track-datasets-and-models-with-wb">
  W\&B でデータセットとモデルをトラッキングする
</h3>

W\&B は、トレーニングデータと検証データをアーティファクトとして自動的にログします。ファインチューニングしたモデルの ID などのメタデータも、アーティファクトとしてログします。

`wandb.Artifact` や `wandb.Run.log` などの低レベルの `wandb` API を使用して、パイプラインを制御することもできます。これにより、データとモデルの完全なトレーサビリティを確保できます。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/open_ai_faq_can_track.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=a6ea1cf3afb0100d8bf76103f9c46be8" alt="OpenAI のトラッキングに関する FAQ" width="1088" height="260" data-path="products/wandb/_media/open_ai_faq_can_track.png" />
</Frame>

<h2 id="resources">
  リソース
</h2>

より詳しい背景情報やエンドツーエンドのサンプルについては、以下のリソースを参照してください。

* [OpenAI ファインチューニング Documentation](https://platform.openai.com/docs/guides/fine-tuning/): 詳細なガイダンスとヒントを確認できます。
* [デモ Colab](https://wandb.me/openai-colab)
* [How to Fine-Tune Your OpenAI GPT-3.5 and GPT-4 Models with W\&B](https://wandb.me/openai-report) report


## Related topics

- [Azure OpenAI のファインチューニング](/ja/products/wandb/integrations/azure-openai-fine-tuning.md)
