> ## 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.

# Weave プロンプトをコレクションにリンクする

Weave プロンプト オブジェクトをコレクションにリンクして、Registry で AI プロンプトをトラッキングし、バージョン管理および管理を行います。プロンプト オブジェクトを[コレクション](/ja/products/registry/create_collection)に*リンク*すると、プロンプトのバージョンが[非公開の project レベルのスコープから、共有の組織レベルのスコープ](/ja/products/registry/create_registry#visibility-types)に移動します。

<Note>
  始める前に、以下を確認してください。

  * コレクションで許可されるオブジェクトのタイプ。コレクションのタイプの詳細については、[コレクションを作成する](/ja/products/registry/create_collection)の "コレクションのタイプ" を参照してください。
  * コレクションが属する Registry がすでに存在すること。Registry が存在することを確認するには、[Registry App にアクセスし、検索](/ja/products/registry/search_registry)で Registry 名を探してください。
</Note>

AI プロンプトをトラッキングして管理するには、Weave Python SDK を使用します。Weave Python SDK を使用すると、プロンプト オブジェクトを作成してパブリッシュし、Registry 内のコレクションにリンクできます。

以下のステップでは、プロンプトを Registry 内のコレクションにリンクする方法を説明します。

1. `weave.init()` で Weave クライアントを初期化します。
2. [`weave.StringPrompt()`](/ja/products/wandb/weave/reference/python-sdk#class-stringprompt) などの組み込みプロンプト クラスで Weave プロンプト オブジェクトを作成します。
   <Tip>
     `weave.StringPrompt` は、システム プロンプト、ユーザー プロンプト、再利用可能なテキスト テンプレートなど、単一の string からなるプロンプト用の組み込みプロンプト クラスです。Weave でのプロンプト オブジェクトの作成と、サポートされるプロンプトのタイプの詳細については、[プロンプト オブジェクトを作成する](/ja/products/wandb/weave/guides/core-types/prompts)を参照してください。
   </Tip>
3. [`weave.publish()`](/ja/products/wandb/weave/reference/python-sdk#method-publish) でプロンプトを Weave にパブリッシュします。
4. [`weave_client.link_prompt_to_registry()`](/ja/products/wandb/weave/reference/python-sdk/trace/weave_client#method-link_prompt_to_registry) で、パブリッシュしたプロンプトのバージョンを Registry 内のコレクションにリンクします。リンク先のコレクションのパスを `target_path` パラメーターに渡します。パスは、接頭辞 `wandb-registry-`、Registry 名、コレクション名で構成されます。
   ```text theme={"system"}
   wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}
   ```

以下のコード スニペットを Python スクリプトにコピー＆ペーストし、`<>` で囲まれたプレースホルダーの値を実際の値に置き換えてください。

```python theme={"system"}
import weave

# Weave クライアントを初期化します
weave_client = weave.init(project="<project>")

prompt = "<You are a helpful assistant...>"

# プロンプト オブジェクトを Weave にパブリッシュします
weave_prompt_ref = weave.publish(
    obj=weave.StringPrompt(prompt),
    name="<prompt_name>",
)

# プロンプトのバージョンのリンク先となるコレクションと Registry を指定します
REGISTRY_NAME = "<registry_name>"
COLLECTION_NAME = "<collection_name>"
registry_target = f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"

# パブリッシュしたプロンプトのバージョンを、指定した Registry 内のコレクションにリンクします
weave_client.link_prompt_to_registry(
    prompt=weave_prompt_ref,
    target_path=registry_target,
)
```

<h2 id="view-linked-prompts-in-a-registry">
  Registry にリンクされたプロンプトを表示する
</h2>

1. [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/) の Registry にアクセスします。
2. プロンプトをリンクした Registry の名を選択します。
3. コレクションの名を選択します。
4. プロンプトのバージョンの一覧から、アクセスするバージョンを選択します。リンクされた各プロンプトのバージョンには、`v0` から始まるバージョン番号が段階的に割り当てられます。
5. プロンプトのバージョンの詳細を表示するには、そのバージョンをクリックします。このページのタブから、そのバージョンの概要、プロンプト、使用方法を表示できます。

<h2 id="use-a-prompt-linked-to-a-registry">
  Registry にリンクされたプロンプトを使用する
</h2>

`weave.get()` メソッドを使用して、Registry にリンクされたプロンプト オブジェクトを取得します。プロンプトはエイリアスまたはバージョン番号で取得できます。次のコード スニペットは、エイリアスとバージョン番号でプロンプトを取得する方法を示しています。

エイリアスでプロンプト オブジェクトを取得するには、次の URI パスを使用します。

```text theme={"system"}
registry:///{ORG}/{REGISTRY_NAME}/{COLLECTION_NAME}:{VERSION-OR-ALIAS}
```

`<>` で囲まれたプレースホルダーの値を、ご自身の値に置き換えてください。

<Tabs>
  <Tab title="エイリアスで取得">
    ```python theme={"system"}
    # エイリアスで取得
    URI_path = f"registry:///{ORG}/{REGISTRY_NAME}/{COLLECTION_NAME}:{ALIAS}"

    # エイリアスで取得
    prompt = weave.get(URI_path)

    # プロンプトを使用
    print(prompt.content)
    ```
  </Tab>

  <Tab title="バージョンで取得">
    ```python theme={"system"}
    # バージョンで取得
    URI_path = f"registry:///{ORG}/{REGISTRY_NAME}/{COLLECTION_NAME}:{VERSION}"

    # バージョンで取得
    prompt = weave.get(URI_path)

    # プロンプトを使用
    print(prompt.content)
    ```
  </Tab>
</Tabs>

W\&B は、プロンプト オブジェクトを取得するための URI パスとサンプルコードを自動生成します。サンプルコードを表示するには、次の手順に従ってください。

1. [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/) の Registry にアクセスします。
2. プロンプトをリンクした Registry の名を選択します。
3. コレクションの名を選択します。
4. プロンプトのバージョン一覧から、アクセスしたいバージョンを選択します。
5. **Use** タブを選択すると、エイリアスまたはバージョン番号でプロンプトを取得するためのサンプルコードが表示されます。


## Related topics

- [アーティファクトのバージョンをコレクションにリンクする](/ja/products/registry/link_version.md)