Menyalin model di Model Registry Gemini Enterprise Agent Platform

Melatih AutoML, model besar, dan model kustom Anda di Agent Platform ke level yang Anda inginkan memerlukan waktu dan eksperimen. Jika Anda memiliki model berperforma baik yang ingin digunakan di project atau lokasi lain, melatih model baru bukanlah opsi terbaik. Pelatihan model bersifat non-deterministik, sehingga tidak mungkin Anda akan mendapatkan model yang identik dari data yang identik. Selain itu, melatih model di setiap region atau project bukanlah cara mudah untuk mempertahankan konsistensi perilaku model lintas region. Dengan fungsi salinan model Gemini Enterprise Agent Platform Model Registry, Anda dapat menyalin model dari Gemini Enterprise Agent Platform Model Registry ke lokasi terpisah dalam project yang sama atau ke project lain.

Catatan: Model penyalinan tidak mendukung penyalinan model AutoML bahasa alami dan BigQuery ML.

Saat melakukan penyalinan model, jika Anda tidak menentukan versi model yang ingin disalin, versi model default akan disalin. Untuk mempelajari default model atau alias model lebih lanjut, lihat Cara menggunakan alias model.

Batasan

Saat Anda menyalin model, tidak semua informasi model akan disalin. Model yang disalin tidak akan mempertahankan hal berikut:

• Alias versi.
• ID model kustom. Anda dapat menentukan ID baru setelah model disalin.
• Semua evaluasi model yang ada.
• Spesifikasi enkripsi. Anda harus menentukan kunci enkripsi saat menyalin model untuk region target.
• Deployment dan inferensi batch.

Untuk penyalinan lintas project, Anda tidak dapat menyalin model kustom yang memiliki image container pihak ketiga.

Menyalin model antar-project

Prasyarat

Untuk menyalin model di seluruh project, pemilik model sumber harus memberikan izin ekspor model ke project tujuan terlebih dahulu:

Default

1. Pilih project sumber Anda dari konsol Google Cloud .
2. Buka halaman IAM & Admin.
3. Di halaman izin IAM, klik Grant access dan jendela pop-up akan muncul untuk memungkinkan Anda menambahkan akun utama baru ke project sumber.
4. Dapatkan akun layanan per-produk, per-project (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com dari project tujuan.
5. Tambahkan P4SA project tujuan sebagai akun utama baru ke project sumber dan tetapkan peran Agen Layanan Gemini Enterprise Agent Platform ke akun utama tersebut.
6. Setelah mengklik Save, P4SA project tujuan akan memiliki izin untuk mengekspor model dari project sumber.

Catatan: Memberikan izin ekspor model ke P4SA project tujuan berarti siapa pun yang memiliki akses upload model di project lain dapat memicu proses ekspor model.

Menggunakan akun layanan kustom

1. Buat akun layanan kustom atau gunakan akun layanan yang sudah ada. Akun layanan ini harus menjadi milik project tujuan tempat model disalin dan Anda harus memiliki izin iam.serviceAccounts.actAs di akun layanan ini.
2. Pilih project sumber Anda dari konsol Google Cloud .
3. Buka halaman IAM & Admin.
4. Di halaman izin IAM, klik Grant access dan jendela pop-up akan muncul untuk memungkinkan Anda menambahkan akun utama baru ke project sumber.
5. Tambahkan akun layanan kustom sebagai akun utama baru ke project sumber dan tetapkan peran Gemini Enterprise Agent Platform User ke akun tersebut atau peran kustom apa pun dengan izin aiplatform.models.export.
6. Setelah mengklik Save, akun layanan kustom akan memiliki izin untuk mengekspor model dari project sumber.
7. Dapatkan akun layanan per-produk, per-project (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com dari project tujuan.
8. Berikan peran Service Account Token Creator kepada P4SA project tujuan di akun layanan kustom.

Menyalin model antar-project:

REST

Catatan: Tambahkan kolom customServiceAccount dalam isi JSON permintaan jika Anda menggunakan akun layanan kustom.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• DESTINATION_LOCATION: Region tempat Anda ingin menyalin model. Misalnya, us-central1
• DESTINATION_PROJECT_ID: Project ID atau nomor project tempat Anda ingin menyalin model.
• SOURCE_PROJECT_ID: Project ID atau nomor project Anda.
• SOURCE_LOCATION: Region Agent Platform tempat Anda menyalin model.
• SOURCE_MODEL_ID: Sumber ID model yang akan disalin.
• VERSION_ID: (Opsional) ID versi model yang akan disalin (jika tidak diberikan, versi default akan disalin)

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON yang mirip seperti berikut:

  {
    "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"
      }
    }
  }

Konsol

Gunakan petunjuk berikut untuk menyalin model ke project lain.

1. Di konsol Google Cloud , buka halaman Gemini Enterprise Agent Platform Model Registry. Buka Model Registry Gemini Enterprise Agent Platform
2. Dari Model Registry, pilih menu More actions untuk model yang ingin Anda salin.
   
3. Klik Copy model.
4. Pilih To another project atau To another region.

Menyalin model ke project lain

1. Pilih To another project.
2. Pilih versi model yang ingin Anda salin.
3. Pilih project tujuan yang ingin Anda salin.
4. Pilih region tujuan, misalnya, us-central1.
5. Advanced options: Opsional untuk memilih metode enkripsi, menggunakan Google-owned and Google-managed encryption key atau kunci Cloud Key Management Service.

Menyalin model antarlokasi

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• DESTINATION_LOCATION: Region tempat Anda menggunakan Agent Platform. Misalnya, us-central1
• SOURCE_LOCATION: Region Agent Platform tempat Anda akan menyalin model.
• PROJECT_ID: Project ID atau nomor project Anda.
• MODEL_ID:ID model yang akan disalin.
• VERSION_ID: (Opsional) ID versi model yang akan disalin (jika tidak diberikan, versi default akan disalin)

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON yang mirip seperti berikut:

  {
    "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"
      }
    }
  }

Konsol

Dengan salinan lintas region, Anda dapat menyalin model sebagai model baru dalam region target, atau sebagai versi baru dari model yang ada di region tersebut.

Gunakan petunjuk berikut untuk menyalin model.

1. Di konsol Google Cloud , buka halaman Gemini Enterprise Agent Platform Model Registry. Buka Model Registry
2. Dari Model Registry, pilih menu More actions untuk model yang ingin Anda salin.
   
3. Klik Copy model
4. Pilih To another project atau To another region.

Menyalin model ke region lain

1. Pilih To another region.
2. Pilih versi model yang ingin Anda salin.
3. Pilih Copy as new model atau Copy as new version.
4. Pilih region tujuan.
5. Tambahkan nama model atau ID model tujuan. Jika Anda menyalin model untuk pertama kalinya, model tersebut akan diberi alias default di region baru.