Praktik terbaik ini dapat membantu Anda membangun agen yang andal.
Nama playbook dalam bahasa alami
Nama playbook harus jelas, deskriptif, dan dalam bahasa Inggris yang alami. Hal ini membantu performa Generator AI saat runtime. Misalnya, "Playbook Pusat Bantuan Pelanggan" lebih baik daripada "company_specialist".
Pastikan semua nama tidak lebih dari 64 karakter, termasuk huruf dan spasi dalam bahasa Inggris.
Sasaran yang ringkas
Sasaran harus menjelaskan tujuan playbook secara ringkas.
Memberikan petunjuk yang berkualitas
Gunakan petunjuk untuk:
- Mencerminkan pendekatan langkah demi langkah untuk menyelesaikan masalah pengguna akhir.
- Berikan kalimat bahasa alami yang ringkas untuk petunjuk tingkat tinggi.
- Tentukan skenario penggunaan alat secara langsung.
Minimal satu contoh untuk setiap playbook
Sertakan minimal satu contoh untuk setiap playbook, dan usahakan untuk menyertakan minimal empat contoh. Sertakan skenario happy path.
Tanpa contoh yang cukup, playbook dapat menghasilkan perilaku yang tidak dapat diprediksi. Jika playbook Anda tidak merespons atau berperilaku seperti yang Anda harapkan, contoh yang tidak ada atau tidak didefinisikan dengan baik kemungkinan adalah penyebabnya. Coba tingkatkan kualitas contoh Anda atau tambahkan contoh baru.
Presisi petunjuk dan contoh
Meskipun membantu menulis petunjuk yang jelas dan deskriptif, kualitas dan kuantitas contoh Anda-lah yang benar-benar menentukan akurasi perilaku playbook. Dengan kata lain, luangkan lebih banyak waktu untuk menulis contoh yang menyeluruh daripada menulis petunjuk yang sangat tepat.
Merujuk alat dalam contoh
Jika playbook dirancang untuk memberikan respons menggunakan alat, referensikan alat dalam contoh yang sesuai dengan jenis permintaan ini.
Kolom operationId skema alat
Saat Anda menentukan skema untuk alat, nilai operationId sangat penting.
Petunjuk playbook Anda akan merujuk ke nilai ini.
Gunakan rekomendasi penamaan berikut untuk kolom ini:
- Hanya gunakan huruf, angka, dan garis bawah.
- Pastikan nama tersebut unik di antara semua
operationIdyang dijelaskan dalam skema. - Pilih nama yang bermakna yang mencerminkan kemampuan yang disediakan.
Validasi skema alat
Validasi skema alat Anda. Anda dapat menggunakan Swagger Editor untuk memeriksa sintaksis skema openAPI 3.0 Anda.
Menangani hasil alat yang kosong
Jika playbook Anda mengandalkan alat untuk memberikan respons, hasil alat yang kosong dapat menyebabkan perilaku playbook yang tidak dapat diprediksi. Terkadang, Generator AI playbook akan berhalusinasi memberikan informasi dalam respons, bukan hasil alat. Untuk membantu mencegah perilaku yang tidak dapat diprediksi, tambahkan petunjuk khusus untuk membantu memastikan bahwa Generator AI playbook tidak mencoba menjawab sendiri.
Beberapa kasus penggunaan mengharuskan Anda melakukan grounding pada respons playbook dalam hasil alat atau data yang disediakan dan memitigasi respons yang hanya didasarkan pada pengetahuan Generator AI playbook.
Contoh petunjuk untuk mengurangi halusinasi meliputi:
- "Anda harus menggunakan alat ini untuk menjawab semua pertanyaan pengguna."
- "Jika Anda tidak mendapatkan data apa pun dari alat, respons bahwa Anda tidak tahu jawaban atas kueri pengguna."
- "Jangan mengarang jawaban jika Anda tidak mendapatkan data apa pun dari alat. Sebagai gantinya, minta pengguna untuk menyusun ulang kueri mereka atau meminta klarifikasi."
Membuat skema dengan Gemini
Gemini dapat membuat skema untuk Anda. Misalnya, coba minta Gemini untuk membuat contoh skema OpenAPI 3.0 untuk Google Kalender.
Playbook terfokus
Jangan membuat playbook yang sangat besar dan kompleks. Setiap playbook harus menyelesaikan tugas yang spesifik dan jelas. Jika Anda memiliki playbook yang kompleks, pertimbangkan untuk memecahnya menjadi sub-playbook yang lebih kecil.
Menghindari loop dan pengulangan
Jangan membuat loop atau rekursi saat menautkan agen dalam petunjuk Anda. Loop dapat terjadi jika Anda mencoba merutekan ke playbook ancestor yang, secara langsung atau tidak langsung, memanggil playbook saat ini.
Memberikan informasi pemilihan rute ke contoh
Saat playbook merutekan ke playbook lain, berikan informasi ini ke contoh. Berikan informasi ini ke contoh dari kolom End example with output information di bagian contoh Input & Output.
Misalnya, kalimat terakhir kolom ini dapat berupa "Reroute back to the default playbook for further queries."
Menggunakan fungsi JavaScript Dialogflow CX Messenger untuk personalisasi
Saat Anda menggunakan Dialogflow CX Messenger, fungsi JavaScript berikut memungkinkan Anda mengirim informasi personalisasi pengguna dari antarmuka web ke playbook:
Perencanaan performa
Fitur generatif biasanya memerlukan waktu beberapa detik atau bahkan puluhan detik untuk menghasilkan respons. Meskipun playbook meningkatkan kealamian percakapan, penting untuk mengelola waktu respons guna mempertahankan pengalaman pengguna akhir yang positif.
Untuk mengoptimalkan performa, gunakan strategi berikut:
- Seimbangkan penggunaan fitur generatif: Pertimbangkan dengan cermat konsekuensi antara waktu yang diperlukan untuk menjalankan beberapa fitur generatif dan nilai yang diberikan fitur tersebut pada percakapan. Hindari penggunaan fitur ini secara berlebihan jika tidak berkontribusi secara signifikan terhadap sasaran pengguna.
- Minimalkan input fitur generatif: Berupayalah untuk mengumpulkan dan memproses jumlah informasi minimum yang diperlukan Generator AI untuk menghasilkan respons yang berguna. Hal ini dapat mengurangi waktu pemrosesan secara signifikan.
- Gunakan cache konteks: Jika Anda menggunakan Gemini melalui alat dan memiliki konteks awal yang besar, pelajari informasi caching menggunakan Vertex AI Context Caching untuk menghindari permintaan berulang untuk data yang sama.
- Terapkan respons tetap untuk kecepatan: Jika aplikasi Anda tidak memerlukan konten yang unik dan dinamis, pertimbangkan untuk menyimpan respons yang sering digunakan dalam database tradisional seperti Firebase. Karena telah ditentukan dan tersedia, respons tetap ini memberikan waktu respons yang jauh lebih cepat daripada fitur generatif yang perlu menghitung jawaban dengan cepat.
- Perintahkan Generator AI untuk menghasilkan respons playbook yang ringkas: Untuk input dan output teks, waktu respons Generator AI sangat bergantung pada model yang digunakan dan panjang output. Respons singkat dapat meningkatkan performa secara signifikan. Meskipun panjang input juga menjadi faktor, panjang output memiliki dampak yang lebih besar.