> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-feat-cli-docs-generator.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# モデルバージョンをリンクする

> モデル バージョンを登録されたモデルに、W&B アプリまたは Python SDK を使ってプログラム的にリンクします。

モデルのバージョンを W\&B App または Python SDK を使用してプログラムで登録済みのモデルにリンクします。

## プログラムでモデルをリンクする

[`link_model`](/ja/models/ref/python/run#link_model) メソッドを使用して、プログラムでモデルファイルを W\&B run にログし、それを [W\&B モデルレジストリ](/ja/./) にリンクします。

`<>`で囲まれた値を自分のものに置き換えることを忘れないでください:

```python theme={null}
import wandb

run = wandb.init(entity="<entity>", project="<project>")
run.link_model(path="<path-to-model>", registered_model_name="<registered-model-name>")
run.finish()
```

指定した `registered-model-name` パラメータの名前が既に存在しない場合、W\&B は登録済みのモデルを自動的に作成します。

例えば、既に "Fine-Tuned-Review-Autocompletion" という名前の登録済みモデル(`registered-model-name="Fine-Tuned-Review-Autocompletion"`)がモデルレジストリにあり、それにいくつかのモデルバージョンがリンクされているとします: `v0`、`v1`、`v2`。新しいモデルをプログラムでリンクし、同じ登録済みモデル名を使用した場合（`registered-model-name="Fine-Tuned-Review-Autocompletion"`）、W\&B はこのモデルを既存の登録済みモデルにリンクし、モデルバージョン `v3` を割り当てます。この名前の登録済みモデルが存在しない場合、新しい登録済みモデルが作成され、モデルバージョン `v0` を持ちます。

["Fine-Tuned-Review-Autocompletion" 登録済みモデルの一例をここでご覧ください](https://wandb.ai/reviewco/registry/model?selectionPath=reviewco%2Fmodel-registry%2FFinetuned-Review-Autocompletion\&view=all-models).

## インタラクティブにモデルをリンクする

インタラクティブにモデルレジストリまたはアーティファクトブラウザでモデルをリンクします。

<Tabs>
  <Tab title="Model Registry">
    1. [https://wandb.ai/registry/model](https://wandb.ai/registry/model) のモデルレジストリアプリに移動します。
    2. 新しいモデルをリンクしたい登録済みモデルの名前の横にマウスをホバーします。
    3. **View details** の横のミートボールメニューアイコン（三つの水平な点）を選択します。
    4. ドロップダウンメニューから **Link new version** を選択します。
    5. **Project** ドロップダウンからモデルを含むプロジェクトの名前を選択します。
    6. **Model Artifact** ドロップダウンからモデルアーティファクトの名前を選択します。
    7. **Version** ドロップダウンから登録済みモデルにリンクしたいモデルバージョンを選択します。

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541-feat-cli-docs-generator/odvsXuVtRq39LmE_/images/models/link_model_wmodel_reg.gif?s=0810c75943cd68a320f56c65ffcfd52f" width="2710" height="1806" data-path="images/models/link_model_wmodel_reg.gif" />
    </Frame>
  </Tab>

  <Tab title="Artifact browser">
    1. W\&B App でプロジェクトのアーティファクトブラウザに移動します: `https://wandb.ai/<entity>/<project>/artifacts`
    2. 左側のサイドバーで Artifacts アイコンを選択します。
    3. リストにあなたのモデルを表示したいプロジェクトを表示します。
    4. モデルのバージョンをクリックして、モデルレジストリにリンクします。
    5. 画面右側に表示されるモーダルから、**Select a register model** メニュードロップダウンから登録済みモデルを選択します。
    6. **Next step** をクリックします。
    7. （オプション）**Aliases** ドロップダウンからエイリアスを選択します。
    8. **Link to registry** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541-feat-cli-docs-generator/odvsXuVtRq39LmE_/images/models/manual_linking.gif?s=29551560afe758ee07266b2f869a8fcd" width="3106" height="1232" data-path="images/models/manual_linking.gif" />
    </Frame>
  </Tab>
</Tabs>

## リンクされたモデルのソースを表示する

リンクされたモデルのソースを表示する方法は2つあります: モデルがログされているプロジェクト内のアーティファクトブラウザと W\&B モデルレジストリです。

モデルレジストリ内の特定のモデルバージョンを、（そのモデルがログされているプロジェクト内に位置する）ソースモデルアーティファクトと接続するポインタがあります。ソースモデルアーティファクトにもモデルレジストリへのポインタがあります。

<Tabs>
  <Tab title="Model Registry">
    1. [https://wandb.ai/registry/model](https://wandb.ai/registry/model) でモデルレジストリに移動します。

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541-feat-cli-docs-generator/-vjxKu9fYIXeDZhD/images/models/create_registered_model_1.png?fit=max&auto=format&n=-vjxKu9fYIXeDZhD&q=85&s=0696be18ddc17286b95afc29e18e3d0d" width="2150" height="1282" data-path="images/models/create_registered_model_1.png" />
    </Frame>

    2. 登録済みモデルの名前の横で **View details** を選択します。
    3. **Versions** セクション内で調査したいモデルバージョンの横にある **View** を選択します。
    4. 右パネル内の **Version** タブをクリックします。
    5. **Version overview** セクション内に **Source Version** フィールドを含む行があります。**Source Version** フィールドはモデルの名前とそのバージョンを示しています。

    例えば、次の画像は `v0` モデルバージョンである `mnist_model` （**Source version** フィールド `mnist_model:v0` を参照）を登録済みモデル `MNIST-dev` にリンクしていることを示しています。

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541-feat-cli-docs-generator/odvsXuVtRq39LmE_/images/models/view_linked_model_registry.png?fit=max&auto=format&n=odvsXuVtRq39LmE_&q=85&s=0d2e93b7e39e5dab81d03f8aa1ae813c" width="2852" height="1192" data-path="images/models/view_linked_model_registry.png" />
    </Frame>
  </Tab>

  <Tab title="Artifact browser">
    1. W\&B App でプロジェクトのアーティファクトブラウザに移動します: `https://wandb.ai/<entity>/<project>/artifacts`
    2. 左側のサイドバーで Artifacts アイコンを選択します。
    3. アーティファクトパネルから **model** ドロップダウンメニューを展開します。
    4. モデルレジストリにリンクされたモデルの名前とバージョンを選択します。
    5. 右パネル内の **Version** タブをクリックします。
    6. **Version overview** セクション内に **Linked To** フィールドを含む行があります。**Linked To** フィールドは、登録済みモデルの名前とそれに属するバージョンを示しています（`registered-model-name:version`）。

    例えば、次の画像では、`MNIST-dev` という登録済みモデルがあります（**Linked To** フィールドを参照）。バージョン `v0` のモデルバージョン `mnist_model`（`mnist_model:v0`）が `MNIST-dev` 登録済みモデルを指しています。

    <Frame>
      <img src="https://mintcdn.com/wb-21fd5541-feat-cli-docs-generator/odvsXuVtRq39LmE_/images/models/view_linked_model_artifacts_browser.png?fit=max&auto=format&n=odvsXuVtRq39LmE_&q=85&s=57130c81ddb39952f899ea1ef515f320" width="3562" height="1396" data-path="images/models/view_linked_model_artifacts_browser.png" />
    </Frame>
  </Tab>
</Tabs>