Lier un prompt Weave à une collection

Suivez, versionnez et gérez vos prompts d’IA dans le W&B Registry en liant des objets de prompt Weave à une collection. Le fait de lier un objet de prompt à une collection déplace la version du prompt d’une portée privée à l’échelle du projet vers une portée partagée à l’échelle de l’organisation.

Avant de commencer, vérifiez les points suivants :

Les types d’objet autorisés par la collection. Pour plus d’informations sur les types de collection, voir “Types de collection” dans Créer une collection.
Le registre auquel appartient la collection existe déjà. Pour vérifier que le registre existe, accédez à la Registry App pour rechercher le nom du registre.

Pour suivre et gérer vos prompts d’IA, utilisez le SDK Python Weave. Le SDK Python Weave vous permet de créer, publier et lier des objets de prompt à une collection dans un registre. Les étapes suivantes expliquent comment lier un prompt à une collection dans un registre :

Initialisez un client Weave avec weave.init().
Créez un objet de prompt Weave avec une classe de prompt intégrée telle que weave.StringPrompt().
weave.StringPrompt est une classe de prompt intégrée pour les prompts à chaîne unique, tels qu’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 prompt pris en charge, voir Créer des objets prompt.
Publiez le prompt dans Weave avec weave.publish().
Liez la version publiée du prompt à une collection dans un registre avec weave_client.link_prompt_to_registry(). Transmettez le chemin de la collection de destination au paramètre target_path. Le 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 prompt vers Weave
weave_prompt_ref = weave.publish(
    obj=weave.StringPrompt(prompt),
    name="<prompt_name>",
)

# Spécifier 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 du prompt publiée à une collection dans le registre spécifié
weave_client.link_prompt_to_registry(
    prompt=weave_prompt_ref,
    target_path=registry_target,
)

Voir les prompts liés dans un registre

Accédez à W&B 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 voir les détails d’une version de prompt, cliquez sur la version. Dans les onglets de cette page, vous pouvez 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 à l’aide de son alias ou de son numéro de version. L’extrait de code suivant montre comment récupérer un prompt à l’aide de son alias et de son numéro de version. Pour récupérer un objet de prompt à l’aide de son alias, utilisez le chemin 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 un exemple de code pour récupérer votre objet de prompt. Pour afficher cet exemple de code :

Accédez au W&B Registry.
Sélectionnez le nom du registre auquel vous avez associé 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.

Guides

Intégrations

Référence

Voir les prompts liés dans un registre

Utiliser un prompt lié à un registre

​Voir les prompts liés dans un registre

​Utiliser un prompt lié à un registre

Voir les prompts liés dans un registre

Utiliser un prompt lié à un registre