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, mengirimkan 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 Maksud Sambutan Default di Alur Mulai Default, tetapi Anda dapat mengaktifkan opsi SMS pendamping panggilan di alur standar.
• Playbook tidak mendukung input DTMF dari sistem telepon.

Dukungan bahasa

Lihat kolom Playbooks di referensi bahasa. Bahasa yang ditandai untuk playbook telah diuji kualitasnya dengan model gemini-2.0-flash dan gemini-1.5-flash-002.

Saat menggunakan bahasa selain bahasa Inggris, Anda harus menentukan contoh dalam bahasa target, sekaligus tetap menggunakan bahasa Inggris untuk petunjuk. Untuk bahasa dan kasus penggunaan tertentu, Anda mungkin mendapatkan respons yang sedikit lebih baik jika Anda juga memberikan petunjuk dalam bahasa target.

Dukungan model

Anda dapat memilih model LLM yang digunakan dalam playbook di tempat berikut:

• Pilih model LLM di tingkat agen.

  • Di setelan Agen Konsol Conversational Agents -> AI Generatif -> Playbook, pilih model berdasarkan nama tampilannya dari dropdown semua model yang tersedia.
  • Tentukan nama model di kolom GenerativeSettings.llm_model_settings.model jika Anda menggunakan API untuk memperbarui setelan agen (lihat GenerativeSettings).

• Mengganti pemilihan model di tingkat permintaan.

  • Di simulator Konsol Agen Percakapan, pilih model menurut nama tampilan dari drop-down saat menguji playbook.
  • Tentukan nama model di kolom DetectIntentRequest.query_params.llm_model_settings.model jika Anda menguji agen melalui API (lihat DetectIntentRequest).

Nama Model	Spesifikasi Model	Tahap Peluncuran
gemini-2.0-flash-001	Gemini 2.0 flash	GA
gemini-2.0-flash-lite-001	Gemini 2.0 flash lite	Pratinjau Publik
gemini-2.5-flash	Gemini 2.5 flash	Pratinjau Publik
gemini-1.5-flash-001	Gemini 1.5 Flash	Lama
gemini-1.5-flash-002	Gemini 1.5 Flash	Lama

Dukungan wilayah

Playbook didukung di wilayah berikut:

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

Data playbook

Playbook terdiri dari data berikut:

• Nama playbook: nama singkat dalam bahasa alami yang membantu developer dan LLM memahami tugas yang ditangani playbook
• Tujuan: deskripsi umum tentang apa yang harus dicapai oleh playbook
• Petunjuk: mendefinisikan langkah-langkah proses yang harus dilakukan untuk mencapai tujuan
• 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. Tindakan ini digunakan untuk memecah tugas kompleks menjadi sub-tugas yang lebih kecil dan dapat digunakan kembali. Tahapan percakapan ini digunakan untuk memodelkan tahapan percakapan komposisional, dengan setiap tahapan berkomunikasi melalui parameter input dan output.

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

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

Playbook rutin atau tugas apa pun dapat memanggil playbook tugas lain, tetapi playbook tugas tidak dapat memanggil playbook rutin lain.

Playbook rutinitas

Playbook rutin adalah jenis playbook baru. Tahapan ini digunakan untuk memodelkan tahapan percakapan berurutan, dengan setiap tahapan selesai dan independen. Agen dapat memanggil playbook tugas untuk menguraikan tugas yang lebih besar menjadi subtugas yang lebih kecil, dan agen dapat beralih ke playbook atau alur rutin lainnya.

Berikut menunjukkan playbook rutin (A), beralih ke playbook rutin lain (B), beralih ke alur (C):

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. Flow C dapat membaca dan menulis parameter sesi.

Jika playbook rutin tidak bertransisi ke playbook atau alur rutin lain, 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 diberi nilai yang setara dengan parameter sesi dengan nama yang sama.
• Saat playbook rutin keluar, playbook akan membuat nilai untuk parameter outputnya 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.

Membuat playbook

Untuk membuat playbook:

1. Klik ikon playbook di navigasi kiri konsol.
2. Klik tombol Buat baru.
3. Pilih jenis playbook Rutinitas atau Tugas.
4. Berikan data playbook.

Menggunakan pembuatan AI untuk membuat playbook

Saat membuat playbook, panel AI generatif akan terbuka. Anda dapat menggunakannya untuk membuat data playbook untuk Anda.

Mengimpor dan mengekspor playbook

Setelah membuat playbook menggunakan konsol Conversational Agents, 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 Anda ekspor.
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.