Agen Agen Percakapan (Dialogflow CX) adalah agen virtual yang menangani percakapan serentak dengan pengguna akhir Anda. Modul ini adalah modul natural language understanding yang memahami nuansa bahasa manusia. Agen Percakapan (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 Agen Percakapan (Dialogflow CX) untuk menangani jenis percakapan yang diperlukan sistem Anda.
Agen Percakapan (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
Untuk membuat agen:
Konsol
- Buka konsol Dialogflow CX.
- Buat atau pilih project Google Cloud.
- Klik Buat agen.
- Pilih Buat otomatis untuk membuat agen penyimpanan data atau pilih Buat sendiri untuk membuat jenis agen lainnya.
- Isi formulir untuk setelan agen dasar:
- Anda dapat memilih nama tampilan apa pun.
- Pilih lokasi yang Anda inginkan. Klik tombol Edit jika Anda ingin mengubah setelan lokasi lanjutan.
- Pilih zona waktu yang Anda inginkan.
- Pilih bahasa default untuk agen Anda. Anda tidak dapat mengubah bahasa default untuk agen setelah agen dibuat.
- Klik Simpan.
API
Jika belum mengonfigurasi setelan lokasi untuk project Anda, Anda harus mengonfigurasi setelan ini dengan konsol sebelum membuat agen dengan API. Saat ini, Anda tidak dapat mengonfigurasi setelan lokasi dengan API.
Untuk membuat agen,
lihat metode create
untuk jenis Agent
.
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 |
Data agen
Agen Agen Percakapan (Dialogflow CX) berfungsi sebagai penampung tingkat teratas untuk setelan dan data agen virtual. Data berikut dikaitkan dengan agen:
Untuk mengetahui informasi selengkapnya tentang cara data diterapkan di berbagai tingkat, lihat tingkat penerapan data.
Mengekspor dan memulihkan agen
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:
- Environments: 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 sudah tidak berlaku ini tidak tercantum atau dapat dipilih versi alurnya untuk agen.
- Aplikasi Agen Vertex AI:
Asosiasi ke Aplikasi Agen Vertex AI tetap tidak berubah
di agen target. (Dengan kata lain, 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 state handler penyimpanan data ke agen tersebut. Dalam hal ini, Anda akan dipandu dalam menambahkan Aplikasi terkait ke agen Anda.)
- Jika agen target dikaitkan dengan Aplikasi, semua referensi penyimpanan data akan diperbarui saat dipulihkan: ID project Google Cloud dan lokasinya akan diperbarui agar cocok dengan Aplikasi agen target. ID koleksi dan ID penyimpanan data tidak akan berubah. 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 bernamaprojects/321/locations/us-east1/collections/default_collections/engines/app123
, maka referensi penyimpanan data yang dihasilkan di agen target akan menjadi:projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1
Saat mengekspor, Anda dapat memilih format file ekspor. Jika Anda menggunakan pembuatan versi kontrol sumber untuk data agen, Anda harus mengekspor dalam format JSON. Saat Anda memulihkan agen, Agen Percakapan (Dialogflow CX) akan otomatis menentukan format file.
Untuk mengekspor atau memulihkan agen:
Konsol
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud untuk agen.
- Klik opsi more_vert menu untuk agen dalam daftar.
- Klik tombol Ekspor atau Pulihkan.
- Ikuti petunjuk untuk menyelesaikannya.
API
Lihat metode export
dan restore
untuk jenis Agent
.
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 |
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
Untuk menghapus agen, Anda memerlukan peran yang memberikan akses penuh atau akses edit. Lihat panduan kontrol akses untuk mengetahui informasi selengkapnya.
Untuk menghapus agen:
Konsol
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud untuk agen.
- Klik opsi more_vert menu untuk agen dalam daftar.
- Klik tombol hapus delete.
- Konfirmasi penghapusan di dialog.
API
Lihat metode delete
untuk jenis Agent
.
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 |
Jika Anda menghapus project Anda, semua agen dan data Agen Percakapan (Dialogflow CX) yang terkait dengan project tersebut akan segera dihapus.