Agen

Agen Dialogflow CX adalah agen virtual yang menangani percakapan serentak dengan pengguna akhir Anda. Ini adalah modul natural language understanding yang memahami nuansa bahasa manusia. Dialogflow CX menerjemahkan teks atau audio pengguna akhir selama percakapan ke data terstruktur yang dapat dipahami oleh aplikasi dan layanan Anda. Anda mendesain dan membangun agen Dialogflow CX untuk menangani jenis percakapan yang diperlukan sistem Anda.

Agen Dialogflow CX mirip dengan agen pusat panggilan manusia. Anda melatih keduanya untuk menangani skenario percakapan yang diharapkan, dan pelatihan Anda tidak perlu terlalu eksplisit.

Buat agen

Catatan: Anda dapat membuat beberapa agen Dialogflow CX untuk satu project Google Cloud.

Untuk membuat agen:

Konsol

1. Buka konsol Dialogflow CX.
2. Buat atau pilih project.
3. Klik Create agent.
4. Pilih Buat otomatis untuk membuat agen penyimpanan data atau pilih Buat sendiri untuk membuat jenis agen lainnya.
5. Isi formulir untuk setelan agen dasar:
   1. Anda dapat memilih nama tampilan apa pun.
   2. Pilih lokasi yang Anda inginkan. Jika Anda ingin mengubah setelan lokasi lanjutan, klik tombol Edit.
   3. Pilih zona waktu yang Anda inginkan.
   4. Pilih bahasa default untuk agen Anda. Anda tidak dapat mengubah bahasa default agen setelah dibuat.
6. Klik Simpan.

API

Jika belum mengonfigurasi setelan lokasi untuk project, Anda harus mengonfigurasi setelan ini dengan konsol sebelum membuat agen dengan API. Anda tidak dapat mengonfigurasi setelan lokasi dengan API.

Untuk membuat agen, lihat metode create untuk jenis Agent. Buka referensi Agent API

Pilih protokol dan versi untuk referensi Agen:

Protokol	V3	V3beta1
REST	Resource agen	Resource agen
RPC	Antarmuka agen	Antarmuka agen
C++	AgentsClient	Tidak tersedia
C#	AgentsClient	Tidak tersedia
Go	AgentsClient	Tidak tersedia
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Tidak tersedia	Tidak tersedia
Python	AgentsClient	AgentsClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

Data agen

Agen Dialogflow CX berfungsi sebagai penampung tingkat teratas untuk setelan dan data agen virtual. Data berikut dikaitkan dengan agen:

• Intents
• Jenis entitas
• Webhook
• Alur
• Halaman
• Grup rute

Untuk mengetahui informasi selengkapnya tentang cara data diterapkan di berbagai tingkat, lihat tingkat penerapan data.

Pengakhiran cerdas

Speech-to-Text (STT) adalah API yang mengonversi audio menjadi teks menggunakan machine learning, sehingga Anda dapat mengintegrasikan pengenalan ucapan ke dalam aplikasi Anda. Model STT yang didukung mencakup model bentuk panjang apa pun (misalnya, phone_call). Hanya bahasa en-US yang didukung.

Catatan: Jika menggunakan model pendek, hal ini akan mengaktifkan pengakhiran ucapan cloud.

Jika endpointing cerdas diaktifkan untuk agen, Anda dapat menyesuaikan perilaku endpointing cerdas untuk parameter numerik dengan menyetel Waktu tunggu untuk menentukan waktu tambahan. Kemudian, Dialogflow CX akan menunggu pengguna memberikan input tambahan.

Waktu tunggu adalah masa tenggang yang memungkinkan Anda menambahkan sesuatu ke transkrip STT sebelum waktu tunggu ucapan dipicu. Dialogflow CX menggunakan heuristik untuk menentukan waktu tunggu yang perlu dipilih berdasarkan transkrip. Misalnya, waktu tunggu yang sangat singkat dapat dipilih jika maksudnya berhasil dicocokkan. Jika maksud tidak cocok, waktu tunggu dapat ditingkatkan agar Anda dapat mengucapkan sesuatu yang lain, dan mencoba lagi pencocokan maksud.

Fitur STT lainnya meliputi:

• Endpoint yang Lebih Cepat: Analisis real-time menggunakan Streaming Transkripsi Audio untuk membedakan antara jeda alami dan penyelesaian ucapan saat streaming STT tetap terbuka. Jika pengguna telah selesai berbicara, Dialogflow CX akan menghentikan aliran lebih awal untuk memberikan respons yang lebih cepat.
• Masukan Percakapan Alami: Jika pengguna berhenti di tengah ucapan, Dialogflow CX dapat memperpanjang waktu tunggu STT secara dinamis untuk mencegah gangguan yang terlalu dini atau menyisipkan isyarat saluran balik alami (misalnya, "mm hmm", "uh huh") untuk mengonfirmasi bahwa agen virtual masih mendengarkan.

Mengekspor dan memulihkan agen

Peringatan: Mulai 15 Agustus 2025, kami tidak akan lagi mengekspor kredensial nilai mentah untuk Alat OpenAPI dan Webhook. Anda harus bermigrasi untuk menyimpan kredensial di Secret Manager. Untuk mengetahui petunjuknya, lihat dokumentasi Webhook dan Alat.

Anda dapat mengekspor agen ke file, dan memulihkan agen dengan file tersebut.

Ekspor agen mencakup semua data agen kecuali yang berikut:

• Versi alur: Hanya alur draf yang diekspor ke file.
• Lingkungan: Lingkungan kustom tidak diekspor ke file.

Pemulihan agen akan menimpa semua data agen target (termasuk semua versi alur) kecuali berikut ini:

• Lingkungan: Semua lingkungan kustom tetap tidak berubah di agen target. Versi alur yang dirujuk oleh lingkungan kustom di agen target akan terus ada selama lingkungan terkait ada. Namun, versi alur yang tidak aktif ini tidak tercantum atau dapat dipilih sebagai versi alur untuk agen.
• Aplikasi Agen Vertex AI: Asosiasi ke Aplikasi Agen Vertex AI tetap tidak berubah di agen target (yaitu, nilai engine di GenAppBuilderSettings). Artinya, agen penyimpanan data hanya dapat dipulihkan ke agen penyimpanan data lain yang sudah ada karena agen yang dihasilkan juga harus memiliki hubungan dengan Aplikasi Agen Vertex AI.

• Penyimpanan Data Agen Vertex AI: Semua referensi ke penyimpanan data akan diganti di agen target, sesuai dengan aturan berikut:

  • Jika agen target tidak dikaitkan dengan Aplikasi, maka agen dengan referensi penyimpanan data tidak dapat dipulihkan ke dalamnya. Jika dilakukan, akan muncul pesan error. Untuk memperbaikinya, Anda dapat membuat agen penyimpanan data baru dari awal. (Atau, Anda dapat mengubah agen yang ada menjadi agen penyimpanan data dengan menambahkan pemroses status penyimpanan data ke agen tersebut. Dalam hal ini, Anda akan dipandu untuk menambahkan Aplikasi terkait ke agen Anda.)
  • Jika agen target dikaitkan dengan Aplikasi, semua referensi penyimpanan data akan diperbarui saat dipulihkan: ID project dan lokasi akan diperbarui agar cocok dengan Aplikasi agen target. Google Cloud ID koleksi dan ID penyimpanan data akan tetap sama. Artinya, Anda perlu menambahkan penyimpanan data untuk semua ID dengan jenis yang cocok ke Aplikasi agen target sebelum operasi pemulihan.

  Contoh: Jika agen sumber merujuk ke penyimpanan data bernama projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 dan Aplikasi agen target bernama projects/321/locations/us-east1/collections/default_collections/engines/app123, maka referensi penyimpanan data yang dihasilkan di agen target menjadi: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Catatan: Di API dan dalam konten data yang diekspor, Aplikasi Agen Vertex AI disebut sebagai Engine GenAppBuilder. Misalnya, dalam paket JSON yang diekspor, Anda dapat menemukan nama mesin di file agent.json, di bagian kunci genAppBuilderSettings.engine.

Saat mengekspor, Anda dapat memilih format file ekspor. Jika Anda menggunakan penerapan versi kontrol sumber untuk data agen, Anda harus mengekspor dalam format JSON. Saat Anda memulihkan agen, Dialogflow CX akan otomatis menentukan format file.

Untuk mengekspor atau memulihkan agen:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project untuk agen.
3. Pilih opsi menu untuk agen dalam daftar.
4. Klik tombol Ekspor atau Pulihkan.
5. Ikuti petunjuk untuk menyelesaikannya.

Catatan: Untuk memulihkan agen penyimpanan data, pastikan agen target dibuat sebagai agen penyimpanan data.

API

Lihat metode export dan restore untuk jenis Agent. Buka referensi Agent API

Pilih protokol dan versi untuk referensi Agen:

Protokol	V3	V3beta1
REST	Resource agen	Resource agen
RPC	Antarmuka agen	Antarmuka agen
C++	AgentsClient	Tidak tersedia
C#	AgentsClient	Tidak tersedia
Go	AgentsClient	Tidak tersedia
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Tidak tersedia	Tidak tersedia
Python	AgentsClient	AgentsClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

Jika ukuran agen melebihi batas maksimum, gunakan opsi Cloud Storage untuk ekspor dan pemulihan agen.

Jika Anda menggunakan GitHub, lihat juga panduan ekspor/pemulihan GitHub.

Menghapus agen

Perhatian: Penghapusan agen tidak dapat diurungkan. Ekspor agen Anda untuk menyimpan cadangan jika diperlukan.

Untuk menghapus agen, Anda memerlukan peran yang memberikan akses penuh atau akses edit. Untuk mengetahui informasi selengkapnya, lihat Panduan kontrol akses.

Untuk menghapus agen:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project untuk agen.
3. Pilih opsi menu untuk agen dalam daftar.
4. Klik tombol .
5. Konfirmasi penghapusan di dialog.

API

Lihat metode delete untuk jenis Agent. Buka referensi Agent API

Pilih protokol dan versi untuk referensi Agen:

Protokol	V3	V3beta1
REST	Resource agen	Resource agen
RPC	Antarmuka agen	Antarmuka agen
C++	AgentsClient	Tidak tersedia
C#	AgentsClient	Tidak tersedia
Go	AgentsClient	Tidak tersedia
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Tidak tersedia	Tidak tersedia
Python	AgentsClient	AgentsClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

Jika Anda menghapus project Anda, semua agen dan data Dialogflow CX yang terkait dengan project tersebut akan segera dihapus.