Skip to main content
W&B Artifacts を使用すると、W&B run の入力および出力となるデータをトラッキングし、バージョン管理できます。たとえば、モデル トレーニングの run では、データセットを入力として受け取り、トレーニング済みモデルを出力として生成します。run にはハイパーパラメーター、メタデータ、メトリクスをログできます。さらに、アーティファクトを使用して、モデルのトレーニングに使用したデータセットを入力としてログ、トラッキング、バージョン管理できます。同様に、結果として得られたモデル チェックポイントも、別のアーティファクトを使用して出力として管理できます。

ユースケース

アーティファクトは、ML ワークフロー全体を通じて run の入力および出力として使用できます。データセットやモデル、さらには他のアーティファクトも、処理の入力として使用できます。
モデルのトレーニング、データ処理、モデル評価における入力と出力を示すアーティファクトのワークフロー図
以下のスニペットは、順番に実行することを前提としています。

アーティファクトを作成する

4行のコードでアーティファクトを作成します:
  1. W&B run を作成します。
  2. wandb.Artifact でアーティファクト オブジェクトを作成します。
  3. wandb.Artifact.add_file() で、モデルファイルやデータセットなどの1つ以上のファイルをアーティファクト オブジェクトに追加します。
  4. wandb.Run.log_artifact() でアーティファクトをW&Bにログします。
例えば、次のコードスニペットは、dataset.h5 というファイルを example_artifact というアーティファクトにログする方法を示しています:
  • アーティファクトの type は、W&B プラットフォーム上での表示方法に影響します。type を指定しない場合、デフォルトで unspecified になります。
  • ドロップダウンの各ラベルは、それぞれ異なる type パラメーターの値を表しています。上記のコードスニペットでは、アーティファクトの type は dataset です。
Amazon S3 バケットなどの外部オブジェクトストレージに保存されているファイルやディレクトリへの参照を追加する方法については、外部ファイルをトラッキングする ページを参照してください。

アーティファクトをダウンロードする

run にアーティファクトを入力としてマークしたい場合は、wandb.Run.use_artifact() メソッドを使用します。 前のコードスニペットに続いて、次のコード例は、以前に作成した example_artifact という名前のアーティファクトの使い方を示しています:
これはアーティファクト オブジェクトを返します。 次に、返されたオブジェクトを使用してアーティファクトのすべてのコンテンツをダウンロードします:
root パラメーター にカスタムのパスを渡すことで、アーティファクトを特定のディレクトリにダウンロードできます。アーティファクトをダウンロードする代替の方法や追加のパラメーターについては、アーティファクトのダウンロードと使用 のガイドを参照してください。

次のステップ

  • アーティファクトのバージョン管理と更新の方法について学びましょう。
  • オートメーションを使って、アーティファクトの変更をきっかけにダウンストリームのワークフローをトリガーしたり、Slack チャンネルに通知したりする方法について学びましょう。
  • トレーニング済みモデルを格納するスペースであるRegistryについて学びましょう。
  • Python SDK と CLI のリファレンスガイドもご覧ください。
最終更新日 2026年9月30日