Membuat agen menggunakan playbook

Catatan: Konsol Builder Agen masih menyebut playbook sebagai agen. Nama ini akan segera diperbarui menjadi playbook di konsol.

Panduan ini menunjukkan cara mem-build dan menguji agen pemesanan kemeja sederhana menggunakan playbook. Saat berinteraksi dengan agen ini, Anda dapat menanyakan lokasi toko, mendapatkan jam buka toko, atau melakukan pemesanan kemeja.

Sebelum memulai

Anda harus melakukan hal berikut sebelum membaca panduan ini:

1. Jika belum, ikuti petunjuk penyiapan Dialogflow.

Tentang playbook

Agen terdiri dari satu atau beberapa playbook. Setiap playbook memiliki cakupan yang jelas dan terbatas. Playbook memiliki data berikut:

X	Item
Nama	Nama yang digunakan untuk mengidentifikasi playbook.
Sasaran	Sasaran adalah deskripsi tingkat tinggi tentang hal yang harus dicapai playbook.
Petunjuk	Petunjuk adalah langkah-langkah tingkat tinggi yang harus dilakukan untuk mencapai sasaran playbook.
Contoh	Contoh adalah contoh percakapan antara pengguna akhir dan agen. Contoh ini secara efektif merupakan contoh perintah few-shot untuk LLM.

Membuat agen

Untuk membuat agen:

1. Buka konsol Pembuat Agen:

   Konsol Agent Builder

2. Pilih project Anda dari drop-down konsol.

3. Jika Anda belum mengaktifkan API, baca dan setujui Persyaratan Layanan, lalu klik Lanjutkan dan aktifkan API.

4. Klik Create a New App atau New App.

5. Pilih Agent.

6. Berikan "Shirt Ordering Assistant" untuk nama aplikasi.

7. Pilih wilayah.

8. Klik Create.

9. Antarmuka pengguna akan mengarahkan Anda ke playbook default yang bernama Agen Default.

10. Klik tombol kembali untuk melihat daftar playbook.

Membuat playbook pesanan

Playbook Pesanan menangani pesanan kaos. Untuk membuat playbook ini:

1. Klik Create.
2. Masukkan nama: Order.

3. Masukkan sasaran berikut:

   You are a shirt store ordering assistant. Help customers purchase shirts.
   Help the customer choose a size and color.
   The shirts come in small, medium, and large.
   The shirts can be red, green, or blue.
   

4. Masukkan petunjuk berikut:

   - If the customer has not provided a size, ask them to choose a size.
   - If the customer has not provided a color, ask them to choose a color.
   - Once the customer has selected a size and color for the shirt,
     repeat the selection to the customer, and ask them to confirm the selection.
   - Once the customer has confirmed their selection,
     let them know that the shirt is now ordered.
   - Do not provide prices or collect payment.
   - Do not collect the customer's name or address.
   

5. Klik Simpan.

   

6. Klik tombol kembali untuk kembali ke daftar playbook.

Membuat playbook informasi

Playbook Informasi menangani pertanyaan tentang toko. Untuk membuat playbook ini:

1. Klik Create.
2. Masukkan nama: Information.

3. Masukkan sasaran berikut:

   You provide information about a shirt store.
   The store is open between 8 AM and 6 PM every day.
   The store is located at 1007 Mountain Drive, Gotham City, NJ.
   

4. Masukkan petunjuk berikut:

   - If the customer asks for the store location, provide them with the address.
   - If the customer asks for the store hours, provide them with the hours.
   

5. Klik Simpan.

6. Klik tombol kembali untuk kembali ke daftar playbook.

Memperbarui playbook default

Saat pertama kali membuat aplikasi, playbook default telah dibuat untuk Anda. Playbook ini harus mengarahkan percakapan ke playbook yang sesuai dengan sasaran tertentu. Dalam petunjuk di bawah, Anda dapat melihat cara playbook default mereferensikan playbook lainnya. Untuk memperbarui playbook ini:

1. Klik playbook default. Playbook ini memiliki bintang yang ditandai.

2. Masukkan sasaran berikut:

   You are an assistant for a shirt store.
   Your name is "Samantha".
   Your job is to direct customers to other playbooks based on the customer's questions.
   

3. Masukkan petunjuk berikut:

   - If the customer hasn't been greeted yet, greet the customer,
     introduce yourself, and ask the user how you can help.
   - If the customer wants information about the store,
     route them to ${PLAYBOOK: Information}
   - If the customer wants to purchase a shirt,
     route them to ${PLAYBOOK: Order}
   

4. Klik Simpan.

5. Klik tombol kembali untuk kembali ke daftar playbook.

Memberikan contoh

Pada tahap ini, playbook Anda sudah berfungsi. Namun, Anda harus memberikan contoh untuk memastikan respons yang berkualitas.

Anda dapat memberikan contoh secara manual dari tab Contoh saat playbook terbuka. Namun, sering kali lebih mudah untuk melakukan percakapan dengan playbook yang berfungsi dan menyimpan percakapan tersebut sebagai contoh.

Contoh percakapan dengan playbook default bersifat singkat. Playbook ini hanya perlu mengarahkan Anda ke playbook lain. Untuk melakukan percakapan dengan playbook default:

1. Menutup atau membatalkan panel apa pun yang mungkin ada di sisi kanan layar. Anda ingin melihat panel simulator yang berisi Kirim pesan untuk melihat respons agen Anda.
2. Pilih playbook default.
3. Pilih model: gemini-pro.
4. Di kotak teks yang bertuliskan Enter user input, ketikkan Hello, lalu tekan enter.
5. Playbook akan merespons dengan sapaan.

Untuk menyimpan percakapan ini sebagai contoh:

1. Klik tombol Simpan contoh di dekat kanan atas antarmuka.
2. Panel editor contoh akan terbuka. Anda dapat menggunakan editor ini untuk menambahkan, mengedit, menghapus, atau mengurutkan ulang tindakan.
3. Berikan nama contoh: Greeting.
4. Perbarui respons playbook sesuai kebutuhan.

5. Klik Simpan.

   

Tambahkan contoh lokasi untuk playbook informasi:

1. Menutup atau membatalkan panel apa pun yang mungkin ada di sisi kanan layar. Jika perlu, reset percakapan dengan tombol reset restart_alt.
2. Pilih playbook informasi.
3. Pilih model: gemini-pro.
4. Masukkan pesan: Where are you located?.
5. Playbook akan merespons dengan lokasi.
6. Simpan percakapan ini sebagai contoh bernama Location. Hanya contoh playbook default yang dapat dimulai dengan tindakan pengguna, jadi Anda harus menghapus tindakan yang berisi "Di mana Anda berada". Masukkan Ringkasan konteks percakapan sebelumnya: The customer asked "Where are you located?". Masukkan ringkasan eksekusi Contoh: The store is located at 1007 Mountain Drive, Gotham City, NJ.

Tambahkan contoh jam buka untuk playbook informasi:

1. Serupa dengan langkah-langkah di atas, tetapi masukkan pesan: What are your hours? dan beri nama contoh: Hours.

Tambahkan contoh pilihan untuk playbook urutan:

1. Mirip dengan langkah-langkah di atas, tetapi beri nama contoh Selection, pilih playbook pesanan, dan kirim pesan berikut:

   • I want to buy a shirt
   • Large
   • Green
   • Yes

   

Menguji agen

Agen Anda kini siap diuji. Buka panel simulator dan lakukan percakapan dengan agen. Anda tidak perlu melakukan percakapan yang sama seperti di atas. Misalnya, Anda dapat bertanya kepada agen ini warna apa yang tersedia untuk kemeja. Jika Anda tidak mendapatkan perilaku yang diinginkan, meningkatkan kualitas contoh dan membuat contoh baru akan meningkatkan respons.

Berinteraksi dengan agen menggunakan API

Lihat Interaksi dengan API.