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

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.
Le registre auquel appartient la collection existe déjà. Pour le vérifier, accédez à la Registry App et recherchez le nom du registre.

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 :

Initialisez un client Weave avec weave.init().
Créez un objet de prompt Weave à l’aide d’une classe de prompt intégrée, telle que weave.StringPrompt().
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.
Publiez le prompt vers Weave avec weave.publish().
Liez la version publiée du prompt à une collection d’un registre avec weave_client.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 :
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 :

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,
)

Afficher les prompts liés dans un registre

Accédez au Registry à l’adresse https://forge.coreweave.com/registry/.
Sélectionnez le nom du registre auquel vous avez lié le prompt.
Sélectionnez le nom de la collection.
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.
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.

Utiliser un prompt lié à un registre

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 :

registry:///{ORG}/{REGISTRY_NAME}/{COLLECTION_NAME}:{VERSION-OR-ALIAS}

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

Récupérer par alias
Récupérer par version

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

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

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 :

Accédez à Registry à l’adresse https://forge.coreweave.com/registry/.
Sélectionnez le nom du registre auquel vous avez lié le prompt.
Sélectionnez le nom de la collection.
Dans la liste des versions du prompt, sélectionnez la version à laquelle vous souhaitez accéder.
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.

​Afficher les prompts liés dans un registre

​Utiliser un prompt lié à un registre

Afficher les prompts liés dans un registre

Utiliser un prompt lié à un registre