Pemecahan masalah

Filter konten dokumen ini menurut tag jenis agen:

Semua Agen Percakapan (Dialogflow CX) Dialogflow ES

Filter konten dokumen ini menurut tag kategori:

Apa pun API Konsol Autentikasi Project Integrasi NLU Regex Speech-to-Text Text-to-Speech Runtime AI Generatif

Mengaktifkan Cloud Logging untuk agen Anda

Aktifkan Cloud Logging untuk agen Anda. Hal ini penting untuk mengumpulkan data dan mendiagnosis masalah dalam percakapan nyata.

Mengumpulkan ID Percakapan

Saat terjadi perilaku yang tidak terduga, kumpulkan ID percakapan Dialogflow. ID ini, yang ditemukan di Histori Percakapan, memberikan cara untuk melacak jalur eksekusi percakapan dan memeriksa interaksi tertentu.

Izin panggilan API ditolak

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: API, Autentikasi

Masalah

Menerima respons PERMISSION_DENIED untuk panggilan API.

Solusi

Pastikan Anda telah menyiapkan autentikasi dan peran (Agen Percakapan (Dialogflow CX), Dialogflow ES) dengan benar. Secara khusus, pastikan Anda telah melakukan hal berikut:

• Membuat akun layanan dan tidak menghapusnya secara tidak sengaja.
• Memberikan akun layanan dengan peran yang memberikan izin untuk memanggil metode yang diinginkan.
• Mendownload file kunci pribadi akun layanan.
• Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke file kunci pribadi.

Panggilan API menyebutkan project yang tidak diketahui

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: API, Project

Masalah

Menerima error Dialogflow API has not been used in project 32555940559 untuk panggilan API.

Solusi

Pastikan Anda telah melakukan hal berikut:

• Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS (lihat PERMISSION_DENIED).
• Memberikan project ID yang benar ke panggilan API.

Panggilan API mendapatkan error kredensial autentikasi tidak valid

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: API, Autentikasi

Masalah

Menerima respons Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. untuk panggilan API.

Solusi

Hal ini mungkin karena membuat kredensial secara manual dengan library klien Anda saat menentukan region non-default. Lihat salah satu hal berikut untuk mendapatkan panduan:

• Pilih wilayah dengan API (Agen Percakapan (Dialogflow CX))
• Memilih wilayah dengan API (Dialogflow ES)

Respons panggilan API meminta pengalihan ke host lain

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: API, Autentikasi

Masalah

Menerima respons Please switch to 'REGION-dialogflow.googleapis.com' to access resources located in 'REGION' untuk panggilan API, dengan REGION adalah ID wilayah tertentu.

Solusi

Hal ini terjadi saat Anda menentukan region dalam permintaan, tetapi tidak menentukan endpoint. Lihat salah satu hal berikut untuk mendapatkan panduan:

• Pilih wilayah dengan API (Agen Percakapan (Dialogflow CX))
• Memilih wilayah dengan API (Dialogflow ES)

Kolom tidak ada dalam respons panggilan API

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: API

Masalah

Beberapa kolom tidak ada dalam respons API.

Solusi

Jika Anda mengharapkan nilai numerik untuk kolom tertentu dalam respons API, kolom tersebut mungkin tidak ada dalam respons jika nilai yang ditampilkan adalah 0.

Untuk mengetahui informasi selengkapnya tentang perilaku nilai default (termasuk nilai non-numerik), lihat:

• Buffering protokol (Agen Percakapan (Dialogflow CX))
• Buffering protokol (Dialogflow ES)

Tidak dapat menghapus project karena lien

Tag jenis agen: Dialogflow ES
Tag kategori: Project

Masalah

Saat mencoba menghapus project Google Cloud, Anda akan mendapatkan notifikasi bahwa project tersebut tidak dapat dihapus karena memiliki lien, dan salah satu lien terkait dengan Dialogflow ES.

Solusi

1. Pastikan Anda tidak lagi memerlukan agen Dialogflow ES yang terkait dengan project. Jika Anda mendapatkan notifikasi bahwa agen tidak ada, artinya agen tersebut telah dihapus.

   Konsol Dialogflow ES

   Buka https://dialogflow.cloud.google.com/#/agent/project-id/intents.

   Perhatikan bahwa link ini berbeda dengan link di dialog penghapusan project Google Cloud.

   Dialogflow API

   Gunakan metode search dari jenis agent.

2. Mendapatkan nama lien.

   gcloud

   Gunakan perintah gcloud alpha resource-manager liens list, seperti yang dijelaskan dalam dokumentasi Mencantumkan lien pada project.

   API Explorer

   Gunakan panel Coba API ini di halaman Metode: liens.list:

   • Isi kolom parent, seperti yang disarankan dalam deskripsi parameter.
   • Klik Jalankan.

3. Hapus lien.

   gcloud

   Gunakan perintah gcloud alpha resource-manager liens delete LIEN_NAME, seperti yang dijelaskan dalam dokumentasi Menghapus lien dari project.

   API Explorer

   Gunakan panel Coba API ini di halaman Metode: liens.delete:

   • Isi kolom name dengan nama lien yang Anda dapatkan pada langkah 2.
   • Klik Jalankan.

4. Matikan project.

Webhook Dialogflow CX gagal dengan error batas waktu terlampaui

Tag jenis agen: Agen Percakapan (Dialogflow CX)
Tag kategori: Runtime

Masalah

Webhook yang dipanggil dari Dialogflow CX dapat gagal dengan pesan error ini:

Webhook call failed. Error: DEADLINE_EXCEEDED

Hal ini dapat terjadi karena panggilan webhook melebihi batas waktu tunggu webhook. Berikut adalah kemungkinan alasan panggilan webhook melebihi batas waktu tunggu:

1. Mencoba memicu intent yang tidak ada.

2. Masalah cold start dengan backend webhook (misalnya, Cloud Functions).

3. Webhook memanggil layanan lain, sehingga meningkatkan waktu respons.

4. Tidak ada koneksi antara agen dan backend webhook (misalnya, Load Balancer yang salah dikonfigurasi).

5. Kebijakan organisasi mencegah traffic masuk atau metode Dialogflow dijalankan.

Solusi

Webhook memiliki batas waktu tunggu 5 detik secara default. Anda dapat meningkatkan batas waktu tunggu webhook saat membuat atau mengedit resource webhook, yang akan memberikan lebih banyak waktu bagi webhook untuk merespons.

Konsol gagal menyiapkan project

Tag jenis agen: Dialogflow ES
Tag kategori: Konsol, Project

Masalah

Menerima error Failed to set up GCP project saat membuat agen dengan konsol.

Solusi

Anda mungkin tidak memiliki izin untuk membuat project Google Cloud. Periksa apakah Anda dapat membuat project Google Cloud langsung dari Konsol Google Cloud. Jika Anda tidak dapat membuat project, ikuti rekomendasi yang diberikan dalam pesan error.

Referensi parameter sesi yang ditampilkan dalam respons

Tag jenis agen: Agen Percakapan (Dialogflow CX)
Tag kategori: Konsol

Masalah

Respons yang ditampilkan dari Dialogflow menyertakan referensi parameter, bukan nilai parameter. Misalnya:
Hello, $session.params.customer_name

Parameter tidak akan di-resolve dan referensi parameter akan ditampilkan jika parameter tidak ditemukan dalam sesi saat ini, atau jika parameter tidak digunakan sesuai dengan jenisnya.

Solusi

Masalah ini mungkin muncul karena parameter yang digunakan belum disertakan dalam percakapan, memiliki kesalahan ketik, atau memiliki jenis yang berbeda dengan jenis yang digunakan.

Konsol gagal membuat agen saat API belum diaktifkan

Tag jenis agen: Agen Percakapan (Dialogflow CX)
Tag kategori: Konsol

Masalah

Menerima error Dialogflow API has not been enabled for the project. Code: FAILED_PRECONDITION saat membuat agen dengan konsol.

Solusi

Ikuti langkah-langkah penyiapan untuk mengaktifkan Dialogflow API.

Saat mencoba mengakses konsol dari akun organisasi, menerima error layanan

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: Konsol

Masalah

Menerima error You don't have access to this service saat mencoba mengakses konsol dari akun organisasi Anda.

Solusi

Hubungi administrator sistem organisasi Anda, dan pastikan setelan organisasi Anda memberikan akses ke konsol.

Jika setelan organisasi Anda seharusnya mengizinkan akses, dan Anda memigrasikan akun dari organisasi lain, akun Anda mungkin telah ditandai sebagai dibatasi oleh Google. Hal ini mungkin menjadi masalah jika pengguna lain di organisasi Anda dapat mengakses konsol, tetapi Anda tidak dapat. Hubungi dukungan untuk mendapatkan bantuan.

Tidak dapat mengekspor agen dalam format JSON karena alur tidak ada

Tag jenis agen: Agen Percakapan (Dialogflow CX)
Tag kategori: Konsol

Masalah

Ekspor agen sebagai byte mentah berhasil diselesaikan, tetapi mengekspor agen dalam format JSON gagal dengan pesan error yang serupa dengan ini:

Flow 'projects/PROJECT_ID/locations/LOCATION_ID/agents/AGENT_ID/flows/FLOW_ID' does not exist
in the agent

Masalah ini dapat disebabkan oleh kasus pengujian yang mereferensikan alur yang telah dihapus.

Solusi

Untuk mengatasi masalah ini, jelajahi kasus pengujian yang tidak digunakan untuk mengonfirmasi apakah alur yang dirujuk dalam pesan error digunakan dalam kasus pengujian apa pun. Kemudian, hapus kasus pengujian yang dikonfirmasi.

Konektivitas gateway telepon

Tag jenis agen: Dialogflow ES
Tag kategori: Integrasi

Masalah

Saat menggunakan gateway telepon, Anda akan mendapatkan sinyal sibuk atau panggilan terputus.

Solusi

Ada kuota dan batas untuk fitur ini. Jika Anda menerima sinyal sibuk atau panggilan terputus, Anda mungkin telah melampaui kuota.

Error RESOURCE_EXHAUSTED saat mencoba membuat nomor telepon baru

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: Integrasi

Masalah

Saat mencoba membuat nomor telepon baru di Agen Percakapan (Dialogflow CX), Dialogflow ES, atau Agent Assist, error RESOURCE_EXHAUSTED akan ditampilkan.

Solusi

Error ini berarti Anda telah melampaui batas nomor telepon per project. Untuk membuat nomor telepon baru, hapus nomor telepon yang tidak digunakan yang terkait dengan project Anda hingga Anda berada di bawah batas.

Jika Anda membuat nomor telepon di Gateway Telepon Agen Percakapan (Dialogflow CX) atau Gateway Telepon Dialogflow ES, Anda dapat menghapusnya di konsol. Perhatikan bahwa menghapus agen tanpa menghapus nomor telepon tidak akan menghapus nomor telepon yang terkait dengannya.

Atau, Anda dapat menggunakan API dengan melakukan langkah-langkah berikut.

Langkah 1. Identifikasi semua nomor telepon yang terkait dengan project Anda

Untuk mengidentifikasi nomor telepon yang terkait dengan project Anda, gunakan metode API projects.phoneNumbers/list atau projects.locations.phoneNumbers.list untuk semua wilayah tempat Anda mungkin telah membuat nomor telepon.

• Untuk region global, gunakan perintah berikut:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/global/phoneNumbers
  

• Untuk wilayah lain, Anda harus menentukan wilayah di dua tempat:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://REGION_ID-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION_ID/phoneNumbers
  

Langkah 2. (Opsional) Identifikasi agen yang terkait dengan profil percakapan

Mendapatkan ID agen Agen Percakapan (Dialogflow CX) yang terkait dengan nomor telepon melalui profil percakapan dapat membantu Anda mengidentifikasi apakah agen masih digunakan dan apakah nomor telepon masih diperlukan. Anda dapat melakukannya menggunakan metode API projects.conversationProfiles/get. Anda dapat menemukan ID profil percakapan dalam respons terhadap perintah yang Anda jalankan di Langkah 1.

• Untuk region global, gunakan perintah berikut:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/global/conversationProfiles/CONVERSATION_PROFILE_ID
  

• Untuk wilayah lain, tentukan region di dua tempat:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://REGION_ID-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION_ID/conversationProfiles/CONVERSATION_PROFILE_ID
  

Anda dapat menemukan agen berdasarkan ID-nya di konsol Agen Percakapan (Dialogflow CX) dengan menggunakan opsi Telusuri di halaman Lihat semua agen.

Untuk Dialogflow ES, satu project hanya dapat dikaitkan dengan maksimal lima agen, dan satu agen Dialogflow ES dapat dikaitkan dengan satu nomor telepon. Jadi, Anda dapat membuka agen di konsol Dialogflow ES melalui https://dialogflow.cloud.google.com/#/editAgent/PROJECT_ID/intents.

Jika tidak ada agen yang ditemukan, Anda masih dapat menghapus nomor telepon jika yakin bahwa nomor tersebut tidak diperlukan lagi.

Langkah 3. Menghapus nomor telepon yang tidak digunakan

Untuk menghapus nomor telepon yang tidak diperlukan lagi, gunakan metode API projects.phoneNumbers/delete atau projects.locations.phoneNumbers.delete. Anda dapat menemukan ID nomor telepon dalam respons terhadap perintah yang Anda jalankan di Langkah 1.

• Untuk region global, gunakan perintah berikut:

  curl -X DELETE \
      -H "Authorization: Bearer "$(gcloud auth print-access-token) \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json; charset=utf-8" \
      https://dialogflow.googleapis.com/v2beta1/PHONE_NUMBER_ID
  

• Untuk wilayah lain, tentukan wilayah:

  curl -X DELETE \
      -H "Authorization: Bearer "$(gcloud auth print-access-token) \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json; charset=utf-8" \
      https://REGION_ID-dialogflow.googleapis.com/v2beta1/PHONE_NUMBER_ID
  

Dialogflow CX Messenger tidak merespons

Tag jenis agen: Agen Percakapan (Dialogflow CX)
Tag kategori: Integrasi

Masalah

Tidak ada respons agen untuk interaksi Messenger Dialogflow CX.

Solusi

Jika Anda tidak melihat respons apa pun dari Dialogflow CX Messenger, pastikan penagihan diaktifkan di project dan Dialogflow API diaktifkan di project. Lihat petunjuk penyiapan.

Nilai parameter yang cocok meskipun bukan sinonim entitas

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: NLU

Masalah

Kasus umum: Nilai parameter diekstrak saat runtime, meskipun entity yang sesuai dengan parameter tidak berisi nilai yang cocok sebagai sinonim.

Kasus yang lebih spesifik: Setelah sinonim dihapus dari entity dan agen telah dilatih ulang, sinonim ini masih diekstrak sebagai nilai parameter untuk entity ini.

Solusi

1. Gunakan opsi search untuk memeriksa apakah nilai yang cocok mungkin ada di agen sebagai entitas implisit (Agen Percakapan (Dialogflow CX), Dialogflow ES). Temukan semua intent yang memiliki anotasi dengan parameter dan entitas ini.

2. Perbaiki anotasi dengan memastikan tidak ada anotasi ini yang diterapkan ke teks yang mewakili nilai yang cocok yang tidak diinginkan.

3. Uji agen saat runtime untuk memverifikasi apakah masalah telah teratasi.

4. Jika masalah berlanjut, pastikan opsi Automatic expansion dan Fuzzy matching tidak dicentang di setelan entity lanjutan dan uji agen lagi.

Bot suara melewati beberapa respons

Tag jenis agen: Agen Percakapan (Dialogflow CX)
Tag kategori: Text-to-Speech

Masalah

Untuk agen yang dirancang untuk teks dan suara, bot suara tidak membaca beberapa respons.

Solusi

Jika setidaknya satu respons teks audio output ditentukan untuk giliran percakapan tertentu, pastikan opsi teks audio output selalu ada di seluruh respons webhook dan fulfillment agen di semua langkah untuk giliran percakapan ini.

Tag SSML tidak diterapkan

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: Text-to-Speech

Masalah

Tag SSML ditentukan dalam fulfillment agen, tetapi bot suara membaca teks yang disintesis tanpa efek SSML.

Solusi

Pastikan hanya ada satu pasangan <speak></speak> per satu kartu respons di konsol Dialogflow atau per satu objek pesan respons jika respons disediakan melalui API atau webhook.

Agen Voice mengucapkan nol sebagai huruf O

Tag jenis agen: Agen Percakapan (Dialogflow CX)
Tag kategori: Text-to-Speech

Masalah

Untuk agen yang dirancang untuk suara, agen suara membaca nol sebagai huruf O, bukan nol.

Solusi

1. Ubah Agent says untuk menggunakan Output audio text dialogue option.
2. Centang kotak SSML.
3. Atur teks Anda dengan tag SSML:

     <speak>
       <say-as interpret-as='verbatim'>YOUR_TEXT</say-as>
     </speak>

4. Simpan.

Misalnya, angka nol pada nomor kartu kredit akan dieja sebagai nol.

      <speak>
        <say-as interpret-as='verbatim'>5177 7702 8500 4578</say-as>
      </speak>
   

Pengucapan sintesis yang tidak terduga

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: Text-to-Speech

Masalah

Pengucapan respons agen yang disintesis (misalnya, nama sebutan, akronim) tidak seperti yang diharapkan.

Solusi

Untuk menjamin pengucapan tertentu untuk kata yang tidak umum diketahui, gunakan tag say-as atau phoneme SSML dalam respons agen.

Mencapai langkah eksekusi mesin status maksimum yang diizinkan

Tag jenis agen: Agen Percakapan (Dialogflow CX)
Tag kategori: Runtime

Masalah

Menerima pesan error berikut di konsol Agen Percakapan (Dialogflow CX) atau di log saat mengirim permintaan runtime ke agen:

You have reached the maximum allowed state machine execution steps. You may consider simplifying your agent/flow design. Current execution steps are: [<array_of_objects>]

Array dalam pesan error berisi daftar langkah eksekusi untuk permintaan. Daftar mungkin tidak lengkap jika jumlah langkah terlalu besar.

Solusi

Pesan error ini biasanya menunjukkan bahwa jumlah transisi untuk satu giliran percakapan terlalu besar. Contoh umum adalah bertransisi ke halaman yang sama, yang akan membuat loop tanpa batas.

Untuk mengatasi masalah tersebut:

1. Salin array JSON dari pesan error.
2. (Opsional) Format array yang disalin sebagai JSON yang rapi untuk keterbacaan yang lebih baik. Jika pesan error terpotong, telusuri objek "Langkah" terakhir, hapus objek langkah yang tidak lengkap dan koma sebelumnya, lalu tambahkan tanda kurung array penutup sebelum memvalidasi dan mempercantik JSON.
3. Lihat nilai "TriggeredTransitionRouteId" dan "TargetPage" untuk setiap langkah. Dalam kasus loop tanpa batas, kolom "TriggeredTransitionRouteId" dan "TargetPage" memiliki nilai berulang untuk sebagian besar langkah.
4. Ubah desain agen Anda untuk menghapus transisi loop tanpa akhir atau untuk mengurangi jumlah transisi untuk satu giliran percakapan.

Pencocokan ekspresi reguler terlalu luas

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: Regex

Masalah

Menerima error Regular expression match is too broad saat membuat entitas regexp (Agen Percakapan (Dialogflow CX) , Dialogflow ES).

Solusi

Pertimbangkan pendekatan berikut:

• Gunakan ^ dan $ dalam ekspresi reguler untuk menunjukkan awal dan akhir teks.
• Gunakan entity regexp dengan parameter yang diperlukan (Agen Percakapan (Dialogflow CX), Dialogflow ES)
• Tentukan perintah parameter yang diperlukan untuk meminta pengguna akhir hanya memberikan nilai entity tanpa kata-kata di sekitarnya.

Karakter non-alfanumerik yang tidak diinginkan disisipkan oleh pengenalan ucapan

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: Speech-to-Text

Masalah

Saat mencoba mencocokkan alfanumerik, karakter non-alfanumerik yang tidak diinginkan (spasi, tanda hubung, dan sebagainya) disisipkan oleh pengenal ucapan, yang mengakibatkan entitas tidak cocok.

Solusi

1. Jika Anda menggunakan entity sistem untuk mencocokkan angka, sebaiknya gunakan entity regexp (Agen Percakapan (Dialogflow CX), Dialogflow ES).
2. Ikuti semua rekomendasi dari bagian Pengenalan ucapan alfanumerik yang tidak akurat oleh entity regexp.
3. Untuk mencocokkan nomor melalui integrasi telepon, pertimbangkan opsi DTMF selain pengenalan suara.

Transkrip kosong untuk input suara

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: Speech-to-Text

Masalah

Respons Dialogflow untuk input suara menampilkan transkrip kosong. Permintaan ditangani sebagai tidak ada input atau tidak ada kecocokan.

Solusi

Dengarkan rekaman audio untuk mengonfirmasi bahwa rekaman tersebut berisi ucapan.

Pastikan adaptasi ucapan diaktifkan di setelan agen (Agen Percakapan (Dialogflow CX), Dialogflow ES).

Jika mengaktifkan adaptasi ucapan tidak membantu, bereksperimenlah dengan model ucapan berikut dalam penyiapan non-produksi dan gunakan model yang menghasilkan hasil terbaik:

• latest_short
• phone_call
• command_and_search

Untuk bahasa selain bahasa Inggris, temukan model ucapan yang didukung dalam dokumentasi Bahasa yang didukung Speech-to-Text.

Cara menentukan model ucapan bergantung pada cara Anda menyiapkan interaksi dengan Dialogflow.

• Untuk permintaan API, berikan nama model di kolom model di InputAudioConfig (Agen Percakapan (Dialogflow CX) , Dialogflow ES).

• Jika menggunakan Gateway Telepon (Agen Percakapan (Dialogflow CX) , Dialogflow ES), Anda dapat memperbarui model ucapan di profil percakapan yang dibuat oleh Dialogflow saat Anda mengaktifkan integrasi:

  1. Ambil ID profil percakapan:

     • Gunakan metode conversationProfiles.list untuk mengambil semua profil percakapan yang ditautkan ke project Anda.
     • Temukan profil percakapan yang ingin Anda perbarui, lalu salin nilai kolom name.

     Untuk Gateway Telepon Dialogflow CX, nama tampilan profil percakapan dapat ditemukan di setelan integrasi. Untuk Dialogflow ES Phone Gateway, nama tampilan profil percakapan sesuai dengan nama agen tempat integrasi diaktifkan.

     Jika Anda memiliki beberapa profil percakapan dengan nama tampilan yang sama, verifikasi ID agen di kolom automatedAgentConfig dari respons metode conversationProfiles.list.

  2. Gunakan metode API conversationProfiles.patch untuk memperbarui kolom model di SpeechToTextConfig.

• Untuk integrasi Contact Center AI, hubungi integrator telepon Anda untuk mengetahui cara memperbarui model ucapan untuk integrasi atau untuk setiap permintaan.

Layar kosong dengan error 'Ukuran file melebihi 2 MB' saat membandingkan versi agen

Tag jenis agen: Agen Percakapan (Dialogflow CX)
Tag kategori: Konsol

Masalah

Saat mencoba membandingkan dua versi agen yang berbeda, layar akan kosong dengan pesan error:

File size exceeds 2MB

Masalah ini disebabkan karena salah satu file berukuran lebih dari 2 MB.

Solusi

Untuk membandingkan versi agen dengan salah satu file yang berukuran lebih dari 2 MB, sebaiknya gunakan metode API compareVersion.

Pengenalan ucapan alfanumerik yang tidak akurat oleh entity regexp

Tag jenis agen: Agen Percakapan (Dialogflow CX), Dialogflow ES
Tag kategori: Speech-to-Text, Regex

Masalah

Menerima transkrip yang tidak akurat untuk input suara alfanumerik yang dirancang untuk dicocokkan dengan entitas regexp (Agen Percakapan (Dialogflow CX) , Dialogflow ES).

Solusi

1. Pastikan adaptasi ucapan diaktifkan di setelan agen (Agen Percakapan (Dialogflow CX), Dialogflow ES).
2. Pastikan setidaknya satu entri entitas mengikuti semua persyaratan entri ekspresi reguler (Agen Percakapan (Dialogflow CX), Dialogflow ES).
3. Untuk pola tertentu, gunakan ekspresi reguler yang paling spesifik. Misalnya, untuk alfanumerik yang dimulai dengan dua huruf, diikuti dengan lima digit, gunakan [a-zA-Z]{2}\d{5}, bukan [a-zA-Z0-9]{7}.
4. Pastikan entity regexp Anda memungkinkan pencocokan non-alfanumerik (spasi, tanda hubung, dan sebagainya) yang dapat disisipkan oleh pengenal ucapan. Untuk memenuhi persyaratan #2 dari daftar ini, buat beberapa entri entitas: satu entri untuk memenuhi persyaratan #2 dari daftar ini dan entri lainnya untuk memperhitungkan non-alfabetis. Misalnya, untuk mencocokkan lima digit dan mengizinkan karakter non-alfanumerik:

    \d{5}
    (\d[^a-zA-Z0-9]*){5}
   

5. Pastikan agen Anda mengikuti persyaratan definisi parameter (Agen Percakapan (Dialogflow CX), Dialogflow ES).

   Contoh untuk Agen Percakapan (Dialogflow CX)

   

   Contoh untuk Dialogflow ES

   
6. Pastikan agen Anda mengikuti persyaratan anotasi frasa pelatihan (Agen Percakapan (Dialogflow CX), Dialogflow ES).

   Contoh untuk Dialogflow ES

   
7. Pastikan pengujian Anda mengikuti panduan pengujian (Agen Percakapan (Dialogflow CX) , Dialogflow ES).
8. Untuk menghapus karakter non-alfanumerik yang mungkin telah disisipkan oleh pengenal ucapan, gunakan kode berikut:
   • Untuk Agen Percakapan (Dialogflow CX): fungsi sistem SUBSTITUTE atau webhook
   • Untuk Dialogflow ES: webhook
9. Periksa batasan adaptasi ucapan (Agen Percakapan (Dialogflow CX) , Dialogflow ES).

Mendesain untuk Percakapan Terkontrol

Buat agen Anda dengan jalur percakapan yang jelas. Pastikan agen dapat meminta informasi yang diperlukan untuk memenuhi persyaratan pengguna. Hindari cakupan percakapan yang terlalu luas, yang dapat menyebabkan perilaku yang tidak dapat diprediksi.

Menganalisis Log

Input dan output playbook, alat, dan penyimpanan data dicatat dalam log. Gunakan ID percakapan yang dikumpulkan untuk mengikuti rantai panggilan dan mengidentifikasi tempat eksekusi salah.

Bereksperimen dengan Perintah

Jika serangkaian petunjuk tertentu tidak berfungsi seperti yang diharapkan, coba ubah kata-katanya. Atau, Anda dapat menggunakan Gemini untuk membuat perintah (meta-perintah). Pendekatan berulang ini dapat membantu menemukan frasa yang optimal untuk kasus penggunaan Anda.

Memberikan Informasi Lengkap ke Dukungan

Saat membuka kasus dukungan dengan Dukungan Cloud, sertakan ID percakapan dan log yang relevan yang dikumpulkan selama investigasi Anda. Informasi ini sangat penting untuk men-debug masalah secara efisien.