Petunjuk: Operasi pemodelan topik

Ikuti petunjuk dalam panduan ini untuk mempelajari cara melakukan operasi seperti membuat, menyempurnakan, dan men-deploy model topik.

Sebelum memulai

1. Selesaikan petunjuk di halaman sebelum memulai.

2. Pastikan peran yang ditetapkan ke akun layanan Anda memberikan akses tulis ke project yang ingin Anda gunakan untuk pemodelan topik dan akses baca ke Cloud Storage API.

   Dua peran berikut memberikan akses tulis:

   • Project > Owner
   • Project > Editor

Rekomendasi data untuk impor percakapan

Model V2 dapat bekerja dengan {i>dataset<i} kecil, asalkan mematuhi panduan berikut:

• Gunakan minimal 100 percakapan, yang masing-masing memiliki minimal 5 giliran bolak-balik antara agen dan pelanggan.
• Sebaiknya gunakan antara 1.000 dan 10.000 percakapan untuk hasil yang optimal.

Anda dapat memberikan data percakapan sebagai file audio atau file teks berformat JSON. Untuk mengetahui detail format dan petunjuk cara mengupload data percakapan ke Cloud Storage, lihat referensi data percakapan.

Setelah mengimpor data percakapan, Anda dapat mencantumkan dan memfilter percakapan menggunakan API.

Membuat model topik

Ikuti petunjuk berikut untuk membuat model topik Anda.

Konsol

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

• resourcemanager.projects.get
• contactcenterinsights.issueModels.create

Ikuti langkah-langkah berikut untuk membuat model topik dari konsol Customer Experience Insights:

1. Buka konsol CX Insights, login dengan Akun Google Anda, lalu pilih project Anda.

   Konsol CX Insights

2. Klik model_training Topic models > + Create New.

3. Masukkan Nama tampilan model dan pilih Ukuran model.

4. Opsional: Pilih bahasa dari daftar Bahasa untuk melatih model non-Inggris. CX Insights mendukung bahasa Prancis, Jerman, Italia, Spanyol, dan Portugis. Tindakan ini akan otomatis memfilter percakapan dalam bahasa yang dipilih untuk digunakan selama pelatihan.

5. Klik Lanjutkan.

6. Pilih apakah Anda ingin mengimpor semua percakapan atau memfilter percakapan. Jika Anda memilih Filter percakapan yang diimpor, pilih filter, lalu klik Lanjutkan.

7. Opsional: Pilih Template industri, lalu klik Lanjutkan.

8. Masukkan atau upload topik kustom.

9. Klik Mulai Pelatihan untuk mulai melatih model topik baru.

REST API

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

• contactcenterinsights.issueModels.create

Ikuti langkah-langkah berikut untuk membuat model topik dari CX Insights API:

1. Panggil metode create pada resource issueModel.
2. Kirim permintaan pembuatan ke CX Insights API dengan definisi model.
3. Selain nama tampilan dan konfigurasi data pelatihan, Anda harus menyertakan jenis model TYPE_V2 dalam permintaan Anda.
4. Anda dapat secara opsional menentukan kolom language_code dalam permintaan untuk melatih model bagi bahasa tertentu.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID Anda.
• MODEL_NAME: Nama yang mudah dibaca untuk model masalah baru.

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

Meminta isi JSON:

{
  "display_name": "my new test model",
  "input_data_config": {
      "filter": "medium=\"CHAT\"",
      "custom_taxonomy": {
        "taxonomy_entries": [
          {
            "display_name": "reschedule car service"
          },
          {
            "display_name": "problem with windshield wipers"
          }
        ]
      },
      "industry": "auto",
      "issue_granularity": "STANDARD"
   },
   "model_type": "TYPE_V2",
   "language_code": "en-US"
}

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"

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" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

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

Status operasi

Membuat model topik adalah operasi yang berjalan lama, yang berarti dua hal:

1. Anda tidak dapat membuat model topik selama percakapan dengan pengguna akhir saat runtime.
2. Pembuatan model topik adalah proses yang panjang dan bergantung pada jumlah percakapan dalam set data pelatihan Anda. Tugas yang berisi minimal 1.000 percakapan dapat memerlukan waktu hingga satu jam atau lebih untuk diselesaikan.

Meskipun ada batasan ini, Anda dapat melakukan polling status operasi untuk melihat apakah operasi telah selesai.

Menyesuaikan model topik

Gunakan konsol CX Insights untuk mengubah daftar topik guna meningkatkan penetapan topik di masa mendatang.

Menambahkan atau mengedit topik

Anda dapat mengubah daftar topik dengan menambahkan topik untuk mencakup area yang belum diwakili oleh model. Ikuti langkah-langkah berikut untuk menambahkan topik:

1. Dari halaman Topic Models, klik salah satu model topik Anda > Add topic.

2. Masukkan Nama Topik dan Deskripsi Topik, lalu klik Selesai.

   Catatan: Lihat praktik terbaik untuk nama dan deskripsi topik.

Anda juga dapat memperbarui nama atau deskripsi topik untuk mendeskripsikan subjek percakapan yang harus cocok atau lebih sesuai dengan kasus penggunaan bisnis. Ikuti langkah-langkah berikut untuk mengedit nama atau deskripsi topik:

1. Dari daftar topik, buka topik, lalu klik more_vert > edit Edit topik.
2. Masukkan nama dan deskripsi, lalu klik Selesai.

Menghapus topik

Di konsol CX Insights, ikuti langkah-langkah berikut untuk menghapus topik dari daftar topik akhir dan hasil inferensi topik.

1. Pilih project yang mengaktifkan CX Insights.
2. Klik model_training Topic Models, lalu pilih model topik.
3. Buka topik, lalu klik more_vert > do_not_disturb_on Hapus topik.

Catatan: Setelah menghapus topik, Anda harus menganalisis ulang percakapan yang sebelumnya diberi label untuk mengganti hasil analisis sebelumnya.

Men-deploy model topik

Ikuti langkah-langkah berikut untuk men-deploy model topik dari konsol CX Insights, sehingga Anda dapat menggunakannya untuk menganalisis percakapan mendatang.

1. Dari konsol CX Insights, klik model_training Topic Models.
2. Buka model topik, lalu klik more_vert > Deploy.

Menganalisis ulang percakapan

Untuk menerapkan perubahan baru pada analisis yang ada, ikuti langkah-langkah berikut untuk menganalisis ulang percakapan di konsol CX Insights.

1. Klik news Conversation Hub.
2. Pilih salah satu opsi:
   • Untuk menganalisis ulang satu percakapan, pilih percakapan dari daftar, lalu klik Analisis ulang.
   • Untuk analisis massal, buka Histori Percakapan, tetapkan filter percakapan ke Status Analisis = Telah dianalisis, lalu klik Analisis.

Menyimpulkan topik

Dengan inferensi topik real-time, Anda dapat menggunakan model topik yang dibuat sebelumnya selama percakapan untuk menyimpulkan topik secara real time. Ikuti langkah-langkah berikut untuk menggunakan CX Insights API guna menyimpulkan topik untuk ucapan pengguna akhir saat runtime.

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

• contactcenterinsights.analyses.create

1. Panggil metode create resource analyses.
2. Untuk menjalankan semua anotator, panggil metode create tanpa menentukan pemilih anotator.
3. Hasil inferensi topik ada di resource analysisResult.

Membatalkan deployment model topik

Jika perlu membuat perubahan pada model topik yang di-deploy sebelum menggunakannya untuk menganalisis percakapan baru, Anda dapat menggunakan CX Insights API untuk membatalkan deployment-nya.

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

• contactcenterinsights.issueModels.undeploy

1. Panggil metode undeploy dari resource issueModel.

Menghapus deployment model adalah operasi yang berjalan lama, dan Anda dapat memeriksa status operasi untuk melihat apakah operasi telah selesai.

Menghapus model topik

Terakhir, Anda dapat menggunakan CX Insights API untuk menghapus model topik.

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

• contactcenterinsights.issueModels.delete

1. Panggil metode delete dari resource issueModel.

Menghapus model topik juga merupakan operasi yang berjalan lama, sehingga Anda dapat memeriksa statusnya untuk mengetahui apakah operasi telah selesai.

Langkah berikutnya

• Praktik terbaik pemodelan topik
• Mengekspor dan mengimpor model topik