Beberapa produk dan fitur sedang dalam proses penggantian nama. Fitur playbook dan alur generatif juga dimigrasikan ke satu konsol gabungan. Lihat detailnya.

Halaman ini diterjemahkan oleh Cloud Translation API.

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 secara efektif merupakan contoh perintah few-shot untuk LLM.

Konsol menyediakan antarmuka untuk Anda memasukkan tindakan.

Agen multibahasa

Jika Anda ingin agen menangani beberapa bahasa, contoh Anda harus menggunakan setiap bahasa.

Contoh ringkasan input dan ringkasan 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 dan terdefinisi dengan baik antar-playbook. Parameter adalah satu-satunya cara untuk bertukar data antara alur dan playbook.

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

Contoh status

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

OK: Playbook berhasil mencapai tujuannya dan kontrol kini akan ditransfer ke playbook induk.
CANCELLED: Pengguna memutuskan untuk tidak melanjutkan sasaran yang ditetapkan ke playbook. Kontrol kini akan ditransfer ke playbook induk. Jika playbook induk adalah alur CX, maksud input pengguna akan terdeteksi sebelum alur berjalan.
FAILED: Playbook tidak dapat melanjutkan sasaran karena beberapa error (misalnya, alat menampilkan error 500). Sesi akan berakhir dengan status gagal. Pesan EndInteraction akan ditambahkan ke respons.
ESCALATED: Playbook memutuskan bahwa ia tidak dapat mencapai tujuan dan perlu meningkatkan situasi kepada manusia. Sesi akan berakhir dengan status yang ditingkatkan. Pesan EndInteraction akan ditambahkan ke respons.
PENDING: Percakapan masih berlanjut dalam playbook.

Contoh tingkat teratas dan pemanggilan playbook-nya harus ditandai dengan status yang sesuai dengan playbook yang dirujuknya.

Strategi pemilihan

Setelan strategi pemilihan mengontrol apakah contoh disertakan dalam perintah playbook yang dikirim ke LLM. Tersedia opsi-opsi berikut:

Pilihan dinamis: Contoh disertakan secara kondisional, berdasarkan seberapa relevan contoh tersebut dengan konteks percakapan saat ini. Contoh dapat dihilangkan jika perintah mendekati batas token.
Selalu pilih: Contoh selalu disertakan, terlepas dari konteks percakapan. Contoh dapat dihilangkan jika perintah mendekati batas token.
Jangan pernah pilih: Contoh tidak pernah disertakan dalam perintah. Contoh ini tidak akan memengaruhi performa playbook. Setelan ini berguna untuk mengecualikan contoh sementara untuk pengujian.

Tambahkan tindakan

Contoh yang diberikan dalam playbook terdiri dari serangkaian tindakan. Tindakan ini dapat bervariasi dalam kombinasinya, tetapi terutama menggambarkan interaksi antara pengguna dan playbook, bersama dengan tindakan yang dilakukan di antaranya untuk memenuhi kueri atau persyaratan pengguna.

Ada dua cara untuk menambahkan tindakan ke contoh:

Untuk menambahkan tindakan secara manual, klik tombol + di bagian bawah panel kanan atau tombol Tambahkan tindakan saat Anda mengarahkan kursor ke tindakan yang ada. Anda dapat menggunakan opsi ini saat membuat contoh baru dengan mengklik opsi + Contoh atau saat mengedit contoh yang ada.
Untuk membuat tindakan secara otomatis berdasarkan petunjuk playbook yang ada, masukkan input pengguna di kolom Masukkan input pengguna di bagian bawah panel kanan. Anda dapat menggunakan opsi ini saat membuat atau mengedit contoh. Atau, Anda dapat menggunakan opsi ini saat menguji playbook saat runtime di panel Pratinjau playbook di sebelah kanan. Untuk menyimpan tindakan ke contoh dari panel Pratinjau playbook, klik Simpan contoh setelah memilih pemanggilan playbook dari daftar pemanggilan di sebelah kiri panel Pratinjau playbook.

Pastikan untuk memeriksa kebenaran tindakan yang dibuat secara otomatis dan mengeditnya jika diperlukan. Hal ini sangat penting untuk playbook dengan sedikit atau tanpa contoh.

Jenis tindakan berikut didukung oleh playbook:

Respons playbook

Respons playbook terhadap kueri pengguna.

Input pengguna

Kueri pengguna.

Penggunaan alat

Ini adalah pemanggilan alat untuk mendapatkan informasi tambahan yang diperlukan untuk memenuhi kueri pengguna. Tindakan ini harus menentukan detail berikut:

Alat: Nama alat yang harus dipanggil.
Action: Nama operasi untuk alat OpenAPI yang harus dipanggil. Untuk alat penyimpanan data dan alat fungsi, nama tindakan sama dengan nama alat.
Input alat: Input yang akan disertakan dalam panggilan alat. Respons ini biasanya berasal dari giliran percakapan sebelumnya dengan pengguna.

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

Contoh alat Open API requestBody input untuk tindakan createPet:
```
{
  "id": 1,
  "name": "Luna"
}
```
Untuk alat penyimpanan data, contoh requestBody 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 Open API tools, error ini juga dapat berupa error string (misalnya, "404 Not found").

Contoh output alat Open API untuk tindakan listPets:

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

Contoh output alat penyimpanan Data:

{
  "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 memastikan playbook aman dari kegagalan, sertakan juga contoh cara playbook harus merespons saat pemanggilan alat gagal. Kegagalan pemanggilan alat Open API dapat ditampilkan sebagai string error ("404 tidak ditemukan") dalam output alat. Untuk alat penyimpanan data input fallback dapat digunakan 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 direspons oleh playbook. Jika URI ini berasal dari alat penyimpanan data, maka output alat penyimpanan data harus berisi URI yang cocok dengan URI dalam respons playbook. Perhatikan bahwa fallback tidak dapat digunakan dalam skenario ini karena akan menonaktifkan kemampuan playbook LLM untuk menyusun ulang jawaban alat penyimpanan data agar menyertakan URI dalam respons playbook.

Contoh yang berisi tindakan penggunaan alat bisa sangat panjang dan berkontribusi pada peningkatan konsumsi batas token input. Untuk memastikan penggunaan token yang efisien, pastikan output alat ringkas dan berisi informasi yang relevan dengan tujuan playbook. Untuk alat penyimpanan data, pertimbangkan untuk menghapus cuplikan dari contoh karena dapat berkontribusi pada konsumsi token input yang tinggi.

Pemanggilan playbook

Tindakan ini digunakan saat playbook harus memanggil playbook tugas lain untuk memenuhi kueri pengguna. Tindakan ini harus menentukan detail berikut:

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

Transisi playbook

Tindakan transisi playbook adalah tindakan terminal (tidak boleh diikuti oleh tindakan lain) yang menunjukkan bahwa playbook rutin telah memutuskan untuk keluar dan bertransisi ke playbook rutin target. Perhatikan bahwa karena tindakan ini menunjukkan bahwa playbook keluar, tambahkan parameter output playbook ke output playbook contoh.

Pemanggilan alur

Tindakan ini digunakan saat playbook tugas harus memanggil alur. Tindakan ini harus menentukan detail berikut:

Flow: Nama alur yang akan dipanggil.
Parameter input alur: Parameter input yang akan diteruskan ke alur.
Parameter kembalian alur: Parameter output yang ditampilkan dari alur.

Transisi alur

Tindakan transisi Alur adalah tindakan terminal (tidak boleh diikuti oleh tindakan lain) yang menunjukkan bahwa buku pedoman rutin telah memutuskan untuk keluar dan bertransisi ke alur target. Perhatikan bahwa karena tindakan ini menunjukkan bahwa playbook keluar, tambahkan parameter output playbook ke output playbook contoh.

Sebelumnya

Tindakan kondisional playbook

Berikutnya

Parameter playbook