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

# Lier un prompt Weave à une collection

Suivez, versionnez et gérez vos prompts d’IA dans le registre en liant des objets de prompt Weave à une collection. *Lier* un objet de prompt à une [collection](/fr/products/registry/create_collection) fait passer la version du prompt d’une [portée privée, au niveau du projet, à une portée partagée, au niveau de l’organisation](/fr/products/registry/create_registry#visibility-types).

<Note>
  Avant de commencer, vérifiez les points suivants :

  * Les types d’objets autorisés par la collection. Pour plus d’informations sur les types de collections, consultez la section « Collection types » de [Créer une collection](/fr/products/registry/create_collection).
  * Le registre auquel appartient la collection existe déjà. Pour le vérifier, accédez à la [Registry App et recherchez](/fr/products/registry/search_registry) le nom du registre.
</Note>

Pour suivre et gérer vos prompts d’IA, utilisez le SDK Python de Weave. Il vous permet de créer, de publier et de lier des objets de prompt à une collection d’un registre.

Pour lier un prompt à une collection d’un registre, procédez comme suit :

1. Initialisez un client Weave avec `weave.init()`.
2. Créez un objet de prompt Weave à l’aide d’une classe de prompt intégrée, telle que [`weave.StringPrompt()`](/fr/products/wandb/weave/reference/python-sdk#class-stringprompt).
   <Tip>
     `weave.StringPrompt` est une classe de prompt intégrée destinée aux prompts à chaîne unique, comme un prompt système, un prompt utilisateur ou un modèle de texte réutilisable. Pour plus d’informations sur la création d’objets de prompt dans Weave et sur les types de prompts pris en charge, consultez [Créer des objets de prompt](/fr/products/wandb/weave/guides/core-types/prompts).
   </Tip>
3. Publiez le prompt vers Weave avec [`weave.publish()`](/fr/products/wandb/weave/reference/python-sdk#method-publish).
4. Liez la version publiée du prompt à une collection d’un registre avec [`weave_client.link_prompt_to_registry()`](/fr/products/wandb/weave/reference/python-sdk/trace/weave_client#method-link_prompt_to_registry). Transmettez le chemin de la collection de destination au paramètre `target_path`. Ce chemin se compose du préfixe `wandb-registry-`, du nom du registre et du nom de la collection :
   ```text theme={"system"}
   wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}
   ```

Copiez-collez l’extrait de code suivant dans votre script Python, en remplaçant les valeurs d’espace réservé entre `<>` par les vôtres :

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

# Initialiser le client Weave
weave_client = weave.init(project="<project>")

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

# Publier l’objet de prompt dans Weave
weave_prompt_ref = weave.publish(
    obj=weave.StringPrompt(prompt),
    name="<prompt_name>",
)

# Indiquer la collection et le registre auxquels lier la version du prompt
REGISTRY_NAME = "<registry_name>"
COLLECTION_NAME = "<collection_name>"
registry_target = f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"

# Lier la version publiée du prompt à une collection du registre indiqué
weave_client.link_prompt_to_registry(
    prompt=weave_prompt_ref,
    target_path=registry_target,
)
```

<h2 id="view-linked-prompts-in-a-registry">
  Afficher les prompts liés dans un registre
</h2>

1. Accédez au Registry à l’adresse [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/).
2. Sélectionnez le nom du registre auquel vous avez lié le prompt.
3. Sélectionnez le nom de la collection.
4. Dans la liste des versions du prompt, sélectionnez la version à laquelle vous souhaitez accéder. Les numéros de version sont attribués de manière incrémentielle à chaque version de prompt liée, à partir de `v0`.
5. Pour afficher les détails d’une version de prompt, cliquez sur celle-ci. Les onglets de cette page vous permettent de consulter l’aperçu, le prompt et l’utilisation de cette version.

<h2 id="use-a-prompt-linked-to-a-registry">
  Utiliser un prompt lié à un registre
</h2>

Utilisez la méthode `weave.get()` pour récupérer un objet de prompt lié à un registre. Vous pouvez récupérer un prompt par son alias ou par son numéro de version. L’extrait de code suivant montre comment récupérer un prompt par son alias et par son numéro de version.

Pour récupérer un objet de prompt par son alias, utilisez le chemin d’URI suivant :

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

Remplacez les valeurs d’espace réservé entre `<>` par les vôtres :

<Tabs>
  <Tab title="Récupérer par alias">
    ```python theme={"system"}
    # Récupérer par alias
    URI_path = f"registry:///{ORG}/{REGISTRY_NAME}/{COLLECTION_NAME}:{ALIAS}"

    # Récupérer par alias
    prompt = weave.get(URI_path)

    # Utiliser le prompt
    print(prompt.content)
    ```
  </Tab>

  <Tab title="Récupérer par version">
    ```python theme={"system"}
    # Récupérer par version
    URI_path = f"registry:///{ORG}/{REGISTRY_NAME}/{COLLECTION_NAME}:{VERSION}"

    # Récupérer par version
    prompt = weave.get(URI_path)

    # Utiliser le prompt
    print(prompt.content)
    ```
  </Tab>
</Tabs>

W\&B génère automatiquement le chemin d’URI et l’exemple de code permettant de récupérer votre objet de prompt. Pour afficher l’exemple de code :

1. Accédez à Registry à l’adresse [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/).
2. Sélectionnez le nom du registre auquel vous avez lié le prompt.
3. Sélectionnez le nom de la collection.
4. Dans la liste des versions du prompt, sélectionnez la version à laquelle vous souhaitez accéder.
5. Sélectionnez l’onglet **Use** pour afficher l’exemple de code permettant de récupérer votre prompt par alias ou par numéro de version.