Membuat dan mengedit topik

Di Copilot Studio, topik menentukan perkembangan percakapan agen.

Untuk menulis topik, Anda dapat menjelaskan apa yang Anda inginkan dan meminta AI membuat topik untuk Anda, atau membuat topik dari awal.

Untuk informasi selengkapnya tentang batas agen dan topik, lihat Kuota, batasan, pendaftaran aplikasi, sertifikat, dan nilai konfigurasi.

Memilih topik yang tepat untuk menanggapi pengguna

Untuk menentukan cara menanggapi pengguna, agen menggunakan orkestrasi generatif atau orkestrasi klasik.

Dengan orkestrasi generatif, agen menjawab kueri pengguna atau merespons pemicu kejadian dengan memilih kombinasi topik, alat, dan pengetahuan yang paling tepat. Setiap topik memiliki deskripsi yang memberi tahu agen tentang tujuannya. Pelajari lebih lanjut tentang penulisan deskripsi.

Dalam agen yang dikonfigurasi untuk menggunakan orkestrasi klasik, setiap topik memiliki serangkaian frasa pemicu—frasa, kata kunci, dan pertanyaan yang kemungkinan akan digunakan pelanggan untuk kueri yang terkait dengan masalah tertentu. Agen-agen ini menggunakan pemahaman bahasa alami, pesan pelanggan, dan frasa pemicu topik untuk menemukan topik terbaik. Masukan pelanggan tidak perlu sama persis dengan frasa pemicu topik untuk memicu topik. Misalnya, topik tentang jam buka toko mungkin memiliki frasa pemicu "periksa jam buka toko". Jika pelanggan memasukkan "lihat jam buka toko", frasa ini akan memicu topik jam buka toko Anda. Pelajari lebih lanjut cara menulis frasa pemicu.

Topik di Copilot Studio

Di Copilot Studio, topic mewakili sebagian percakapan antara pengguna dan agen. Anda menentukan topik pada kanvas penulisan. Topik berisi satu atau beberapa simpul, yang bersama-sama menentukan jalur percakapan yang dapat diambil topik. Setiap node melakukan tindakan, seperti mengirim pesan atau mengajukan pertanyaan.

Agen dapat memiliki dua jenis topik: topik sistem dan kustom . Setiap agen baru dimulai dengan serangkaian topik sistem dan kustom yang telah ditentukan sebelumnya.

  • Topik sistem mendukung perilaku penting, seperti permintaan kustom untuk berbicara dengan seseorang atau mengakhiri percakapan. Beberapa topik sistem memiliki frasa pemicu yang dapat Anda sesuaikan agar sesuai dengan kebutuhan agen Anda.

    • Anda tidak dapat membuat topik sistem.
    • Anda tidak dapat menghapus topik sistem, tetapi Anda dapat menonaktifkannya.
      • Anda dapat membuat perubahan pada topik sistem. Namun, Anda harus menunggu hingga merasa nyaman dalam membuat pengalaman agen yang lengkap sebelum mulai mengedit topik sistem.

    Untuk informasi selengkapnya, silakan lihat Menggunakan topik sistem.

  • Topik kustom yang telah ditentukan sebelumnya mencakup perilaku umum, seperti menyapa pelanggan, mengakhiri percakapan, atau memulai ulang percakapan.

    • Anda dapat membuat perubahan pada topik kustom yang telah ditentukan sebelumnya atau menghapusnya dari agen Anda sepenuhnya.
    • Semua topik yang Anda buat adalah topik kustom.

Jenis Node

Jenis node berikut tersedia.

Jenis node Deskripsi
Node Pesan Kirim pesan kepada pelanggan.
Node pertanyaan Ajukan pertanyaan ke pelanggan.
Node Kartu adaptif Tampilkan kartu interaktif dengan satu atau beberapa tombol respons atau bidang input.
Kondisi node Buat cabang percakapan Anda berdasarkan suatu kondisi.
Node Manajemen variabel Tetapkan nilai, uraikan nilai, atau hapus variabel (termasuk kemampuan untuk menghapus riwayat percakapan yang digunakan oleh agen).
Manajemen topik Mengalihkan percakapan, mentransfer pengguna, atau mengakhiri topik atau percakapan.
Node Alat Panggil alur seperti Power Automate atau Excel Online, atau gunakan konektor atau jenis alat lain.
Tingkat Lanjut Kirim jawaban generatif, permintaan HTTP, peristiwa, dan lainnya.

Tip

Ganti nama node agar lebih mudah diidentifikasi. Pilih bidang nama simpul untuk memperbarui nama secara langsung, atau pilih tiga titik (...) simpul dan pilih Ganti nama dari menu. Anda juga dapat mengganti nama node di editor kode.

Tidak mungkin mengganti nama simpul Pemicu dan simpul Pindah ke langkah.

Nama node dapat memiliki panjang hingga 500 karakter.

Buat topik

  1. Pergi ke halaman Topik milik agen Anda. Untuk visibilitas yang lebih baik, tutup panel pengujian.

  2. Pilih Tambahkan topik, lalu pilih Dari kosong.

    Node Pemicu muncul di kanvas penulisan topik kosong.

  3. Pilih tiga titik (...) dari simpul Pemicu, lalu pilih Properti. Panel properti Saat niat yang Dikenali muncul.

  4. Di properti saat Niat yang Dikenali, pilih area Frasa. Panel Frasa sekunder itu muncul.

  5. Di bagian Tambahkan frasa, masukkan frasa pemicu untuk topik Anda.

    Agen Anda membutuhkan 5 hingga 10 frasa pemicu untuk melatih AI agar memahami tanggapan pelanggan Anda. Untuk menambahkan lebih banyak frasa pemicu, Anda dapat:

    • Memilih ikon Tambahkandi samping bidang teks, dan masukkan frasa yang diinginkan.
    • Tempelkan serangkaian frasa pemicu, masing-masing pada baris terpisah, dan pilih Enter.
    • Ketik serangkaian frasa pemicu, tekan Shift+Enter setelah masing-masing frasa untuk menempatkannya di baris terpisah, dan pilih Enter.
    • Unggah file yang mencantumkan frasa pemicu yang ingin Anda tambahkan untuk topik ini.

    Anda dapat menyertakan tanda baca di frasa pemicu, namun sebaiknya gunakan frasa singkat dan bukan kalimat panjang.

  6. Pilih Detail pada toolbar untuk membuka panel Detail topik.

  7. Tambahkan detail untuk topik Anda:

    • Masukkan nama untuk mengidentifikasi topik, seperti "Jam penyimpanan." Halaman Topik mencantumkan semua topik yang ditentukan dalam agen Anda dengan nama ini.
    • Jika diinginkan, masukkan nama tampilan untuk ditampilkan kepada pelanggan saat agen tidak dapat menentukan topik mana yang cocok dengan pesan pelanggan.
    • Jika diinginkan, gunakan bidang Deskripsi untuk menjelaskan tujuan topik untuk diri Anda sendiri dan pembuat agen lain di tim Anda. Pelanggan tidak pernah melihat deskripsi topik.
  8. Untuk menyimpan topik Anda, pada bilah menu atas, pilih Simpan.

Penting

Hindari menggunakan titik (.) dalam nama topik Anda. Tidak dimungkinkan untuk mengekspor solusi yang berisi agen dengan tanda titik di nama salah satu topiknya.

Unggah frasa pemicu untuk topik

Dari panel Frasa dari node Pemicu suatu topik, Anda dapat menambahkan atau mengganti kumpulan frasa pemicu yang terkait dengan topik.

  1. Siapkan file teks (maksimal 3 MB) yang mencantumkan semua frasa pemicu yang ingin Anda tambahkan untuk topik Anda, dengan setiap frasa di baris terpisah.

  2. Di bagian Tambahkan frasa, pilih unggah file.

  3. Di Unggah file, pilih opsi yang diinginkan:

    • Jika Anda ingin menambahkan frasa pemicu baru untuk topik Anda, pilih Tambahkan.
    • Untuk mengganti semua frasa pemicu yang ada dengan daftar dari file Anda, pilih Ganti.
  4. Jatuhkan file Anda ke jendela. Atau, pilih klik untuk menelusuri, navigasikan ke file Anda, dan pilih.

  5. Tinjau frasa pemicu yang muncul, lalu pilih Tambahkan.

  6. Simpan topik Anda.

Unduh frasa pemicu untuk topik

Dari panel Frasa pada node Pemicu sebuah topik, Anda dapat mengunduh kumpulan frasa pemicu yang terkait dengan topik tersebut.

  1. Di bagian Tambahkan frasa, pilih unduh.

  2. Simpan file teks yang dihasilkan, atau buka di editor teks untuk meninjau kontennya. Setiap frasa pemicu muncul di baris terpisah.

Sunting topik

Saat Anda membuat topik, node Pemicu secara otomatis muncul di kanvas penulisan. Anda kemudian dapat menambahkan berbagai jenis node untuk mencapai jalur percakapan yang diinginkan untuk topik Anda.

Untuk menambahkan node setelah node lain atau antara dua node pada kanvas penulisan topik Anda:

  1. Pilih ikon Tambahkan simpul di bawah simpul setelah itu Anda ingin menambahkan simpul baru.

  2. Pilih jenis node yang diinginkan dari daftar yang muncul.

Menghapus simpul

Pilih tiga titik (...) dari simpul yang ingin Anda hapus, lalu pilih Hapus.

Kontrol untuk mengedit node pada kanvas

Gunakan kontrol pada toolbar untuk memotong, menyalin, menempelkan, dan menghapus simpul yang dipilih atau simpul yang berdekatan yang dipilih.

Toolbar juga memiliki kontrol untuk mengurungkan pengeditan. Klik ikon Batalkan kemudian pilih:

  • Urungkan untuk mengurungkan perubahan terbaru
  • Urungkan ke penyimpanan terakhir untuk mengembalikan semua tindakan kembali ke penyimpanan terakhir
  • Lakukan lagi untuk melakukan ulang tindakan sebelumnya

Tempel node

Setelah Anda menggunakan alat Potong atau Salin untuk menempatkan satu atau beberapa simpul di clipboard, Anda dapat menempelkannya di kanvas dengan dua cara:

  • Jika Anda memilih node lalu memilih Tempel, node pada papan klip disisipkan setelah node yang dipilih.

  • Jika Anda memilih "+" untuk melihat menu Tambahkan node, lalu memilih Tempel, node pada papan klip disisipkan di lokasi tersebut.

Menambah parameter input dan output untuk topik

Topik dapat memiliki parameter input dan output. Saat topik dialihkan ke topik lain, Anda dapat menggunakan parameter ini untuk meneruskan informasi antar topik.

Selain itu, jika agen Anda menggunakan mode generatif, agen Anda dapat secara otomatis mengisi input topik dari konteks percakapan, atau setelah membuat pertanyaan untuk mengumpulkan nilai dari pengguna. Perilaku ini mirip dengan cara kerja pengisian slot generatif untuk tindakan.

Untuk mempelajari selengkapnya tentang parameter input dan output untuk topik, lihat Mengelola input dan output topik.

Mengedit topik dengan editor kode

Editor kode menampilkan topik di YAML, bahasa markup yang mudah dibaca dan dipahami. Gunakan editor kode untuk menyalin dan menempelkan topik dari bot lain—bahkan yang dibuat oleh penulis lain.

Penting

Mendesain topik sepenuhnya di editor kode dan menempelkan topik kompleks tidak sepenuhnya didukung.

Dalam contoh ini, Anda menyalin dan menempelkan YAML ke editor kode untuk menambahkan topik dengan cepat yang meminta informasi pengiriman pelanggan.

  1. Pada halaman Topik, pilih Tambahkan topik>Dari kosong.

  2. Di sudut kanan atas kanvas penulisan, pilih Lainnya, lalu pilih Buka editor kode.

    Tangkapan layar tentang cara membuka editor kode untuk suatu topik.

  3. Pilih dan hapus konten editor kode. Kemudian salin dan tempel kode YAML berikut:

    kind: AdaptiveDialog
    beginDialog:
      kind: OnRecognizedIntent
      id: main
      intent:
        displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
        triggerQueries:
          - Buy items
          - Buy online
          - Buy product
          - Purchase item
          - Order product
    
      actions:
        - kind: SendMessage
          id: Sjghab
          message: I am happy to help you place your order.
    
        - kind: Question
          id: eRH3BJ
          alwaysPrompt: false
          variable: init:Topic.State
          prompt: To what state will you be shipping?
          entity: StatePrebuiltEntity
    
        - kind: ConditionGroup
          id: sEzulE
          conditions:
            - id: pbR5LO
              condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"
    
          elseActions:
            - kind: SendMessage
              id: X7BFUC
              message: There will be an additional shipping charge of $27.50.
    
            - kind: Question
              id: 6lyBi8
              alwaysPrompt: false
              variable: init:Topic.ShippingRateAccepted
              prompt: Is that acceptable?
              entity: BooleanPrebuiltEntity
    
            - kind: ConditionGroup
              id: 9BR57P
              conditions:
                - id: BW47C4
                  condition: =Topic.ShippingRateAccepted = true
    
              elseActions:
                - kind: SendMessage
                  id: LMwySU
                  message: Thank you and please come again.
    
  4. Pilih Simpan, lalu pilih Tutup editor kode. Perhatikan logika bersyarkat yang mengikuti beberapa node Pertanyaan .

    Screenshot percakapan yang dibuat dari YAML di editor kode Copilot Studio.

Menguji dan memublikasikan

Uji agen Anda saat membuat perubahan pada topik, untuk memastikan semuanya berjalan sesuai yang diharapkan.

Setelah puas, terbitkan agen Anda ke saluran yang diinginkan.