Étiquetage de ressources par les pipelines Gemini Enterprise Agent Platform

Selon le type de composant, la ressource et la version du Cloud de Confiance by S3NS SDK des composants de pipeline, Agent Platform Pipelines propage automatiquement les étiquettes de votre exécution de pipeline aux ressources générées à partir des Cloud de Confiance by S3NS composants de pipeline ou vous oblige à étiqueter les ressources générées. Pour les composants définis par l'utilisateur, vous devez créer votre code de composant pour associer les étiquettes d'une variable d'environnement. Pour en savoir plus, consultez la section Ressources générées à partir de composants définis par l'utilisateur.

Ressources avec étiquetage automatique

Agent Platform Pipelines ajoute automatiquement des étiquettes aux ressources suivantes, quelle que soit la version du Cloud de Confiance by S3NS SDK des composants de pipeline :

Ressources CustomJob

Agent Platform Pipelines propage automatiquement les étiquettes de votre exécution de pipeline aux ressources CustomJob. Cette fonction est prise en charge par les composants suivants dans toutes les versions du Cloud de Confiance by S3NS SDK des composants de pipeline :

Ressources avec étiquetage automatique dans le Cloud de Confiance by S3NS SDK des composants de pipeline version 1.0.31 ou ultérieure

Agent Platform Pipelines ajoute automatiquement des étiquettes aux ressources suivantes si vous utilisez le Cloud de Confiance by S3NS SDK des composants de pipeline version 1.0.31 ou ultérieure :

Ressources BatchPredictionJob

Agent Platform Pipelines propage automatiquement les étiquettes de votre exécution de pipeline aux ressources BatchPredictionJob générées à partir du composant ModelBatchPredictOp si vous utilisez la version 1.0.31 ou une version ultérieure du Cloud de Confiance by S3NS SDK des composants de pipeline.

Ressources endpoint Gemini Enterprise

Agent Platform Pipelines propage automatiquement les étiquettes de votre exécution de pipeline aux ressources endpoint de l'API Gemini Enterprise générées à partir du composant EndpointCreateOp si vous utilisez la version 1.0.31 ou une version ultérieure du Cloud de Confiance by S3NS SDK des composants de pipeline.

Ressources HyperparameterTuningJob

Agent Platform Pipelines propage automatiquement les étiquettes de votre exécution de pipeline aux ressources HyperparameterTuningJob générées à partir du HyperparameterTuningJobRunOp si vous utilisez la version 1.0.31 ou une version ultérieure du Cloud de Confiance by S3NS SDK des composants de pipeline.

Ressources d'ensemble de données de l'API Gemini Enterprise

Agent Platform Pipelines propage automatiquement les étiquettes de votre exécution de pipeline aux ressources d'ensemble de données de l'API Gemini Enterprise générées à partir des composants suivants de l'API Gemini Enterprise si vous utilisez la version 1.0.31 ou une version ultérieure duSDK des composants de pipeline : Cloud de Confiance by S3NS

Cloud de Confiance by S3NS Ressources de job BigQuery

Agent Platform Pipelines propage automatiquement les étiquettes de votre exécution de pipeline aux Cloud de Confiance by S3NS ressources de job BigQuery générées à partir de l'un des composants BigQuery ML si vous utilisez la version 1.0.31 ou une version ultérieure du Cloud de Confiance by S3NS SDK des composants de pipeline.

Cloud de Confiance by S3NS Ressources de job Managed Service pour Apache Spark

Agent Platform Pipelines propage automatiquement les étiquettes de votre exécution de pipeline aux Cloud de Confiance by S3NS ressources de job Managed Service pour Apache Spark générées à partir de l'un des composants Managed Service pour Apache Spark si vous utilisez la version 1.0.31 ou une version ultérieure du Cloud de Confiance by S3NS SDK des composants de pipeline.

Ressources TrainingPipeline et Model

Agent Platform Pipelines propage automatiquement les étiquettes de votre exécution de pipeline aux ressources TrainingPipeline et Model générées à partir des composants AutoML suivants si vous utilisez la version 1.0.31 ou une version ultérieure du Cloud de Confiance by S3NS SDK des composants de pipeline :

Cloud de Confiance by S3NS Ressources de table BigQuery

Agent Platform Pipelines propage automatiquement les étiquettes de votre exécution de pipeline aux Cloud de Confiance by S3NS ressources de table BigQuery générées à partir du ForecastingPreprocessingOp composant si vous utilisez la version 1.0.31 ou une version ultérieure du Cloud de Confiance by S3NS SDK des composants de pipeline.

Ressources sans étiquetage automatique

Agent Platform Pipelines n'ajoute pas automatiquement d'étiquette aux ressources suivantes, quelle que soit la version du Cloud de Confiance by S3NS SDK des composants de pipeline :

Cloud de Confiance by S3NS Ressources Dataflow

Agent Platform Pipelines n'ajoute pas automatiquement d'étiquette aux ressources Dataflow générées par le DataflowPythonJobOp composant. Vous pouvez inclure des instructions dans votre code pour étiqueter les ressources.

Utilisez l'exemple de code suivant pour propager les étiquettes de facturation de votre exécution de pipeline à une ressource Cloud de Confiance by S3NS Dataflow générée à l'aide du composant DataflowPythonJobOp :

  import argparse
  import apache_beam as beam
  ...
  def run(argv=None):
    parser = argparse.ArgumentParser()
    # Don't add `--labels` to the argument list, so that they will be passed to the pipeline_options 
    parser.add_argument('--input', …)
    parser.add_argument('--output', …)
  ...
    known_args, pipeline_args = parser.parse_known_args(argv)
    pipeline_options = PipelineOptions(pipeline_args)
    with beam.Pipeline(options=pipeline_options) as p:

Ressources générées à partir de composants définis par l'utilisateur

Agent Platform Pipelines n'ajoute pas automatiquement d'étiquette aux Cloud de Confiance by S3NS ressources générées à partir de composants définis par l'utilisateur. Vous pouvez inclure des instructions dans votre code pour récupérer les étiquettes à partir de la variable d'environnement VERTEX_AI_PIPELINES_RUN_LABELS et les associer aux Cloud de Confiance by S3NS ressources générées à l'aide du composant lors de l'exécution.

La variable d'environnement VERTEX_AI_PIPELINE_RUN_LABELS contient les étiquettes au format JSON sous forme de paires clé/valeur.

Par exemple : { "label1_key": "label1_value", "label2_key": "label2_value", ...}

Si vous utilisez le SDK Agent Platform pour Python, utilisez l'exemple de code suivant dans votre code de composant pour propager les étiquettes de la variable d'environnement à une nouvelle ressource générée à partir du composant :

import os
import json
from google.cloud import aiplatform

aiplatform.init(
  project='PROJECT_ID',
  location='LOCATION'
)

aiplatform.RESOURCE.create(
  ...
  json.loads(os.getenv("VERTEX_AI_PIPELINES_RUN_LABELS"))
)

Remplacez les éléments suivants :

  • PROJECT_ID : projet contenant l'exécution du pipeline. Cloud de Confiance by S3NS

  • LOCATION : emplacement de l'exécution du pipeline.

  • RESOURCE: Cloud de Confiance by S3NS ressource générée à partir du composant, par exemple CustomJob ou Model.

Vous pouvez également utiliser l'utilitaire gcp_labels_util.attach_system_labels si vous souhaitez utiliser Python pour analyser la variable d'environnement. Vous ne pouvez utiliser cet utilitaire que si vous avez accès à la bibliothèque des Cloud de Confiance by S3NS composants de pipeline et que vous utilisez Python. Pour en savoir plus, consultez le code source de la fonction utilitaire dans GitHub.

Ressources sans prise en charge de l'étiquetage

Agent Platform Pipelines ne prend pas en charge la propagation des étiquettes de facturation vers les ressources suivantes :

Ressources de métadonnées de ML

Les ressources de métadonnées de ML sont facturées au niveau du magasin. Vous ne pouvez pas utiliser les étiquettes de facturation pour comprendre le coût au niveau des ressources.

Ressources Cloud Storage

Agent Platform Pipelines ne propage pas les libellés de facturation dans les ressources Cloud Storage, telles que les buckets Cloud Storage.

Étape suivante