Membuat agen menggunakan playbook

Panduan ini menunjukkan cara membangun 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.

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.
Target Sasaran adalah deskripsi tingkat tinggi tentang apa yang harus dicapai oleh playbook.
Petunjuk Petunjuk adalah langkah-langkah tingkat tinggi yang harus diambil untuk mencapai sasaran playbook.
Contoh Contoh adalah percakapan sampel antara pengguna akhir dan agen. Contoh ini secara efektif merupakan contoh perintah beberapa kali untuk LLM.

Membuat agen

Untuk membuat agen:

  1. Buka konsol Conversational Agents:

    Konsol Conversational Agents

  2. Jika belum, pilih atau buat project.

  3. Klik Create agent.

  4. Klik Build your own.

  5. Berikan "Shirt Ordering - Playbooks" untuk nama agen.

  6. Berikan a lokasi.

  7. Berikan zona waktu.

  8. Berikan a bahasa default.

  9. Pilih Playbook untuk opsi Conversation start.

  10. Klik Create.

  11. Antarmuka pengguna akan mengarahkan Anda ke playbook default bernama Default Generative Playbook.

  12. Klik tombol kembali untuk melihat daftar playbook.

Membuat playbook pesanan

Playbook Order menangani pesanan kemeja. Untuk membuat playbook ini:

  1. Klik Create.
  2. Pilih opsi Task playbook.
  3. Masukkan nama playbook: Order.

  4. 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.

  5. 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.

  6. Klik Save.

  7. Klik tombol kembali untuk kembali ke daftar playbook.

Membuat playbook informasi

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

  1. Klik Create.
  2. Pilih opsi Task playbook.
  3. Masukkan nama playbook: Information.

  4. 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.

  5. 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.

  6. Klik Save.

  7. Klik tombol kembali untuk kembali ke daftar playbook.

Memperbarui playbook default

Saat pertama kali membuat aplikasi, playbook default akan 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 disorot.

  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 Save.

  5. Perhatikan bahwa referensi playbook disorot karena belum ada contoh. Contoh ini akan ditambahkan di bagian berikutnya.

  6. Klik tombol kembali untuk kembali ke daftar playbook.

Memberikan contoh

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

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

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

  1. Tutup atau batalkan panel apa pun yang mungkin ada di sisi kanan layar.
  2. Klik tombol simulator di navigasi baris atas.
  3. Untuk resource, pilih playbook default.
  4. Gunakan model default atau pilih alternatif.
  5. Di kotak teks yang bertuliskan input pengguna, ketik Hello, lalu tekan Enter.
  6. Playbook akan merespons dengan ucapan salam.

Untuk menyimpan percakapan ini sebagai contoh:

  1. Pilih playbook default di dropdown Invocations.
  2. Klik tombol Save as example di dekat kanan atas antarmuka.
  3. Panel editor contoh akan terbuka. Anda dapat menggunakan editor ini untuk menambahkan, mengedit, menghapus, atau mengurutkan ulang tindakan.
  4. Berikan nama contoh: Greeting.
  5. Perbarui respons playbook sesuai kebutuhan.
  6. Scroll ke bawah ke End example with output information dan masukkan The user is greeted. di bagian Summary.
  7. Klik ikon simpan.

Tambahkan contoh lokasi untuk playbook informasi:

  1. Tutup atau batalkan panel apa pun yang mungkin ada di sisi kanan layar.
  2. Jika perlu, reset percakapan dengan tombol reset restart_alt.
  3. Pilih playbook informasi di dropdown simulator Start Resource.
  4. Masukkan pesan: Where are you located?.
  5. Playbook akan merespons dengan lokasi.
  6. Pilih playbook informasi di dropdown Invocations.
  7. Klik tombol Save as example.
  8. Berikan nama contoh: Location.
  9. Sebelum menyimpan percakapan ini sebagai contoh, Anda harus menghapus tindakan yang berisi "Where are you located". Hanya contoh playbook default yang dapat dimulai dengan tindakan pengguna.
  10. Untuk memberikan contoh dengan konteks yang memulai percakapan, luaskan bagian Summary of the preceding conversation... section dan masukkan hal berikut di kolom Starts example with input information field: The customer asked "Where are you located?".
  11. Untuk memberikan contoh dengan konteks yang menyelesaikan percakapan, luaskan bagian Summary of the playbook execution... dan masukkan hal berikut di kolom End example with output information : The store is located at 1007 Mountain Drive, Gotham City, NJ..
  12. Klik ikon simpan.

Tambahkan contoh jam untuk playbook informasi:

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

Tambahkan contoh pilihan untuk playbook pesanan:

  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 tentang warna yang tersedia untuk kemeja. Jika Anda tidak mendapatkan perilaku yang diinginkan, menyempurnakan contoh dan membuat contoh baru akan meningkatkan respons.

Berinteraksi dengan agen menggunakan API

Lihat Interaksi dengan API.

Sebelumnya
Penyiapan dan pembersihan
Berikutnya
Membuat agen menggunakan alur