Playbook

Playbook adalah elemen penyusun dasar agen generatif. Agen generatif biasanya memiliki banyak playbook, dengan setiap playbook ditentukan untuk menangani tugas tertentu. Data playbook diberikan kepada LLM, sehingga LLM memiliki informasi yang dibutuhkan untuk menjawab pertanyaan dan menjalankan tugas. Setiap playbook dapat memberikan informasi, mengirim kueri ke layanan eksternal, atau menangguhkan penanganan percakapan ke alur atau playbook lain untuk menangani subtugas.

Batasan

Batasan berikut berlaku:

  • Agen yang menggunakan playbook tidak mendukung pengiriman SMS pendamping panggilan dari rute Intent Sambutan Default di Alur Mulai Default, tetapi Anda dapat mengaktifkan opsi SMS pendamping panggilan dalam alur standar.

Dukungan bahasa

Playbook mendukung bahasa yang sama dengan model Gemini.

Dukungan wilayah

Playbook didukung di region berikut:

  • global
  • asia-south1
  • asia-southeast1
  • asia-northeast1
  • australia-southeast1
  • eu (multi-region)
  • europe-west1
  • europe-west2
  • europe-west3
  • northamerica-northeast1
  • us (multi-region)
  • us-central1
  • us-east1
  • us-west1

Data playbook

Playbook terdiri dari data berikut:

  • Nama playbook: nama ringkas dalam bahasa alami yang membantu developer dan LLM memahami tugas yang ditangani playbook
  • Sasaran: deskripsi tingkat tinggi tentang hal yang harus dicapai playbook
  • Petunjuk: menentukan langkah-langkah proses yang harus dilakukan untuk mencapai sasaran
  • Contoh: contoh percakapan yang secara efektif merupakan contoh perintah few-shot untuk LLM
  • Parameter: digunakan untuk menyimpan informasi tentang percakapan seperti input pengguna, informasi sistem pengguna, hasil tindakan, dan sebagainya.

Jenis playbook

Saat membuat playbook, Anda memilih jenis playbook yang diinginkan: playbook tugas atau playbook rutinitas.

Playbook tugas

Playbook tugas adalah jenis playbook asli. Fungsi ini digunakan untuk membagi tugas kompleks menjadi sub-tugas yang lebih kecil dan dapat digunakan kembali. Model ini digunakan untuk membuat model tahap percakapan komposisional, dengan setiap tahap berkomunikasi melalui parameter input dan output.

Berikut ini menunjukkan playbook tugas (pemanggil) yang memanggil playbook tugas lain (yang dipanggil):

Satu playbook tugas memanggil playbook tugas lain

  1. Pemanggil memulai pemanggil.
  2. Pemanggil memberikan parameter input yang diperlukan kepada pemanggil.
  3. Pemanggil memproses informasi ini, menjalankan fungsi yang ditetapkan, dan menampilkan parameter output.
  4. Pemanggil menerima parameter dari pemanggil.

Setiap playbook rutinitas atau tugas dapat memanggil playbook tugas lain, tetapi playbook tugas tidak dapat memanggil playbook rutinitas lain.

Playbook rutinitas

Playbook rutin adalah jenis playbook baru. Model ini digunakan untuk membuat model tahap percakapan berurutan, dengan setiap tahapnya lengkap dan independen. Flow dapat memanggil playbook tugas untuk menguraikan tugas yang lebih besar menjadi sub-tugas yang lebih kecil, dan dapat bertransisi ke playbook atau alur rutinitas lainnya.

Berikut ini menunjukkan playbook rutin (A), bertransisi ke playbook rutin lainnya (B), bertransisi ke alur (C):

Satu playbook rutinitas memanggil playbook rutinitas lain

  1. Playbook rutin A dapat membaca parameter sesi saat dimulai dan menulis parameter sesi tepat sebelum keluar.
  2. Playbook rutinitas A keluar dan bertransisi ke playbook rutinitas B.
  3. Playbook rutin B dapat membaca parameter sesi saat dimulai dan menulis parameter sesi tepat sebelum keluar.
  4. Playbook rutin B keluar dan bertransisi ke alur C.
  5. Alur C dapat membaca dan menulis parameter sesi.

Jika playbook rutin tidak bertransisi ke playbook atau alur rutin lainnya, sesi akan kembali ke alur aktif terakhir atau berakhir jika tidak ada.

Playbook rutin memiliki perilaku pengelolaan parameter berikut:

  • Saat playbook rutin dimasukkan, parameter inputnya akan diberi nilai yang setara dengan parameter sesi dengan nama yang sama.
  • Saat keluar, playbook rutinitas akan menghasilkan nilai untuk parameter output-nya dan menetapkannya ke parameter sesi dengan nama yang sama.

Playbook default

Saat Anda membuat agen generatif menggunakan konsol Agen Percakapan, Playbook Generatif Default akan dibuat secara otomatis.

Playbook default adalah titik awal percakapan, sehingga memiliki beberapa perbedaan penting dari playbook lainnya:

  • Playbook default tidak menerima ringkasan giliran percakapan sebelumnya.
  • Playbook default tidak dapat menentukan atau menerima parameter input.

Mengimpor dan mengekspor playbook

Setelah membuat playbook menggunakan konsol Agen Percakapan, Anda dapat mengekspor playbook ini untuk digunakan di agen lain. Untuk mengekspor playbook:

  1. Buka daftar playbook.
  2. Klik tombol ekspor untuk playbook yang ingin diekspor.
  3. Pilih opsi ekspor.
  4. Klik Ekspor.

Untuk mengimpor playbook yang telah Anda ekspor sebelumnya:

  1. Buka daftar playbook.
  2. Klik Import.
  3. Pilih opsi impor.
  4. Klik Import.