Modell in der Gemini Enterprise Agent Platform Model Registry 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 zuverlässige Methode, um die Konsistenz des Modellverhaltens über Regionen hinweg aufrechtzuerhalten. Mit der Funktion zum Kopieren von Modellen in der Gemini Enterprise Agent Platform Model Registry können Sie ein Modell aus der Gemini Enterprise Agent Platform Model Registry an einen anderen Speicherort im selben Projekt oder in ein anderes Projekt kopieren.

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

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

Beschränkungen

Wenn Sie ein Modell kopieren, werden nicht alle Modellinformationen kopiert. Folgendes wird im kopierten Modell nicht beibehalten:

• Versionsaliasse.
• Die benutzerdefinierte Modell-ID: Sie können eine neue ID angeben, sobald das Modell kopiert wurde.
• Eine vorhandene Modellbewertung.
• 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 mit einem Container-Image eines Drittanbieters kopieren.

Modelle zwischen Projekten kopieren

Vorbereitung

Wenn Sie ein Modell projektübergreifend 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. Es wird ein Pop-up-Fenster angezeigt, 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 zum Quellprojekt hinzu und weisen Sie ihm die Rolle „Gemini Enterprise Agent Platform Service Agent“ zu.
6. Nachdem Sie auf Speichern geklickt haben, hat das 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, der im anderen Projekt Zugriff auf den Modellupload hat, den Modellexportprozess 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, und Sie benötigen 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. Es wird ein Pop-up-Fenster angezeigt, 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 benutzerdefinierte Rolle mit der Berechtigung aiplatform.models.export zu.
6. Nachdem Sie auf Speichern geklickt haben, hat das benutzerdefinierte Dienstkonto die Berechtigung, Modelle aus dem Quellprojekt zu exportieren.
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 im JSON-Anfragetext hinzu, 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, in die 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 dieser Anleitung, um ein Modell 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 der 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 Key Management Service-Schlüssel verwenden.

Modelle zwischen Standorten kopieren

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• DESTINATION_LOCATION: Die Region, in der Sie die Agent Platform verwenden. Beispiel: us-central1.
• SOURCE_LOCATION: Die Agent Platform-Region, aus der Sie das Modell kopieren.
• PROJECT_ID: Ihre Projekt-ID oder Projektnummer
• MODEL_ID:ID des Modells, das kopiert werden soll.
• 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

Mit einer regionenübergreifenden Kopie 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 der 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.