Modell in der Model Registry der Gemini Enterprise Agent Platform kopieren

Das Training Ihrer AutoML-, großen und benutzerdefinierten Modelle in der Agent Platform auf das gewünschte Niveau erfordert Zeit und ein wenig Probieren. Wenn Sie ein leistungsstarkes Modell haben, das Sie in einem anderen Projekt oder an einem anderen Standort verwenden möchten, ist das Trainieren eines neuen Modells nicht die beste Option. Das Modelltraining ist nicht deterministisch. Daher ist es unwahrscheinlich, dass Sie mit identischen Daten ein identisches Modell erhalten. Außerdem ist das Trainieren eines Modells in jeder Region oder jedem Projekt keine narrensichere Methode, um die konsistente Modellleistung in verschiedenen Regionen zu gewährleisten. Mit der Funktion „Modell kopieren“ in der Gemini Enterprise Agent Platform Model Registry können Sie ein Modell aus der Gemini Enterprise Agent Platform Model Registry an einen separaten Speicherort im selben oder in einem anderen Projekt kopieren.

Hinweis: Das Kopieren von Modellen unterstützt nicht das Kopieren von AutoML Natural Language- und BigQuery ML-Modellen.

Wenn Sie beim Kopieren eines Modells nicht die Modellversion angeben, die Sie kopieren möchten, wird die Standardmodellversion kopiert. Weitere Informationen zum Standardmodell oder zum Modellalias finden Sie unter Modellaliasse verwenden.

Beschränkungen

Wenn Sie ein Modell kopieren, werden nicht alle Modellinformationen kopiert. Folgendes wird nicht in das kopierte Modell übernommen:

• Versionsaliasse.
• Die benutzerdefinierte Modell-ID: Sie können eine neue ID angeben, sobald das Modell kopiert wurde.
• Alle vorhandenen Modellbewertungen.
• Verschlüsselungsspezifikationen Sie müssen den Verschlüsselungsschlüssel angeben, wenn Sie das Modell für Ihre Zielregion kopieren.
• Bereitstellungen und Batchinferenzen.

Beim projektübergreifenden Kopieren können Sie keine benutzerdefinierten Modelle kopieren, die ein Drittanbieter-Container-Image haben.

Modelle zwischen Projekten kopieren

Vorbereitung

Wenn Sie ein Modell in ein anderes Projekt kopieren möchten, muss der Inhaber des Quellmodells dem Zielprojekt zuerst die Berechtigung zum Exportieren des Modells erteilen:

Standard

1. Wählen Sie in der Google Cloud -Console Ihr Quellprojekt aus.
2. Rufen Sie die Seite IAM und Verwaltung auf.
3. Klicken Sie auf der Seite „IAM-Berechtigungen“ auf Zugriff erlauben. Daraufhin wird ein Pop-up-Fenster geöffnet, in dem Sie dem Quellprojekt ein neues Hauptkonto hinzufügen können.
4. Rufen Sie das produkt- und projektspezifische Dienstkonto (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com des Zielprojekts ab.
5. Fügen Sie das P4SA des Zielprojekts als neues Hauptkonto dem Quellprojekt hinzu und weisen Sie ihm die Rolle „Gemini Enterprise Agent Platform Service Agent“ zu.
6. Nachdem Sie auf Speichern geklickt haben, hat der P4SA des Zielprojekts die Berechtigung, Modelle aus dem Quellprojekt zu exportieren.

Hinweis :Wenn Sie dem P4SA des Zielprojekts die Berechtigung zum Exportieren von Modellen erteilen, kann jeder Nutzer mit Zugriff zum Hochladen von Modellen im anderen Projekt den Modellexportvorgang auslösen.

Benutzerdefiniertes Dienstkonto verwenden

1. Erstellen Sie ein benutzerdefiniertes Dienstkonto oder verwenden Sie ein vorhandenes. Dieses Dienstkonto muss zum Zielprojekt gehören, in das das Modell kopiert wird. Außerdem benötigen Sie die Berechtigung iam.serviceAccounts.actAs für dieses Dienstkonto.
2. Wählen Sie in der Google Cloud -Console Ihr Quellprojekt aus.
3. Rufen Sie die Seite IAM und Verwaltung auf.
4. Klicken Sie auf der Seite „IAM-Berechtigungen“ auf Zugriff erlauben. Daraufhin wird ein Pop-up-Fenster geöffnet, in dem Sie dem Quellprojekt ein neues Hauptkonto hinzufügen können.
5. Fügen Sie das benutzerdefinierte Dienstkonto als neues Hauptkonto zum Quellprojekt hinzu und weisen Sie ihm die Rolle Gemini Enterprise Agent Platform User oder eine beliebige benutzerdefinierte Rolle mit der Berechtigung aiplatform.models.export zu.
6. Nachdem Sie auf Speichern geklickt haben, hat das benutzerdefinierte Dienstkonto die Berechtigungen zum Exportieren von Modellen aus dem Quellprojekt.
7. Rufen Sie das produkt- und projektspezifische Dienstkonto (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com des Zielprojekts ab.
8. Weisen Sie dem P4SA des Zielprojekts die Rolle Service Account Token Creator für das benutzerdefinierte Dienstkonto zu.

Modelle zwischen Projekten kopieren:

REST

Hinweis :Fügen Sie das Feld customServiceAccount in den JSON-Anfragetext ein, wenn Sie ein benutzerdefiniertes Dienstkonto verwenden.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• DESTINATION_LOCATION: Region, in die Sie das Modell kopieren möchten. z. B. us-central1.
• DESTINATION_PROJECT_ID: Die Projekt-ID oder Projektnummer des Projekts, in das Sie das Modell kopieren möchten.
• SOURCE_PROJECT_ID: Ihre Projekt-ID oder Projektnummer
• SOURCE_LOCATION: Die Agent Platform-Region, aus der Sie ein Modell kopieren.
• SOURCE_MODEL_ID: Die Quelle der zu kopierenden Modell-ID.
• VERSION_ID: (Optional) ID der zu kopierenden Modellversion (wenn nicht angegeben, wird die Standardversion kopiert)

HTTP-Methode und URL:

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy

JSON-Text anfordern:

   {
    "sourceModel": "projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/models/SOURCE_MODEL_ID"
    }

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_ID/operations/OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
      "genericMetadata": {
        "createTime": "2022-07-01T00:10:55.621355Z",
        "updateTime": "2022-07-01T00:10:55.621355Z"
      }
    }
  }

Console

Folgen Sie der Anleitung unten, um Modelle in ein anderes Projekt zu kopieren.

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise Agent Platform Model Registry auf. Zur Model Registry der Gemini Enterprise Agent Platform
2. Wählen Sie in Model Registry das Menü Weitere Aktionen  für das Modell aus, das Sie kopieren möchten.
   
3. Klicken Sie auf Modell kopieren.
4. Wählen Sie entweder In ein anderes Projekt oder In eine andere Region aus.

Modell in ein anderes Projekt kopieren

1. Wählen Sie In ein anderes Projekt aus.
2. Wählen Sie die Modellversion aus, die Sie kopieren möchten.
3. Wählen Sie das Zielprojekt aus, in das Sie kopieren möchten.
4. Wählen Sie die Zielregion aus, z. B. us-central1.
5. Erweiterte Optionen: Optional können Sie die Verschlüsselungsmethode auswählen, indem Sie einen Google-owned and Google-managed encryption key - oder einen Cloud KMS-Schlüssel verwenden.

Modelle zwischen Standorten kopieren

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• DESTINATION_LOCATION: Die Region, in der Sie Vertex AI verwenden. z. B. us-central1.
• SOURCE_LOCATION: Die Vertex AI-Region, aus der Sie das Modell kopieren.
• PROJECT_ID: Ihre Projekt-ID oder Projektnummer
• MODEL_ID:ID des zu kopierenden Modells.
• VERSION_ID: (Optional) ID der zu kopierenden Modellversion (wenn nicht angegeben, wird die Standardversion kopiert)

HTTP-Methode und URL:

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy

JSON-Text anfordern:

{"sourceModel": "projects/PROJECT_ID/locations/SOURCE_LOCATION/models/MODEL_ID[@VERSION_ID]"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_ID/operations/OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
      "genericMetadata": {
        "createTime": "2022-07-01T00:10:55.621355Z",
        "updateTime": "2022-07-01T00:10:55.621355Z"
      }
    }
  }

Console

Beim regionenübergreifenden Kopieren können Sie ein Modell als neues Modell in die Zielregion oder als neue Version eines vorhandenen Modells in dieser Region kopieren.

Folgen Sie dieser Anleitung, um Modelle zu kopieren.

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise Agent Platform Model Registry auf. Zu Model Registry
2. Wählen Sie in Model Registry das Menü Weitere Aktionen  für das Modell aus, das Sie kopieren möchten.
   
3. Klicken Sie auf Modell kopieren.
4. Wählen Sie entweder In ein anderes Projekt oder In eine andere Region aus.

Modell in eine andere Region kopieren

1. Wählen Sie In eine andere Region aus.
2. Wählen Sie die Modellversion aus, die Sie kopieren möchten.
3. Wählen Sie entweder Als neues Modell kopieren oder Als neue Version kopieren aus.
4. Wählen Sie die Zielregion aus.
5. Fügen Sie den Namen oder die ID des Zielmodells hinzu. Wenn Sie ein Modell zum ersten Mal kopieren, wird ihm in der neuen Region der Standardalias zugewiesen.