Contoh playbook

Setiap playbook harus memiliki satu atau beberapa contoh. Contoh ini adalah contoh percakapan antara pengguna akhir dan playbook, termasuk dialog dan tindakan yang dilakukan oleh agen. Ini adalah contoh few-shot prompt yang efektif untuk LLM.

Konsol menyediakan antarmuka bagi Anda untuk memasukkan tindakan.

Agen multibahasa

Jika agen Anda menangani beberapa bahasa, gunakan setiap bahasa dalam contoh Anda.

Contoh ringkasan input dan output

Selain parameter input dan output, playbook mendukung penerimaan ringkasan input dan pengiriman ringkasan output untuk bertukar informasi dengan playbook lain. Ringkasan berguna untuk meneruskan informasi kontekstual abstrak antar-playbook, sedangkan parameter lebih berguna untuk meneruskan kolom terstruktur yang didefinisikan dengan baik antar-playbook. Parameter adalah satu-satunya cara untuk bertukar data antara flow dan playbook.

Tambahkan ringkasan input yang relevan ke contoh untuk membantu playbook menyesuaikan tindakannya berdasarkan ringkasan input tersebut saat runtime. Tambahkan ringkasan output yang menyertakan detail yang relevan dan akurat tentang contoh percakapan untuk menunjukkan detail yang penting untuk diringkas kepada playbook.

Contoh status

Pada titik tertentu dalam percakapan, playbook berada dalam salah satu status berikut:

  • OK: Playbook berhasil mencapai sasarannya dan kontrol dialihkan ke playbook induk.
  • CANCELLED: Pengguna memutuskan untuk tidak melanjutkan sasaran yang ditetapkan ke playbook dan kontrol ditransfer ke playbook induk. Jika playbook induk adalah alur CX, Dialogflow CX akan mendeteksi intent input pengguna sebelum alur berjalan.
  • FAILED: Playbook tidak dapat melanjutkan sasaran karena terjadi error (misalnya, alat menampilkan error 500). Sesi berakhir dengan status gagal. Pesan EndInteraction ditambahkan ke respons.
  • ESCALATED: Playbook memutuskan bahwa playbook tidak dapat mencapai sasaran dan perlu mengeskalasi situasi kepada manusia. Sesi berakhir dengan status dieskalasi. Pesan EndInteraction ditambahkan ke respons.
  • PENDING: Percakapan berlanjut dalam playbook.

Anda harus menunjukkan contoh tingkat teratas dan pemanggilan playbook-nya dengan status yang sesuai dengan playbook yang dirujuk.

Strategi pemilihan

Setelan strategi pemilihan mengontrol apakah contoh disertakan dalam perintah yang dikirim ke LLM untuk playbook.

Tersedia opsi-opsi berikut:

  • Pilih secara dinamis: Contoh ini disertakan secara bersyarat berdasarkan seberapa relevan contoh tersebut untuk konteks percakapan saat ini. Anda dapat menghilangkan contoh jika perintah mendekati batas token.
  • Selalu pilih: Contoh selalu disertakan, terlepas dari konteks percakapan. Anda dapat menghilangkan contoh jika perintah mendekati batas token.
  • Jangan pernah memilih: Contoh tidak disertakan dalam perintah. Contoh ini tidak memengaruhi performa playbook. Setelan ini berguna untuk mengecualikan contoh untuk pengujian untuk sementara.

Tambahkan tindakan

Contoh yang diberikan dalam playbook berisi serangkaian tindakan. Tindakan ini dapat bervariasi dalam kombinasi, tetapi terutama menggambarkan interaksi antara Anda dan playbook, beserta tindakan yang diambil di antaranya untuk memenuhi kueri atau persyaratan Anda.

Anda dapat menambahkan tindakan ke contoh dengan dua cara:

  • Untuk menambahkan tindakan secara manual, klik tombol + di bagian bawah panel kanan atau tombol Add action saat Anda menahan kursor di atas tindakan yang ada. Gunakan opsi ini saat Anda membuat contoh baru dengan mengklik opsi + Example atau saat Anda mengedit contoh yang ada.
  • Untuk membuat tindakan secara otomatis berdasarkan petunjuk playbook yang ada, masukkan input pengguna di kolom Enter user input di bagian bawah panel kanan. Gunakan opsi ini saat Anda membuat atau mengedit contoh. Atau, gunakan opsi ini saat Anda menguji playbook saat runtime di panel Preview playbook di sebelah kanan. Untuk menyimpan tindakan ke contoh dari panel Preview playbook, klik Save example setelah memilih pemanggilan playbook dari daftar pemanggilan di sebelah kiri panel Preview playbook.

Periksa kebenaran tindakan yang dibuat secara otomatis dan edit jika perlu. Hal ini sangat penting untuk playbook dengan sedikit atau tanpa contoh.

Playbook mendukung jenis tindakan berikut.

Respons playbook

Memberikan respons playbook untuk kueri pengguna.

Input pengguna

Masukkan kueri pengguna.

Penggunaan alat

Mendapatkan informasi tambahan yang diperlukan untuk memenuhi kueri pengguna menggunakan pemanggilan alat.

Tindakan ini menentukan detail berikut:

  • Alat: Nama alat yang harus Anda panggil.
  • Action: Nama operasi untuk alat OpenAPI yang harus Anda panggil. Untuk alat penyimpanan data dan alat fungsi, nama tindakan sama dengan nama alat.

  • Input alat: Input yang akan disertakan dalam panggilan alat. Input ini biasanya berasal dari giliran percakapan sebelumnya dengan pengguna.

    Untuk alat OpenAPI, JSON requestBody diperlukan untuk jenis metode POST, PUT, dan PATCH.

    Contoh input alat OpenAPI requestBody untuk tindakan createPet:

    {
  "id": 1,
  "name": "Luna"
}

    Untuk alat penyimpanan data, contoh requestBody menunjukkan tempat kueri diperlukan dan kolom lainnya bersifat opsional:

    {
  "query": "Where is my nearest store?",
  "filter": "country: ANY(\"United States\")",
  "userMetadata": {
    "userCity": "San Francisco",
  },
  "fallback": "We don't have any stores in your area."
}

  • Output alat: Respons pemanggilan alat. Ini adalah respons JSON yang valid dari alat untuk input yang diberikan. Untuk alat OpenAPI, error ini juga dapat berupa error string (misalnya, "404 Not found").

    Contoh output alat OpenAPI untuk tindakan listPets:

    {
  "pets": [
    {
      "id": 1,
      "name": "Luna"
    },
    {
      "id": 2,
      "name": "Charlie"
    }]
}

    Contoh output alat penyimpanan data untuk kueri "Di mana toko terdekat?":

    {
  "answer": "Here's the address to your nearest store ...",
  "snippets": [
    {
      "title": "San Francisco Downtown",
      "uri": "https://www.example.com/San_Francisco_Downtown",
      "text": "Address for San Francisco Downtown .."
    }
  ]
}

Untuk membantu memastikan playbook aman dari kegagalan, sertakan contoh cara playbook merespons saat pemanggilan alat gagal. Anda dapat merepresentasikan kegagalan pemanggilan alat OpenAPI sebagai string error ("404 not found") dalam output alat. Untuk alat penyimpanan data, Anda dapat menggunakan input fallback untuk menentukan cara merespons jika tidak ada jawaban yang diringkas.

Jika Anda ingin alat penyimpanan data menyertakan URI dalam respons playbook, tambahkan contoh yang berisi URI yang Anda inginkan untuk respons playbook. Jika URI ini berasal dari alat penyimpanan data, maka output alat penyimpanan data harus berisi URI yang cocok dengan URI dalam respons playbook.

Contoh yang berisi tindakan penggunaan alat bisa menjadi cukup panjang dan meningkatkan konsumsi batas token input. Untuk menggunakan token secara efisien, pastikan output alat ringkas dan berisi informasi yang relevan dengan sasaran playbook. Untuk alat penyimpanan data, pertimbangkan untuk menghapus cuplikan dari contoh karena menyebabkan konsumsi token input yang tinggi.

Pemanggilan playbook

Gunakan tindakan ini saat playbook perlu memanggil playbook tugas lain untuk memenuhi kueri pengguna.

Tentukan detail berikut untuk tindakan ini:

  • Playbook: Nama playbook yang akan dipanggil.
  • Ringkasan input pemanggilan playbook: Ringkasan bagian yang relevan dari percakapan sebelumnya yang berguna untuk playbook yang dipanggil.
  • Parameter input: Parameter input yang akan diteruskan ke playbook.
  • Ringkasan output pemanggilan playbook: Ringkasan tentang apa yang harus dihasilkan playbook setelah sasarannya tercapai.
  • Parameter output: Parameter output yang dihasilkan oleh playbook setelah menyelesaikan sasarannya.

Transisi playbook

Tindakan transisi playbook adalah tindakan terminal yang tidak boleh diikuti oleh tindakan lain, yang menunjukkan bahwa playbook rutinitas telah memutuskan untuk keluar dan beralih ke playbook rutinitas target. Karena tindakan ini menunjukkan bahwa playbook keluar, tambahkan parameter output playbook ke output playbook contoh.

Pemanggilan flow

Tindakan ini digunakan saat playbook tugas harus memanggil flow.

Tindakan ini harus menentukan detail berikut:

  • Flow: Nama flow yang akan dipanggil.
  • Flow input parameters: Parameter input yang akan diteruskan ke alur.
  • Flow return parameters: Parameter output yang ditampilkan dari flow.

Transisi alur

Tindakan transisi alur adalah tindakan terminal yang tidak boleh diikuti oleh tindakan lain, yang menunjukkan bahwa playbook rutinitas telah memutuskan untuk keluar dan beralih ke alur target. Karena tindakan ini menunjukkan bahwa playbook keluar, tambahkan parameter output playbook ke output playbook contoh.

Sebelumnya
Tindakan kondisional playbook
Berikutnya
Parameter playbook