Monitorare le esecuzioni e gli artefatti

Gli esperimenti della piattaforma agentica Gemini Enterprise supportano il monitoraggio sia delle esecuzioni sia degli artefatti. Le esecuzioni sono passaggi in un workflow ML che includono, a titolo esemplificativo, la pre-elaborazione dei dati, l'addestramento e la valutazione del modello. Le esecuzioni possono utilizzare artefatti come i set di dati e produrre artefatti come i modelli.

Crea artefatto

L'esempio seguente utilizza il metodo create della classe Artifact.

Python

from typing import Dict, Optional

from google.cloud import aiplatform


def create_artifact_sample(
    schema_title: str,
    project: str,
    location: str,
    uri: Optional[str] = None,
    resource_id: Optional[str] = None,
    display_name: Optional[str] = None,
    schema_version: Optional[str] = None,
    description: Optional[str] = None,
    metadata: Optional[Dict] = None,
):
    artifact = aiplatform.Artifact.create(
        schema_title=schema_title,
        uri=uri,
        resource_id=resource_id,
        display_name=display_name,
        schema_version=schema_version,
        description=description,
        metadata=metadata,
        project=project,
        location=location,
    )
    return artifact
  • schema_title: obbligatorio. Identifica il titolo dello schema utilizzato dalla risorsa.
  • project: . Puoi trovare questi ID nella Google Cloud console pagina di benvenuto.
  • location: consulta l'elenco delle località disponibili.
  • uri: facoltativo. URI della località dell'artefatto.
  • resource_id: facoltativo. La parte resource_id del nome dell'artefatto con il formato. Questo valore è univoco a livello globale in un metadataStore:
    projects/123/locations/us-central1/metadataStores/<metadata_store_id>/artifacts/<resource_id>.
  • display_name: facoltativo. Il nome della risorsa definito dall'utente.
  • schema_version: facoltativo. Specifica la versione utilizzata dalla risorsa. Se non viene impostato, per impostazione predefinita viene utilizzata la versione più recente.
  • description: facoltativo. Descrive lo scopo della risorsa da creare.
  • metadata: facoltativo. Contiene le informazioni sui metadati che verranno archiviate nella risorsa.

Avvia esecuzione

L'esempio seguente utilizza il metodo start_execution.

Python

from typing import Any, Dict, List, Optional

from google.cloud import aiplatform


def start_execution_sample(
    schema_title: str,
    display_name: str,
    input_artifacts: List[aiplatform.Artifact],
    output_artifacts: List[aiplatform.Artifact],
    project: str,
    location: str,
    resource_id: Optional[str] = None,
    metadata: Optional[Dict[str, Any]] = None,
    schema_version: Optional[str] = None,
    resume: bool = False,
):
    aiplatform.init(project=project, location=location)

    with aiplatform.start_execution(
        schema_title=schema_title,
        display_name=display_name,
        resource_id=resource_id,
        metadata=metadata,
        schema_version=schema_version,
        resume=resume,
    ) as execution:
        execution.assign_input_artifacts(input_artifacts)
        execution.assign_output_artifacts(output_artifacts)
        return execution
  • schema_title: identifica il titolo dello schema utilizzato dalla risorsa.
  • display_name: il nome della risorsa definito dall'utente.
  • input_artifacts: artefatti da assegnare come input.
  • output_artifacts: artefatti come output di questa esecuzione.
  • project: il tuo ID progetto. Puoi trovarli nella Google Cloud console pagina di benvenuto.
  • location: consulta l'elenco delle località disponibili.
  • resource_id: facoltativo. La parte resource_id del nome dell'artefatto con il formato. Questo valore è univoco a livello globale in un metadataStore: projects/123/locations/us-central1/metadataStores/<metadata_store_id>/artifacts/<resource_id>.
  • schema_version: facoltativo. Specifica la versione utilizzata dalla risorsa. Se non viene impostato, per impostazione predefinita viene utilizzata la versione più recente.
  • metadata: facoltativo. Contiene le informazioni sui metadati che verranno archiviate nella risorsa.
  • resume: bool.

    Nota: quando il parametro facoltativo resume è specificato come TRUE, viene ripresa l'esecuzione avviata in precedenza. Se non viene specificato, resume ha come valore predefinito FALSE e viene creata una nuova esecuzione.

Esempi di notebook