classe wandb.Api
Arguments
overrides: vous pouvez définirbase_urlsi vous utilisez un serveur W&B autre quehttps://api.wandb.ai. Vous pouvez également définir des valeurs par défaut pourentity,projectetrun.timeout: délai d’expiration HTTP en secondes pour les requêtes API. S’il n’est pas spécifié, le délai d’expiration par défaut sera utilisé.api_key: clé API à utiliser pour l’authentification. Si elle n’est pas fournie, la clé API de l’Environnement actuel ou de la configuration sera utilisée. Demande une clé API si aucune n’est fournie ou configurée dans l’Environnement.
Exemples
Propriétés
propriété default_entity
Renvoie l’entité W&B par défaut.propriété user_agent
Renvoie l’agent utilisateur public de W&B.propriété viewer
Renvoie l’objet viewer.Méthodes
méthode Api.artifact()
Arguments
name: Le nom de l’artifact. Le nom d’un artifact ressemble à un chemin de fichier qui contient, au minimum, le nom du projet dans lequel l’artifact a été enregistré, le nom de l’artifact, ainsi que la version ou l’alias de l’artifact. Vous pouvez éventuellement ajouter en préfixe l’entité qui a enregistré l’artifact, suivie d’une barre oblique. Si aucune entité n’est spécifiée dans le nom, l’entité du run ou du paramètre de l’API est utilisée.type: Le type d’artifact à récupérer.
Exceptions levées
ValueError: Si le nom de l’artifact n’est pas spécifié.ValueError: Si le type d’artifact est spécifié, mais ne correspond pas au type de l’artifact récupéré.
Exemples
Dans les extraits de code suivants, « entity », « project », « artifact », « version » et « alias » sont des espaces réservés pour votre entité W&B, le nom du projet dans lequel se trouve l’artifact, le nom de l’artifact et la version de l’artifact, respectivement.méthode Api.artifact_collection()
ArtifactCollection renvoyé pour récupérer
des informations sur des artifacts spécifiques dans cette collection, entre autres.
Arguments
type_name: Le type de collection d’artifacts à récupérer.name: Un nom de collection d’artifacts. Vous pouvez éventuellement faire précéder ce nom de l’entité qui a enregistré l’artifact, suivie d’une barre oblique.
Exemples
Dans l’extrait de code ci-après, “type”, “entity”, “project” et “artifact_name” sont des valeurs fictives représentant respectivement le type de collection, votre entité W&B, le nom du projet dans lequel se trouve l’artifact et le nom de l’artifact.méthode Api.artifact_collection_exists()
Arguments
name: Nom d’une collection d’artifacts. Vous pouvez éventuellement ajouter comme préfixe l’entité qui a enregistré l’artifact, suivie d’une barre oblique. Si l’entité ou le projet n’est pas spécifié, déduisez la collection à partir des paramètres de substitution, s’ils existent. Sinon, l’entité est récupérée depuis les Paramètres utilisateur et le projet prendra par défaut la valeur “uncategorized”.type: Le type de la collection d’artifacts.
Exemples :
méthode Api.artifact_collections()
Arguments
project_name: Le nom du projet à utiliser pour le filtrage.type_name: Le nom du type d’artifact à utiliser pour le filtrage.order: Chaîne facultative permettant de spécifier l’ordre des résultats. Si elle est préfixée par ’+’, le tri est croissant (par défaut). Si elle est préfixée par ’-’, le tri est décroissant.per_page: Définit le nombre d’éléments par page pour la pagination de la requête. En général, il n’est pas nécessaire de modifier cette valeur.start: Curseur de pagination pour reprendre une requête précédente, capturé à partir de l’attribut.cursord’un paginateur précédent.
méthode Api.artifact_exists()
Arguments
name: Le nom de l’artifact. Ajoutez l’entité et le projet de l’artifact en préfixe. Ajoutez la version ou l’alias de l’artifact après un deux-points. Si l’entité ou le projet n’est pas spécifié, W&B utilise les paramètres d’override s’ils sont renseignés. Sinon, l’entité est récupérée à partir des paramètres utilisateur et le projet est défini sur “Uncategorized”.type: Le type d’artifact.
Exemples
Dans les extraits de code qui suivent, “entity”, “project”, “artifact”, “version” et “alias” sont des espaces réservés pour votre entité W&B, le nom du projet dans lequel se trouve l’artifact, le nom de l’artifact et la version de l’artifact, respectivement.méthode Api.artifact_type()
ArtifactType correspondant.
Arguments
type_name: Le nom du type d’artifact à récupérer.project: Si fourni, le nom d’un projet ou un chemin à utiliser comme filtre.
méthode Api.artifact_types()
Arguments
project: Le nom du projet ou le chemin à utiliser pour le filtrage.start: Curseur de pagination pour reprendre une requête précédente, capturé depuis l’attribut.cursord’un paginateur précédent.
méthode Api.artifact_versions()
Api.artifacts(type_name, name) à la place.
Arguments
type_name:name:per_page:
méthode Api.artifacts()
Artifacts.
Arguments
type_name: Le type d’artifacts à récupérer.name: Le nom de la collection de l’artifact. Vous pouvez éventuellement faire précéder ce nom de l’entité qui a enregistré l’artifact, suivie d’une barre oblique.order: Chaîne facultative permettant de spécifier l’ordre des résultats. Si elle est préfixée par ’+’, le tri est croissant (par défaut). Si elle est préfixée par ’-’, le tri est décroissant.per_page: Définit la taille de page pour la pagination des requêtes. En général, il n’y a aucune raison de modifier ce paramètre.tags: Renvoie uniquement les artifacts qui possèdent tous ces tags.start: Curseur de pagination pour reprendre une requête précédente, capturé à partir de l’attribut.cursord’un paginateur précédent.
Exemples
Dans l’extrait de code ci-après, “type”, “entity”, “project” et “artifact_name” sont des paramètres fictifs représentant respectivement le type d’artifact, l’entité W&B, le nom du projet dans lequel l’artifact a été enregistré et le nom de l’artifact..cursor du paginateur et en le passant à start= :
méthode Api.automation()
Arguments
name: Le nom de l’automatisation à récupérer.entity: L’entité pour laquelle récupérer l’automatisation.
Exceptions levées
ValueError: Si aucune ou plusieurs automatisations correspondent aux critères de recherche.
Exemples
Récupérer une automatisation existante nommée “my-automation” :méthode Api.automations()
Arguments
entity: L’entité pour laquelle récupérer les automatisations.name: Le nom de l’automatisation à récupérer.per_page: Le nombre d’automatisations à récupérer par page. La valeur par défaut est 50. En général, il n’y a aucune raison de modifier ce paramètre.start: Curseur de pagination permettant de reprendre une requête précédente, capturé à partir de l’attribut.cursord’un paginateur précédent.
Exemples
Récupérez toutes les automatisations existantes pour l’entité “my-team” :méthode Api.create_automation()
Arguments
obj: L’automatisation à créer.fetch_existing: Si True et qu’une automatisation en conflit existe déjà, tentez de récupérer l’automatisation existante au lieu de lever une erreur.kwargs:
Exemples
Créer une nouvelle automatisation nommée “my-automation” qui envoie une notification Slack lorsqu’un run d’un projet spécifique journalise une métrique dépassant un seuil personnalisé :méthode Api.create_custom_chart()
Arguments
entity: L’entité (utilisateur ou équipe) à laquelle appartient le graphiquename: Identifiant unique du préréglage de graphiquedisplay_name: Nom lisible affiché dans l’interface utilisateurspec_type: Type de spécification. Doit être “vega2” pour les spécifications Vega-Lite v2.access: Niveau d’accès au graphique :- “private”: Le graphique est accessible uniquement à l’entité qui l’a créé
- “public”: Le graphique est accessible publiquement
spec: La spécification Vega/Vega-Lite sous forme de dictionnaire ou de chaîne JSON
Exceptions levées
wandb.Error: Si la création du graphique échoueUnsupportedError: Si le serveur ne prend pas en charge les graphiques personnalisés
Exemples
méthode Api.create_project()
Arguments
name: Le nom du nouveau projet.entity: L’entité du nouveau projet.
méthode Api.create_registry()
Arguments
name: Le nom du registre. Le nom doit être unique au sein de l’organisation.visibility: La visibilité du registre. organization: Toute personne appartenant à l’organisation peut consulter ce registre. Vous pourrez modifier les rôles ultérieurement depuis les paramètres de l’interface utilisateur. restricted: Seuls les membres invités via l’interface utilisateur peuvent accéder à ce registre. Le partage public est désactivé.organization: L’organisation du registre. Si aucune organisation n’est définie dans les paramètres, l’organisation sera récupérée depuis l’entité si celle-ci n’appartient qu’à une seule organisation.description: La description du registre.artifact_types: Les types d’artifact acceptés par le registre. Un type ne doit pas dépasser 128 caractères ni inclure les caractères/ou:. Si ce paramètre n’est pas spécifié, tous les types sont acceptés. Les types autorisés ajoutés au registre ne peuvent pas être supprimés par la suite.
Exemples
méthode Api.create_run()
Arguments
run_id: L’ID à attribuer au run. S’il n’est pas spécifié, W&B génère un ID aléatoire.project: Le projet dans lequel enregistrer le run. Si aucun projet n’est spécifié, le run est enregistré dans un projet appelé “Uncategorized”.entity: L’entité propriétaire du projet. Si aucune entité n’est spécifiée, le run est enregistré dans l’entité par défaut.
méthode Api.create_run_queue()
Arguments
name: nom de la file d’attente à créertype: type de ressource à utiliser pour la file d’attente. L’une des valeurs suivantes : “local-container”, “local-process”, “kubernetes”,“sagemaker”, ou “gcp-vertex”.entity: nom de l’entité dans laquelle créer la file d’attente. SiNone, utiliser l’entité configurée ou l’entité par défaut.prioritization_mode: version du mode de priorisation à utiliser. Soit “V0”, soitNone.config: configuration de ressource par défaut à utiliser pour la file d’attente. Utiliser Handlebars (par ex.{{var}}) pour spécifier des variables de modèle.template_variables: dictionnaire des schémas des variables de modèle à utiliser avec la configuration.
méthode Api.create_team()
create_team().
Ce paramètre détermine l’organisation à laquelle la nouvelle équipe appartiendra.
Arguments
team: Le nom de l’équipe.admin_username: Le nom d’utilisateur de l’administrateur de l’équipe. Par défaut, il s’agit de l’utilisateur actuel.
méthode Api.create_user()
Arguments
email: L’adresse e-mail de l’utilisateur.admin: Définit l’utilisateur comme administrateur global de l’instance.
méthode Api.delete_automation()
Arguments
obj: l’automatisation à supprimer, ou son ID.
méthode Api.flush()
api.flush() pour obtenir les dernières valeurs associées au run.
méthode Api.from_path()
Arguments
path: Le chemin vers le projet, le run, le balayage ou le rapport
Exemples
Dans les extraits de code qui suivent, “project”, “team”, “run_id”, “sweep_id”, et “report_name” sont des espaces réservés désignant respectivement le projet, la équipe, le run ID, le sweep ID et le nom d’un rapport spécifique.méthode Api.integrations()
Arguments
entity: L’entité (par ex. le nom d’équipe) pour laquelle récupérer les intégrations. Si elle n’est pas fournie, l’entité par défaut de l’utilisateur sera utilisée.per_page: Nombre d’intégrations à récupérer par page. La valeur par défaut est 50. En général, il n’y a aucune raison de la modifier.start:
méthode Api.job()
Job.
Arguments
name: Le nom du job.path: Le chemin racine à partir duquel télécharger l’artifact du job.
méthode Api.list_jobs()
Arguments
entity: L’entité associée aux jobs listés.project: Le projet associé aux jobs listés.
méthode Api.organization()
Organisation correspondante.
Arguments
name: Nom de l’organisation. Si ce paramètre est omis, cette méthode tente de déterminer et de renvoyer l’organisation par défaut courante.
méthode Api.project()
projet portant le nom indiqué (et l’entité, si elle est renseignée).
Arguments
name: Le nom du projet.entity: Nom de l’entité demandée. Si la valeur estNone, l’entité par défaut transmise àApisera utilisée. S’il n’existe pas d’entité par défaut, uneValueErrorsera levée.
méthode Api.projects()
Arguments
entity: Nom de l’entité demandée. SiNone, utilise l’entité par défaut transmise àApi. S’il n’y a pas d’entité par défaut, lève uneValueError.per_page: Définit la taille de page pour la pagination des requêtes. En général, il n’est pas nécessaire de la modifier.
méthode Api.queued_run()
entity/project/queue_id/run_queue_item_id.
Arguments
entity:project:queue_name:run_queue_item_id:project_queue:priority:
méthode Api.registries()
Registry.
Utilisez cet itérateur pour rechercher et filtrer des registres, des collections,
ou des versions d’artifact dans le registre de votre organisation.
Arguments
organization: Organisation du registre à récupérer. Si elle n’est pas spécifiée, utilisez l’organisation indiquée dans les paramètres de l’utilisateur.filter: Filtre de type MongoDB à appliquer à chaque objet de l’itérateur différé du registre. Les champs disponibles pour filtrer les registres sontname,description,created_at,updated_at. Les champs disponibles pour filtrer les collections sontname,tag,description,created_at,updated_atLes champs disponibles pour filtrer les versions sonttag,alias,created_at,updated_at,metadataorder: Chaîne facultative permettant de spécifier l’ordre des résultats. Si elle est préfixée par ’+’, le tri est croissant (par défaut). Si elle est préfixée par ’-’, le tri est décroissant.per_page: Définit la taille de page pour la pagination des requêtes.start: Curseur de pagination pour reprendre une requête précédente, capturé à partir de l’attribut.cursord’un paginateur précédent.
Exemples
Trouver tous les registres dont le nom contient “model”.cursor du paginateur et en le passant à start= :
méthode Api.registry()
Arguments
name: Le nom du registre. Il ne comprend pas le préfixewandb-registry-.organization: L’organisation du registre. Si aucune organisation n’est définie dans la configuration, l’organisation sera récupérée à partir de l’entité si celle-ci n’appartient qu’à une seule organisation.
Exemples
Récupérer et mettre à jour un registreméthode Api.reports()
wandb.Api.reports() est en version bêta et changera probablement dans de prochaines versions.
Arguments
path: Chemin vers le projet dans lequel se trouve le rapport. Indiquez en préfixe l’entité qui a créé le projet, suivie d’une barre oblique.name: Nom du rapport demandé.per_page: Définit la taille de page pour la pagination des requêtes. Il n’y a généralement aucune raison de modifier cette valeur.
Exemples
méthode Api.run()
entity/project/run_id.
Arguments
path: chemin du run au formatentity/project/run_id. Siapi.entityest défini, il peut être au formatproject/run_id, et siapi.projectest défini, il peut simplement s’agir durun_id.
Exceptions levées
RunNotFoundError: Si une run est introuvable ou si ses données ne peuvent pas être chargées.
méthode Api.run_queue()
RunQueue nommée associée à l’entité.
Voir Api.create_run_queue pour plus d’informations sur la façon de créer une file d’attente de run.
Arguments
entity:name:
méthode Api.runs()
Runs, qui itère de façon différée sur les objets Run.
Les champs sur lesquels vous pouvez filtrer incluent :
createdAt: l’horodatage de création du run. (au format ISO 8601, par ex. “2023-01-01T12:00:00Z”)displayName: le nom d’affichage lisible du run. (par ex. “eager-fox-1”)duration: la durée totale d’exécution du run en secondes.group: le nom du groupe utilisé pour organiser des runs associés.host: le nom d’hôte sur lequel le run a été exécuté.jobType: le type de job ou le rôle du run.name: l’identifiant unique du run. (par ex. “a1b2cdef”)state: l’état actuel du run.tags: les tags associés au run.username: le nom d’utilisateur de l’utilisateur ayant lancé le run
config.experiment_name, summary_metrics.loss, etc.
Pour des filtres plus complexes, vous pouvez utiliser les opérateurs de requête MongoDB. Pour plus de détails, voir : https://docs.mongodb.com/manual/reference/operator/query Les opérations suivantes sont prises en charge :
$and$or$nor$eq$ne$gt$gte$lt$lte$in$nin$exists$regex
Arguments
path: (str) chemin vers le projet, doit être de la forme : “entity/project”filters: (dict) requêtes pour des runs spécifiques à l’aide du langage de requête MongoDB. Vous pouvez filtrer sur des propriétés du run telles que config.key, summary_metrics.key, state, entity, createdAt, etc. Par exemple :{"config.experiment_name": "foo"}trouverait les runs dont l’entrée de configuration pour le nom de l’expérience est définie sur “foo”order: (str) L’ordre peut êtrecreated_at,heartbeat_at,config.*.valueousummary_metrics.*. Si vous faites précéder l’ordre d’un +, le tri est croissant (par défaut). Si vous faites précéder l’ordre d’un -, le tri est décroissant. L’ordre par défaut est run.created_at, du plus ancien au plus récent.per_page: (int) Définit la taille de page pour la pagination des requêtes.include_sweeps: (bool) Indique s’il faut récupérer de manière anticipée l’objet balayage dans chaque résultat de run.lazy: (bool) Indique s’il faut utiliser le chargement différé pour de meilleures performances. Quand True (par défaut), seules les métadonnées essentielles du run sont chargées initialement. Les champs volumineux comme config, summaryMetrics et systemMetrics sont chargés à la demande lors de l’accès. Définissez cette option sur False pour charger toutes les données d’emblée.
Exemples
méthode Api.slack_integrations()
Arguments
entity: L’entité (par ex. le nom d’équipe) pour laquelle récupérer les intégrations. Si elle n’est pas fournie, l’entité par défaut de l’utilisateur sera utilisée.per_page: Nombre d’intégrations à récupérer par page. La valeur par défaut est 50. En général, il n’y a aucune raison de la modifier.start:
Exemples
Obtenez toutes les intégrations Slack enregistrées pour l’équipe “my-team” :méthode Api.sweep()
entity/project/sweep_id.
Arguments
path: Chemin vers le balayage au format entity/project/sweep_id. Siapi.entityest défini, ce chemin peut être au format project/sweep_id et, siapi.projectest défini, il peut simplement s’agir de sweep_id.
méthode Api.sync_tensorboard()
Arguments
root_dir:run_id:project:entity:
méthode Api.team()
Team correspondant au nom fourni.
Arguments
team: le nom de l’équipe.
méthode Api.update_automation()
Arguments
obj: L’automatisation à mettre à jour. Il doit s’agir d’une automatisation existante.create_missing: Si True et que l’automatisation n’existe pas, créez-la.kwargs:
Exemples
Désactivez et modifiez la description d’une automatisation existante (“my-automation”) :méthode Api.upsert_run_queue()
Arguments
name: Nom de la file d’attente à créerresource_config: Configuration de ressources par défaut, facultative, à utiliser pour la file d’attente. Utilisez des expressions Handlebars (par ex.{{var}}) pour spécifier des variables de modèle.resource_type: Type de ressource à utiliser pour la file d’attente. L’une des valeurs suivantes : “local-container”, “local-process”, “kubernetes”, “sagemaker” ou “gcp-vertex”.entity: Nom facultatif de l’entité pour laquelle créer la file d’attente. SiNone, utilisez l’entité configurée ou l’entité par défaut.template_variables: Dictionnaire des schémas de variables de modèle à utiliser avec la configuration.external_links: Dictionnaire facultatif de liens externes à utiliser avec la file d’attente.prioritization_mode: Version facultative de la priorisation à utiliser. Soit “V0”, soitNone
méthode Api.user()
api.viewer
pour récupérer votre propre objet utilisateur.
Arguments
username_or_email: Le nom d’utilisateur ou l’adresse e-mail de l’utilisateur.
méthode Api.users()
api.viewer
pour obtenir votre propre objet utilisateur.
Arguments
username_or_email: Le préfixe ou le suffixe de l’utilisateur que vous souhaitez trouver.
méthode Api.webhook_integrations()
Arguments
entity: L’entité (par ex. le nom d’équipe) pour laquelle récupérer les intégrations. Si elle n’est pas fournie, l’entité par défaut de l’utilisateur sera utilisée.per_page: Nombre d’intégrations à récupérer par page. La valeur par défaut est 50. En général, il n’y a aucune raison de la modifier.start: