Rotulagem de recursos pelos pipelines da Gemini Enterprise Agent Platform

Dependendo do tipo de componente, do recurso e da versão do SDK dos componentes do pipeline, os pipelines da Agent Platform propagam automaticamente os rótulos da execução do pipeline para os recursos gerados pelos componentes do pipeline ou exigem que você rotule os recursos gerados. Cloud de Confiance by S3NS Cloud de Confiance by S3NS No caso de componentes definidos pelo usuário, é necessário criar o código do componente para anexar os identificadores de uma variável de ambiente. Para mais informações, consulte Recursos gerados por componentes definidos pelo usuário.

Recursos com rotulagem automática

Os pipelines do Agent Platform rotulam automaticamente os seguintes recursos, seja qual for a versão do SDK dos componentes do pipeline: Cloud de Confiance by S3NS

Recursos CustomJob

Os pipelines do Agent Platform propagam automaticamente os rótulos da execução do pipeline para os recursos CustomJob. Isso é compatível com os seguintes componentes em todas as versões do Cloud de Confiance by S3NS SDK de componentes do pipeline:

Recursos com rotulagem automática no Cloud de Confiance by S3NS SDK dos componentes do pipeline v1.0.31 ou mais recente

Os pipelines da Agent Platform rotulam automaticamente os seguintes recursos, se você usa o Cloud de Confiance by S3NS SDK dos componentes do pipeline v1.0.31 ou mais recente:

Recursos BatchPredictionJob

Os pipelines do Agent Platform propagam automaticamente os rótulos da execução do pipeline para os recursos BatchPredictionJob gerados pelo componente ModelBatchPredictOp se você usa a versão 1.0.31 ou mais recente do Cloud de Confiance by S3NS SDK dos componentes do pipeline.

Recursos endpoint do Gemini Enterprise

Os pipelines do Agent Platform propagam automaticamente os rótulos da execução do pipeline para os recursos endpoint da API Gemini Enterprise gerados pelo componente EndpointCreateOp se você usa a versão 1.0.31 ou mais recente do Cloud de Confiance by S3NS SDK dos componentes do pipeline.

Recursos HyperparameterTuningJob

Os pipelines do Agent Platform propagam automaticamente os rótulos da execução do pipeline para os recursos HyperparameterTuningJob gerados pelo componente HyperparameterTuningJobRunOp se você usa a versão 1.0.31 ou mais recente do SDK dos componentes do pipeline. Cloud de Confiance by S3NS

Recursos do conjunto de dados da API Gemini Enterprise

Os pipelines da Agent Platform propagam automaticamente os rótulos da execução do pipeline para os recursos do conjunto de dados da API Gemini Enterprise gerados pelos seguintes componentes da API Gemini Enterprise se você usa a versão 1.0.31 ou mais recente do Cloud de Confiance by S3NS SDK dos componentes do pipeline:

Cloud de Confiance by S3NS Recursos de jobs do BigQuery

Os pipelines do Agent Platform propagam automaticamente os rótulos da execução do pipeline para os recursos de jobs do BigQuery gerados por qualquer um dos componentes do BigQuery ML, se você usar a versão 1.0.31 ou mais recente do Cloud de Confiance by S3NS SDK dos componentes do pipeline. Cloud de Confiance by S3NS

Cloud de Confiance by S3NS Recursos de jobs do Serviço Gerenciado para Apache Spark

Os pipelines do Agent Platform propagam automaticamente os rótulos da execução do pipeline para os recursos de jobs do Serviço Gerenciado para Apache Spark gerados por qualquer um dos componentes do Serviço Gerenciado para Apache Spark, se você usar a versão 1.0.31 ou mais recente do Cloud de Confiance by S3NS SDK dos componentes do pipeline. Cloud de Confiance by S3NS

Recursos TrainingPipeline e Model

Os pipelines da Agent Platform propagam automaticamente os rótulos da execução do pipeline para os recursos TrainingPipeline e Model gerados pelos seguintes componentes do AutoML se você usa a versão 1.0.31 ou mais recente do Cloud de Confiance by S3NS SDK dos componentes do pipeline:

Cloud de Confiance by S3NS Recursos de tabelas do BigQuery

Os pipelines do Agent Platform propagam automaticamente os rótulos da execução do pipeline Cloud de Confiance by S3NS para os recursos de tabelas do BigQuery gerados pelo componente ForecastingPreprocessingOp se você usa a versão 1.0.31 ou mais recente do Cloud de Confiance by S3NS SDK dos componentes do pipeline.

Recursos sem rotulagem automática

Os pipelines da Agent Platform não rotulam os seguintes recursos automaticamente, seja qual for a Cloud de Confiance by S3NS versão do SDK dos componentes do pipeline:

Cloud de Confiance by S3NS Recursos do Dataflow

Os pipelines do Agent Platform não rotulam automaticamente os recursos do Dataflow gerados pelo DataflowPythonJobOp componente. Você pode incluir instruções no código para rotular os recursos.

Use o exemplo de código a seguir para propagar os rótulos de faturamento da execução do pipeline para qualquer Cloud de Confiance by S3NS recurso do Dataflow gerado com o DataflowPythonJobOp componente:

  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:

Recursos gerados por componentes definidos pelo usuário

Os pipelines do Agent Platform não rotulam automaticamente os Cloud de Confiance by S3NS recursos gerados por componentes definidos pelo usuário. É possível incluir instruções no seu código para recuperar os rótulos da variável de ambiente VERTEX_AI_PIPELINES_RUN_LABELS e anexá-los aos Cloud de Confiance by S3NS recursos gerados usando o componente no ambiente de execução.

A variável de ambiente VERTEX_AI_PIPELINE_RUN_LABELS contém os rótulos no formato JSON como pares de chave-valor.

Por exemplo: { "label1_key": "label1_value", "label2_key": "label2_value", ...}

Se você estiver usando o SDK da Agent Platform para Python, use o exemplo de código a seguir no código do componente para propagar os rótulos da variável de ambiente para um novo recurso gerado pelo componente:

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"))
)

Substitua:

  • PROJECT_ID: o Cloud de Confiance by S3NS projeto que contém a execução do pipeline.

  • LOCATION: o local da execução do pipeline.

  • RESOURCE: Cloud de Confiance by S3NS recurso gerado pelo componente, por exemplo, CustomJob ou Model.

Também é possível usar o utilitário gcp_labels_util.attach_system_labels se você quiser usar o Python para analisar a variável de ambiente. Esse utilitário só poderá ser usado se você tiver acesso à biblioteca de componentes do Cloud de Confiance by S3NS pipeline e estiver usando o Python. Para mais informações, consulte o código-fonte da função utilitária no GitHub.

Recursos sem suporte de identificação

Os pipelines do Agent Platform não são compatíveis com a propagação do rótulo de faturamento para os seguintes recursos:

Recursos de ML Metadata

Os recursos do ML Metadata são faturados no nível da loja. Não é possível usar rótulos de faturamento para entender o custo no nível do recurso.

Recursos do Cloud Storage

Os pipelines da Agent Platform não propagam rótulos de faturamento para recursos do Cloud Storage, como buckets do Cloud Storage.

A seguir