Skip to main content
W&B を使用して機械学習のワークフローでモデル アーティファクトをトラッキング、共有、管理するタイミングと方法を学びます。このページでは、実験のログ、report の生成、適切な W&B API を使用したログされたデータへのアクセスについて説明します。 このチュートリアルでは以下を使用します:
  • W&B Python SDK (wandb.sdk): トレーニング中の実験をログし、監視します。
  • W&B Public API (wandb.apis.public): ログされた実験データをクエリし、分析します。
  • W&B Reports and Workspaces API (wandb.wandb-workspaces): 検出結果をまとめる report を作成します。

サインアップしてAPIキーを作成する

W&B でマシンを認証するには、まず forge.coreweave.com/settings でAPIキーを発行する必要があります。APIキーをコピーし、安全に保管してください。

パッケージのインストールとインポート

W&B ライブラリと、この手順説明に必要なその他のパッケージをインストールします。
W&B Python SDK をインポートします:
次のコードブロックでチームの entity を指定します。

モデルをトレーニングする

次のコードは、モデルをトレーニングし、メトリクスをログし、モデルをアーティファクトとして保存するという、基本的な機械学習ワークフローをシミュレートします。 トレーニング中に W&B とやり取りするには、W&B Python SDK (wandb.sdk) を使用します。wandb.Run.log() を使用して損失をログし、wandb.Artifact を使用してトレーニング済みモデルをアーティファクトとして保存します。最後に、Artifact.add_file を使用してモデルファイルを追加します。
前のコードブロックの要点は次のとおりです。
  • wandb.Run.log() を使用して、トレーニング中にメトリクスをログします。
  • wandb.Artifact を使用して、モデル (データセットなど) をアーティファクトとして W&B の プロジェクト に保存します。
モデルをトレーニングし、アーティファクトとして保存したので、W&B の Registry にパブリッシュできます。wandb.Run.use_artifact() を使用して project からアーティファクトを取得し、モデルレジストリへのパブリッシュを準備します。wandb.Run.use_artifact() には、次の 2 つの主な役割があります。
  • project からアーティファクト オブジェクトを取得します。
  • アーティファクトを run への入力としてマークし、再現性と追跡可能性を確保します。詳細は、リネージマップの作成と表示を参照してください。

ダッシュボードでトレーニングデータを確認する

W&B ダッシュボードにアクセスします。Projects タブを選択し、my-awesome-project (または上記で使用したプロジェクト名) を検索します。これをクリックして、project のワークスペースを開きます。 ここでは、これまでに実行したすべての run の詳細を確認できます。このスクリーンショットでは、コードを数回再実行して複数の run を生成しており、それぞれにランダムに生成された run 名が付けられています。
run 名、メトリクス、ステータス情報を含む複数の run を表形式で表示した W&B プロジェクトページ

モデルを Registry にパブリッシュする

組織内の他のユーザーとモデルを共有するには、wandb.Run.link_artifact() を使用してコレクションにパブリッシュします。次のコードは、アーティファクトを Registry にリンクし、チームがアクセスできるようにします。
wandb.Run.link_artifact() を実行すると、モデル アーティファクトがRegistryの DemoModels コレクションに追加されます。そこから、バージョン履歴、リネージマップ、その他のメタデータなどの詳細を確認できます。 アーティファクトをRegistryにリンクする方法の詳細については、アーティファクトをRegistryにリンクするを参照してください。

推論用のモデル アーティファクトを Registry から取得する

モデルを推論に使用するには、wandb.Run.use_artifact() を使用して、パブリッシュされたアーティファクトを Registry から取得します。これによりアーティファクト オブジェクトが返されます。その後、wandb.Artifact.download() を使用して、アーティファクトをローカルファイルにダウンロードできます。
Registry からアーティファクトを取得する方法の詳細は、Registry からアーティファクトをダウンロードするを参照してください。 機械学習フレームワークによっては、重みを読み込む前にモデルのアーキテクチャを再作成する必要があります。具体的な手順は使用するフレームワークとモデルによって異なるため、読者自身で実装してください。

調査結果を report で共有する

W&B Report and Workspace API は public preview です。
作業をまとめるために report を作成して共有します。プログラムで report を作成するには、W&B Report and Workspace API を使用します。 まず、W&B Reports API をインストールします:
以下のコードブロックは、Markdown やパネルグリッドなど、複数のブロックで構成される report を作成します。ブロックを追加したり、既存のブロックの内容を変更したりして、report をカスタマイズできます。 コードブロックを実行すると、作成された report の URL へのリンクが出力されます。このリンクをブラウザーで開くと、report を表示できます。
詳細については、W&B App で report をプログラムで作成する方法やインタラクティブに作成する方法については、W&B Docs 開発者ガイドの Create a report を参照してください。

Registry をクエリする

W&B Public API を使用して、W&B の履歴データをクエリ、分析、管理します。これは、アーティファクトのリネージをトラッキングしたり、異なるバージョンを比較したり、モデルのパフォーマンスを分析したりするのに役立ちます。 次のコードブロックは、特定のコレクション内のすべてのアーティファクトについてモデルレジストリをクエリする方法を示しています。コレクションを取得し、そのバージョンを反復処理して、各アーティファクトの名とバージョンを出力します。
Registry をクエリする方法の詳細は、レジストリ項目をクエリする を参照してください。
最終更新日 2026年9月30日