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

Affichez le contenu, les instructions d’utilisation et les détails du registre d’une version de prompt liée. Chaque version de prompt liée comporte les onglets suivants :

Onglet	Description
Overview	Affichez les détails de la version, tels que son chemin de registre, ses alias, ses tags, sa description, sa source et sa date de création.
Prompt	Affichez le contenu immuable du prompt. Selon le type de prompt, le contenu peut être une chaîne de caractères, un modèle paramétré ou une liste ordonnée de messages associés à des rôles tels que `system`, `user` et `assistant`.
Use	Affichez le code Python généré et l’URI du registre permettant de récupérer le prompt. L’URI peut référencer une version immuable, comme `:v4`, ou un alias réattribuable, comme `:production`. Utilisez directement l’objet de prompt renvoyé ou formatez-le avec des variables dans votre application.

Pour afficher un prompt lié dans un registre :

Accédez à Registry.
Sélectionnez le nom du registre auquel vous avez lié le prompt.
Sélectionnez le nom de la collection. La liste des versions de prompt de la collection se déploie.
Sélectionnez une version.

Les informations affichées pour une version de prompt liée diffèrent de celles affichées pour une version d’artifact liée.

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