Agen

Agen Agen Percakapan (Dialogflow CX) adalah agen virtual yang menangani percakapan serentak dengan pengguna akhir Anda. 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 mem-build agen Agen Percakapan (Dialogflow CX) untuk menangani jenis percakapan yang diperlukan untuk sistem Anda.

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

Membuat agen

Catatan: Anda dapat membuat beberapa agen Agen Percakapan (Dialogflow CX) untuk satu project Google Cloud.

Untuk membuat agen:

Konsol

1. Buka konsol Dialogflow CX.
2. Membuat atau memilih project Google Cloud.
3. Klik Buat agen.
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. Klik tombol Edit jika Anda ingin mengubah setelan lokasi lanjutan.
   3. Pilih zona waktu pilihan Anda.
   4. Pilih bahasa default untuk agen Anda. Anda tidak dapat mengubah bahasa default untuk 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. Saat ini, 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	Referensi agen	Referensi 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 Agen Percakapan (Dialogflow CX) berfungsi sebagai penampung tingkat teratas untuk setelan dan data agen virtual.

Untuk mengakses data agen:

Konsol

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud untuk agen.
3. Temukan agen dalam daftar.
4. Klik nama tampilan agen.
5. Perbarui alur, halaman, dll. seperti yang dijelaskan dalam panduan lain.

API

Lihat panduan untuk data yang ingin Anda perbarui.

Data berikut dikaitkan dengan agen:

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

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 hal 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 hal berikut:

• 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 sudah tidak berlaku ini tidak tercantum atau merupakan versi alur yang dapat dipilih untuk agen.
• Aplikasi Agen Vertex AI: Atribusi ke Aplikasi Agen Vertex AI 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 ada, karena agen yang dihasilkan juga perlu memiliki pengaitan ke Aplikasi Agen Vertex AI.

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

  • Jika agen target tidak dikaitkan dengan Aplikasi, Anda tidak dapat memulihkan agen dengan referensi datastore 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 pengelola 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 setelah pemulihan: 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 harus 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 akan 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 GenAppBuilder Engine. Misalnya, dalam Paket JSON yang diekspor, Anda dapat menemukan nama mesin di file agent.json pada kunci genAppBuilderSettings.engine.

Saat mengekspor, Anda dapat memilih format file ekspor. Jika 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

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

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	Referensi agen	Referensi 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 perlu.

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

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud untuk agen.
3. Klik menu opsi untuk agen dalam daftar.
4. Klik tombol hapus .
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	Referensi agen	Referensi 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, semua agen Agen Percakapan (Dialogflow CX) dan data yang terkait dengan project akan segera dihapus.