Membuat agen menggunakan playbook

Membangun dan menguji agen pemesanan kemeja menggunakan playbook. Gunakan agen untuk menanyakan lokasi toko, mendapatkan jam buka toko, atau memesan kemeja.

Sebelum memulai

Jika Anda belum melakukannya, ikuti petunjuk penyiapan.

Tentang playbook

Agen terdiri dari satu atau beberapa playbook. Setiap playbook memiliki cakupan yang ditentukan dengan jelas dan terbatas. Tabel berikut menjelaskan data dalam playbook:

X Item
Nama Nama yang digunakan untuk mengidentifikasi playbook.
Sasaran 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 contoh percakapan antara pengguna akhir dan agen. Contoh ini secara efektif merupakan contoh few-shot prompt untuk LLM.

Buat agen

Untuk membuat agen:

  1. Buka https://conversational-agents.cloud.google.com.
  2. Jika belum melakukannya, pilih atau buat project.
  3. Klik Create agent.
  4. Klik Build your own.
  5. Masukkan "Shirt Ordering - Playbooks" untuk nama agen.
  6. Masukkan lokasi.
  7. Masukkan zona waktu.
  8. Masukkan 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 Back untuk kembali ke daftar playbook.

Membuat playbook pesanan

Playbook Order menangani pesanan kemeja.

Untuk membuat playbook:

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

  7. Klik Back untuk kembali ke daftar playbook.

Membuat playbook informasi

Playbook Information menangani pertanyaan tentang toko.

Untuk membuat playbook:

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

  7. Klik Back untuk kembali ke daftar playbook.

Memperbarui playbook default

Saat Anda pertama kali membuat agen, playbook default akan dibuat untuk Anda. Playbook ini mengarahkan percakapan ke playbook yang sesuai dengan sasaran tertentu. Anda dapat melihat cara playbook default mereferensikan playbook lain dalam petunjuk berikut.

Untuk memperbarui playbook:

  1. Klik playbook default, yang ditandai dengan bintang.
  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 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. Perhatikan bahwa referensi playbook ditandai karena belum ada contoh; Anda akan menambahkannya di bagian berikutnya.

  6. Klik Back untuk kembali ke daftar playbook.

Memberikan contoh

Playbook ini berfungsi, tetapi memberikan contoh akan memastikan respons yang berkualitas.

Anda dapat memberikan contoh dari tab Examples saat playbook terbuka; namun, sering kali lebih mudah untuk melakukan percakapan dengan agen dan menyimpan percakapan tersebut sebagai contoh.

Percakapan playbook default bersifat singkat. Playbook ini perlu mengarahkan percakapan ke playbook lain.

Untuk melakukan percakapan dengan playbook default:

  1. Tutup atau batalkan panel apa pun yang mungkin ada di sisi kanan layar.
  2. Ketuk tombol simulator di navigasi baris atas.
  3. Untuk resource, pilih playbook default.
  4. Gunakan model default atau pilih alternatif.
  5. Di kolom Enter user input, masukkan Hello, lalu tekan Enter.
  6. Playbook merespons dengan salam.

Untuk menyimpan percakapan ini sebagai contoh:

  1. Pilih playbook default dalam daftar Invocations.
  2. Klik Save as example.
  3. Di panel editor contoh, tambahkan, edit, hapus, atau urutkan ulang tindakan.
  4. Masukkan Greeting sebagai nama contoh.
  5. Perbarui respons playbook sesuai kebutuhan.
  6. Di bagian End example with output information, masukkan The user is greeted. di kolom Summary.
  7. Klik Simpan.

Tambahkan contoh lokasi untuk playbook informasi:

  1. Menutup atau membatalkan panel apa pun di sisi kanan layar.
  2. Jika perlu, reset percakapan dengan tombol reset restart_alt.
  3. Pilih playbook informasi di menu Start Resource simulator.
  4. Ketik Where are you located?, lalu tekan Enter.
  5. Pilih playbook informasi di menu Invocations.
  6. Klik Save as example.
  7. Masukkan Location sebagai nama contoh.
  8. Hapus tindakan yang berisi Where are you located? karena hanya contoh playbook default yang dapat dimulai dengan tindakan pengguna.
  9. Luaskan bagian Summary of the preceding conversation dan masukkan The customer asked "Where are you located?" di kolom Starts example with input information.
  10. Luaskan bagian Summary of the playbook execution dan masukkan The store is located at 1007 Mountain Drive, Gotham City, NJ. di kolom End example with output information.
  11. Klik Simpan.

Tambahkan contoh jam untuk playbook informasi:

  1. Pilih playbook informasi di simulator.
  2. Masukkan pesan What are your hours?.
  3. Simpan percakapan sebagai contoh bernama Hours.

Tambahkan contoh pilihan untuk playbook pesanan dengan mengikuti langkah-langkah berikut:

  1. Beri nama contoh Selection.
  2. Pilih playbook pesanan.
  3. 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 dapat melakukan percakapan yang berbeda dari yang dijelaskan sebelumnya. Misalnya, Anda dapat bertanya kepada agen ini warna apa saja yang tersedia untuk kemeja. Jika Anda tidak mendapatkan hasil yang diperlukan, menyempurnakan atau menambahkan contoh akan meningkatkan kualitas respons.

Berinteraksi dengan agen menggunakan API

Untuk mengetahui informasi selengkapnya tentang cara berinteraksi dengan API, lihat Interaksi dengan API.