Suivre et versionner des objets

Cette page explique comment publier, récupérer, supprimer et référencer des objets versionnés dans Weave. Consultez-la lorsque vous devez suivre des données structurées, comme des datasets, des modèles ou des prompts, d’un run à l’autre et dans le temps.

Objets

Un objet est une donnée versionnée et sérialisable. Weave versionne automatiquement les objets à chaque modification et en conserve un historique immuable. Les objets comprennent :

Datasets : collections d’exemples destinées à l’évaluation
Modèles : configurations et paramètres de votre logique LLM
Prompts : modèles de prompts versionnés

dataset = weave.Dataset(
    name="test-cases",
    rows=[
        {"input": "What is 2+2?", "expected": "4"},
        {"input": "What is the capital of France?", "expected": "Paris"},
    ]
)
weave.publish(dataset)

Publier un objet

La couche de sérialisation de Weave enregistre et versionne les objets.

Python
TypeScript

import weave
weave.init("your-team-name/your-project-name")
# Enregistrer une liste sous le nom 'cat-names'
weave.publish(['felix', 'jimbo', 'billie'], 'cat-names')

La prise en charge de la publication en TypeScript est limitée. Tous les objets ne sont pas pris en charge.

import * as weave from 'weave'

const client = await weave.init("your-team-name/your-project-name")

// Enregistrer un tableau sous le nom 'cat-names'
client.publish(['felix', 'jimbo', 'billie'], 'cat-names')

Lorsque vous enregistrez un objet sous un nom donné, Weave crée la première version de cet objet s’il n’existe pas encore.

Récupérer un objet

Une fois l’objet publié, vous pouvez le récupérer à l’aide de sa référence.

Python
TypeScript

weave.publish() renvoie une Ref. Appelez .get() sur n’importe quelle Ref pour récupérer l’objet.Vous pouvez également construire une réf., puis récupérer l’objet correspondant.

weave.init("your-team-name/your-project-name")
cat_names = weave.ref('cat-names').get()

Cette fonctionnalité n’est pas encore disponible en TypeScript.

Supprimer un objet

Si vous n’avez plus besoin d’une version spécifique d’un objet, vous pouvez la supprimer à l’aide de sa réf.

Python
TypeScript

Pour supprimer une version d’un objet, appelez .delete() sur la réf. de l’objet.

weave.init("your-team-name/your-project-name")
cat_names_ref = weave.ref('cat-names:v1')
cat_names_ref.delete()

Toute tentative d’accès à un objet supprimé renvoie une erreur. La résolution d’un objet qui fait référence à un objet supprimé renvoie un DeletedRef à la place de ce dernier.

This feature isn't available in TypeScript yet.

Construire des réf. d’objet

Les réf. identifient de manière unique un objet stocké et sa version. Les sections suivantes décrivent la structure de l’URI et les différentes façons de construire une réf. Dans Weave, une URI de réf. d’objet complète se présente comme suit :

weave:///[YOUR-TEAM-NAME]/[YOUR-PROJECT-NAME]/object/[OBJECT-NAME]:[OBJECT-VERSION]

[YOUR-TEAM-NAME] : entity Weights & Biases (nom d’utilisateur ou nom d’équipe)
[YOUR-PROJECT-NAME] : projet Weights & Biases
[OBJECT-NAME] : nom de l’objet
[OBJECT-VERSION] : un hash de version, une chaîne telle que v0 ou v1, ou un alias tel que :latest. Tous les objets possèdent l’alias :latest. Voir Organiser les versions d’objets avec des tags et des alias pour créer vos propres alias.

Vous pouvez construire des réf. de plusieurs manières :

weave.ref([NAME]) : récupère la version :latest d’un objet. Nécessite d’appeler weave.init(...).
weave.ref([NAME]:[VERSION]) : récupère la version spécifiée d’un objet. Nécessite d’appeler weave.init(...).
weave.ref([FULLY-QUALIFIED-REF-URI]) : récupère l’objet situé à l’URI de réf. d’objet complète indiquée. Ne nécessite pas d’appeler weave.init().

Organiser les versions d’objets avec des tags et des alias

Utilisez des tags et des alias pour étiqueter des versions spécifiques de n’importe quel objet Weave, notamment Dataset, Model, Prompt ou tout autre objet que vous publiez avec weave.publish. Ces étiquettes fonctionnent avec n’importe quel ObjectRef : les mêmes API s’appliquent donc à tous les types d’objets.

Alias : un nom unique qui pointe vers une seule version. Vous pouvez à tout moment déplacer un alias vers une autre version, ce qui le rend pratique pour des références stables comme production ou staging. Chaque objet dispose automatiquement d’un alias :latest qui pointe vers la version la plus récente.
Tag : une étiquette descriptive jointe à une version. Une version peut avoir plusieurs tags, et un même tag peut figurer sur plusieurs versions. Utilisez les tags pour catégoriser et filtrer les versions, par exemple reviewed ou passed-eval.

Pour connaître les caractères et les longueurs acceptés par les tags et les alias, consultez Règles de nommage. Pour résoudre un alias ou une version spécifique, ajoutez-le au nom de l’objet dans une réf. : L’exemple suivant publie deux versions d’un dataset, puis attribue et met à jour des tags et des alias sur chaque version.

import weave

client = weave.init("[YOUR-TEAM-NAME]/[YOUR-PROJECT-NAME]")

# Publier deux versions d’un objet.
dataset_v0 = weave.publish(
    weave.Dataset(name="test-cases", rows=[{"input": "ping", "expected": "pong"}]),
)
dataset_v1 = weave.publish(
    weave.Dataset(name="test-cases", rows=[{"input": "ping", "expected": "pong!"}]),
)

# Définir des alias sur une version.
client.set_aliases(dataset_v0, "staging")
client.set_aliases(dataset_v1, "production")

# Récupérer un objet à l’aide de son alias
dataset = weave.ref("test-cases:production").get()

# Lister tous les alias du projet.
client.list_aliases()

# --- Tags : étiquettes sur une version spécifique. ---

# Ajouter des tags à une version.
client.add_tags(dataset_v0, ["reviewed", "passed-eval"])
client.add_tags(dataset_v1, ["reviewed", "needs-improvement"])

# Obtenir les tags d’une version.
client.get_tags(dataset_v0)  # ["passed-eval", "reviewed"]

# Lister tous les tags distincts du projet.
client.list_tags()

Cette fonctionnalité n’est pas encore disponible dans le SDK TypeScript.

Règles de nommage

Les noms d’objets, les tags et les alias doivent respecter les règles suivantes. Weave rejette tout tag ou alias qui ne les respecte pas.

Nom	Longueur	Caractères autorisés	Autres règles
Nom d’objet	1 à 128 caractères	Lettres, chiffres, caractères de soulignement (`_`), points (`.`) et traits d’union (`-`)	Aucune
Tag	1 à 256 caractères	Lettres, chiffres, caractères de soulignement (`_`), traits d’union (`-`) et espaces	Les espaces ne peuvent figurer qu’entre les mots, et un seul à la fois. Un tag ne peut ni commencer ni se terminer par un espace.
Alias	1 à 128 caractères	Tout caractère sauf `/` et `:`	Ne peut pas être composé uniquement d’espaces. `latest` et les noms de version, tels que `v0` ou `v12`, sont réservés, car les réf. les utilisent pour sélectionner des versions.

Avant de publier un objet, le SDK Python vérifie son nom selon les règles suivantes et le réécrit si nécessaire :

Remplace chaque suite de caractères autres que des lettres, des chiffres, des caractères de soulignement et des points par un seul trait d’union.
Remplace chaque suite d’au moins deux points, caractères de soulignement ou traits d’union par un seul trait d’union.
Supprime les traits d’union et les caractères de soulignement en début et en fin de nom.
Si le nom dépasse encore 128 caractères, conserve les 128 premiers et journalise un avertissement.

S’il ne reste rien après la réécriture, weave.publish() lève une ValueError. La réf. renvoyée par weave.publish() contient le nom réécrit : utilisez donc ce nom pour récupérer l’objet : Le SDK TypeScript ne réécrit pas le nom que vous transmettez à client.publish(). Si le nom enfreint les règles de nommage des objets, la requête échoue. Pour connaître les limites de longueur des noms d’ops et des noms d’affichage des appels, consultez Limites de longueur des noms.

Weights & Biases

Guides

Intégrations

Référence

Assistance

Suivre et versionner des objets

Objets

Publier un objet

Récupérer un objet

Supprimer un objet

Construire des réf. d’objet

Organiser les versions d’objets avec des tags et des alias

Règles de nommage

​Objets

​Publier un objet

​Récupérer un objet

​Supprimer un objet

​Construire des réf. d’objet

​Organiser les versions d’objets avec des tags et des alias

​Règles de nommage

Objets

Publier un objet

Récupérer un objet

Supprimer un objet

Construire des réf. d’objet

Organiser les versions d’objets avec des tags et des alias

Règles de nommage