Mengekspor dan mengimpor model topik

Anda dapat mengekspor model yang telah dilatih untuk mencadangkannya. Anda dapat menggunakan cadangan ini untuk mengembalikan model yang ada atau mentransfer model ke project baru.

Catatan: Mengekspor dan mengimpor model hanya tersedia untuk model topik V2 atau yang lebih baru.

Mengekspor model

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut: permissions:

• contactcenterinsights.issueModels.export

Mengekspor model topik ke Cloud Storage memungkinkan Anda menyimpan salinan cadangan model sehingga Anda dapat memulihkannya nanti jika diperlukan.

REST

Untuk mengekspor model topik, panggil metode export pada resource issueModel.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID Anda.
• ISSUE_MODEL_ID: ID model topik yang akan diekspor.
• GCS_DESTINATION: Cloud Storage URI tempat model topik diekspor.

Catatan: Semua contoh menggunakan instance Customer Experience Insights global. Lihat Regionalisasi untuk mengetahui petunjuk tentang cara menggunakan instance regional.

Metode HTTP dan URL:

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels/ISSUE_MODEL_ID:export

Meminta isi JSON:

{ 
  gcs_destination: { 
    object_uri: 'GCS_DESTINATION'
  }
}

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://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels/ISSUE_MODEL_ID:export"

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://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels/ISSUE_MODEL_ID:export" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID"
}

Mengimpor model

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut: permissions:

• contactcenterinsights.issueModels.create
• contactcenterinsights.issueModels.import

Mengimpor model topik dari Cloud Storage memungkinkan Anda mengganti model topik yang ada atau membuat model topik baru berdasarkan model yang ada. Memulai dari model yang ada dapat berguna jika Anda ingin melakukan penyesuaian tanpa mengubah model asli.

• Untuk mengganti model topik yang ada, panggil metode impor dengan Cloud Storage URI objek, yang mengarah ke model topik yang sebelumnya diekspor dari project yang sama. Customer Experience Insights mengambil ID model pengganti dari file yang diekspor.
• Jika model topik tidak ada dalam project atau diimpor ke project baru, Customer Experience Insights akan otomatis membuat model topik baru.
• Secara opsional, Anda dapat menetapkan tanda create_new_model jika tidak ingin mengganti model yang ada.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID Anda.
• GCS_SOURCE: Cloud Storage URI tempat model topik disimpan.
• CREATE_NEW_MODEL: Tanda Boolean untuk membuat model baru, bukan mengganti model yang ada.
Catatan: Semua contoh menggunakan instance Customer Experience Insights global. Lihat Regionalisasi untuk mengetahui petunjuk tentang cara menggunakan instance regional.

Metode HTTP dan URL:

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels:import

Meminta isi JSON:

{
  gcs_source: {
    object_uri: 'GCS_SOURCE'
  }
  create_new_model: CREATE_NEW_MODEL
}

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://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels:import"

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://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels:import" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID"
}