Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://wb-21fd5541-docs-2661.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Vos paramètres utilisateur vous permettent de gérer votre profil, l’équipe par défaut, les clés API, les alertes, les intégrations et d’autres options au niveau du compte. Cette page décrit chaque section des paramètres utilisateur et comment l’utiliser. Pour ouvrir vos paramètres utilisateur, accédez à la page de votre profil et sélectionnez votre icône utilisateur dans le coin supérieur droit. Dans le menu déroulant, choisissez Settings.

Profil

Dans la section Profil, vous pouvez gérer et modifier le nom de votre compte ainsi que votre établissement. Vous pouvez également ajouter, si vous le souhaitez, une biographie, un emplacement, un lien vers votre site web personnel ou celui de votre établissement, et téléverser une image de profil.

Modifiez votre introduction

Votre introduction apparaît en haut de votre profil et constitue un bon endroit pour vous présenter, ajouter des liens vers des projets ou partager des comptes associés. Pour modifier votre introduction, cliquez sur Edit en haut de votre profil. L’éditeur WYSIWYG qui s’ouvre prend en charge Markdown.
  1. Pour modifier une ligne, cliquez dessus. Pour gagner du temps, tapez / et choisissez Markdown dans la liste.
  2. Utilisez les poignées de déplacement d’un élément pour le déplacer.
  3. Pour supprimer un bloc, cliquez sur la poignée de déplacement, puis sur Delete.
  4. Pour enregistrer vos modifications, cliquez sur Save.
Votre introduction mise à jour est désormais visible sur votre profil.

Ajouter des badges de réseaux sociaux

Pour ajouter un badge de suivi pour le compte @weights_biases sur X, ajoutez un lien au format Markdown avec une balise HTML <img> pointant vers l’image du badge :
[![X: @weights_biases](https://img.shields.io/twitter/follow/weights_biases?style=social)](https://x.com/intent/follow?screen_name=weights_biases)
Dans une balise <img>, vous pouvez spécifier width, height, ou les deux. Si vous n’en spécifiez qu’un seul, les proportions de l’image sont conservées.

Équipe par défaut

Si vous êtes membre de plusieurs équipes, la section Équipe par défaut vous permet de configurer l’équipe par défaut à utiliser lorsqu’un run ou une trace Weave ne spécifie pas d’équipe. Si vous n’êtes membre que d’une seule équipe, cette équipe devient l’équipe par défaut et cette section n’apparaît pas. Les étapes pour définir votre équipe par défaut varient selon votre déploiement. Sélectionnez l’onglet correspondant à votre environnement.
À côté de Emplacement par défaut pour créer de nouveaux Projects, cliquez sur la liste déroulante, puis sélectionnez votre équipe par défaut.
Pour spécifier l’équipe par défaut lorsque vous exécutez un script dans un environnement automatisé, indiquez l’emplacement par défaut à l’aide de la variable d’environnement WANDB_ENTITY.

Équipes

La section Équipes répertorie toutes vos équipes.
  • Cliquez sur le nom d’une équipe pour accéder à sa page.
  • Si vous êtes autorisé à rejoindre d’autres équipes, cliquez sur Voir les équipes à côté de Nous avons trouvé des équipes que vous pouvez rejoindre.
  • Facultatif : Activez Masquer les équipes dans le profil public.
Pour créer ou gérer une équipe, voir Gérer les équipes.

Clés API

La section Clés API vous permet de gérer vos clés API personnelles pour vous authentifier auprès des services W&B. Dans cette section, vous pouvez consulter les clés existantes, en créer de nouvelles et révoquer celles dont vous n’avez plus besoin.

Consultez vos clés API

Le tableau des clés API affiche :
  • ID de la clé : La première partie de chaque clé API, utilisée pour l’identifier.
  • Nom : Un nom descriptif que vous avez donné lorsque vous avez créé la clé.
  • Créée le : La date de création de la clé.
  • Dernière utilisation : La date et l’heure de la dernière utilisation.
Pour des raisons de sécurité, le tableau n’affiche que l’ID de la clé (la première partie de la clé). La clé API secrète complète n’apparaît qu’une seule fois, au moment de sa création.
Pour filtrer la liste des clés API, saisissez une partie du nom de la clé ou de son ID.

Créer une nouvelle clé API

Pour créer une clé API, sélectionnez l’onglet Clé API personnelle ou Clé API de compte de service pour en savoir plus.
Pour créer une clé API personnelle liée à votre ID utilisateur :
  1. Connectez-vous à W&B, cliquez sur l’icône de votre profil, puis sur Paramètres utilisateur.
  2. Cliquez sur Create new API key.
  3. Saisissez un nom descriptif pour votre clé API.
  4. Cliquez sur Create.
  5. Copiez immédiatement la clé API affichée et stockez-la de manière sécurisée.
La clé API complète n’est affichée qu’une seule fois, au moment de sa création. Une fois la boîte de dialogue fermée, vous ne pourrez plus voir la clé API complète. Seul l’ID de la clé (la première partie de la clé) reste visible dans vos paramètres. Si vous perdez la clé API complète, vous devrez créer une nouvelle clé API.
Pour connaître les options de stockage sécurisé, voir Stocker les clés API en toute sécurité.

Supprimer une clé API

Supprimez une clé API lorsque vous n’en avez plus besoin ou si elle a pu être compromise. Pour révoquer l’accès en supprimant une clé API :
  1. Trouvez la clé que vous souhaitez supprimer dans le tableau des clés API.
  2. Cliquez sur le bouton Supprimer à côté de la clé.
  3. Confirmez la suppression.
W&B supprime la clé du tableau et vous ne pouvez plus l’utiliser pour vous authentifier.
La suppression d’une clé API révoque immédiatement l’accès de tous les scripts ou services qui utilisent cette clé. Avant de supprimer l’ancienne clé, assurez-vous d’avoir mis à jour tous les systèmes afin qu’ils utilisent une nouvelle clé.

Stockez et manipulez les clés API en toute sécurité

Les clés API donnent accès à votre compte W&B et doivent être protégées comme des mots de passe. Suivez ces bonnes pratiques :
  • Gestionnaire de secrets : Utilisez un système dédié de gestion des secrets, tel que AWS Secrets Manager, HashiCorp Vault, Azure Key Vault ou Google Secret Manager.
  • Gestionnaire de mots de passe : Utilisez une application de gestion de mots de passe fiable.
  • Trousseaux du système d’exploitation : Stockez les clés dans le Trousseau macOS, le Gestionnaire d’identifiants Windows ou le service de secrets Linux. Déconseillé en production.

Ce qu’il faut éviter

  • N’enregistrez jamais de clés API dans un système de gestion de versions comme Git.
  • Ne stockez pas de clés API dans des fichiers de configuration en texte brut.
  • Ne transmettez pas de clés API en ligne de commande, car elles seront visibles dans la sortie de commandes du système d’exploitation telles que ps.
  • Évitez de partager des clés API par e-mail, via le chat ou par d’autres canaux non chiffrés.
  • N’intégrez pas de clés API en dur dans votre code source.
Si une clé API est exposée, supprimez-la immédiatement de votre compte W&B et contactez l’assistance ou votre AISE.

Variables d’environnement

Lorsque vous utilisez des clés API dans votre code, transmettez-les via des variables d’environnement :
export WANDB_API_KEY="your-api-key-here"
Cette approche évite d’exposer les clés dans votre code source et facilite leur renouvellement si nécessaire.
Évitez de définir la variable d’environnement sur la même ligne que la commande, car elle sera visible dans la sortie de commandes système comme ps :
# Évitez cette pratique, qui peut exposer la clé API dans les gestionnaires de processus
export WANDB_API_KEY="your-api-key-here" ./my-script.sh

Compatibilité des versions du SDK

Les nouvelles clés API sont plus longues que les clés héritées. Lors de l’authentification avec des versions antérieures des SDK wandb ou weave, vous pouvez rencontrer une erreur liée à la longueur de la clé API. Solution : mettez à jour vers une version plus récente du SDK :
  • SDK wandb v0.22.3+
    pip install --upgrade wandb==0.22.3
    
  • SDK weave v0.52.17+
    pip install --upgrade weave==0.52.17
    
Si vous ne pouvez pas mettre à jour le SDK immédiatement, utilisez la variable d’environnement WANDB_API_KEY pour définir la clé API en guise de solution de contournement.

Fonctionnalités bêta

Dans la section Fonctionnalités bêta, vous pouvez, si vous le souhaitez, activer des modules complémentaires et des aperçus de produits en cours de développement. Sélectionnez le bouton de bascule à côté de la fonctionnalité bêta que vous souhaitez activer.

Alertes

Recevez des notifications lorsque vos runs se terminent ou plantent, ou définissez des alertes personnalisées avec wandb.Run.alert(). Vous recevez des notifications par e-mail ou dans Slack. Basculez l’interrupteur à côté du type d’événement pour lequel vous souhaitez recevoir des alertes :
  • Runs terminés : Vous avertit lorsqu’un run W&B se termine avec succès.
  • Run planté : Vous avertit lorsqu’un run ne parvient pas à se terminer.
Pour plus d’informations sur la configuration et la gestion des alertes, voir Envoyer des alertes avec wandb.Run.alert().

Intégration GitHub personnelle

Connectez un compte GitHub personnel afin que W&B puisse accéder aux ressources GitHub en votre nom. Pour connecter un compte GitHub :
  1. Sélectionnez le bouton Connect Github. W&B vous redirige vers une page d’autorisation OAuth.
  2. Dans la section Organization access, sélectionnez l’organisation à laquelle accorder l’accès.
  3. Sélectionnez Authorize wandb.
Votre compte GitHub personnel est maintenant lié à votre compte W&B.

Supprimer votre compte

Cliquez sur le bouton Supprimer le compte pour supprimer votre compte.
La suppression du compte est irréversible.

Stockage

La section Stockage indique l’espace de stockage total utilisé par votre compte sur les serveurs de W&B. Le plan de stockage par défaut est de 100 Go. Pour plus d’informations sur le stockage et la tarification, voir la page Tarification.