Mengelola topik

Note

Artikel ini menjelaskan fitur yang digunakan oleh agen atau alur agen yang didukung oleh standard harness.

Ada banyak cara untuk mengelola topik Anda. Copilot Studio menyertakan pemeriksa topik yang memungkinkan Anda mengetahui apakah ada kesalahan dalam topik Anda. Anda dapat mengaktifkan atau menonaktifkan topik agar tidak muncul kepada orang yang mengobrol dengan agen Anda. Anda juga dapat menduplikasi topik untuk mempermudah pembuatan topik baru.

Tinjau kesalahan topik

Aplikasi web

Saat Anda menyimpan topik, Copilot Studio melaporkan masalah apa pun dalam topik tersebut.

• Kesalahan menghentikan agen Anda untuk bekerja. Anda harus memperbaikinya sebelum Anda dapat memublikasikan agen Anda.
• Peringatan tidak menghentikan agen Anda untuk bekerja, tetapi dapat menyebabkan beberapa topik tidak berfungsi seperti yang diharapkan. Anda harus memperbaiki peringatan ketika melihatnya.

Pada halaman Topik , Anda dapat melihat apakah topik memiliki kesalahan, dan jumlah kesalahan, di kolom Kesalahan . Halaman ini hanya menampilkan error karena, tidak seperti peringatan, error mencegah agen Anda berfungsi.

1. Buka topik Anda dari halaman Topik .

2. Pilih Pemeriksa Topik di toolbar.

   Panel Pemeriksa topik muncul, melaporkan kesalahan dan peringatan untuk topik Anda.

3. Pilih kesalahan untuk langsung menuju ke simpul yang mengandung kesalahan.

Rencana tim

Saat menyimpan topik, Anda akan diberi tahu jika ada kesalahan atau peringatan. Peringatan tidak menghentikan agen untuk bekerja, tetapi dapat menyebabkan topik individual tidak berfungsi seperti yang diharapkan, jadi Anda harus memperbaikinya saat melihatnya. Kesalahan mencegah agen bekerja dan harus diperbaiki sebelum Anda dapat menerbitkannya.

Anda dapat melihat apakah ada kesalahan dalam topik di kolom Kesalahan di halaman Topik .

Pilih jumlah kesalahan untuk membuka kanvas penyuntingan untuk menuju ke lokasi kesalahan. Pilih Pemeriksa topik untuk melihat daftar kesalahan. Memilih setiap kesalahan akan langsung menuju kesalahan.

Ada empat jenis kesalahan yang muncul di pemeriksa topik dan di kanvas penulisan:

• Node: Seluruh node salah dan disorot merah.
• Bidang: Bidang kemungkinan tidak memiliki data yang diperlukan dan disorot merah.
• Ekspresi: Ekspresi mungkin tidak valid dan disorot merah.
• Penghapusan variabel: Variabel dalam topik dihapus dan kesalahan disorot merah di mana pun variabel digunakan. Variabel yang dihapus menyebabkan variabel menjadi "yatim piatu" dan harus dihapus atau diganti.

Mengaktifkan atau menonaktifkan topik

Topik dapat memiliki status Aktif atau Nonaktif untuk menunjukkan apakah topik tersebut dapat digunakan atau dipicu dalam percakapan agen. Secara default, topik baru dibuat dengan statusnya diatur ke Aktif.

Untuk mengubah status topik, buka halaman Topik , dan gunakan sakelar untuk topik yang diinginkan.

Saat topik Aktif , topik akan dipicu seperti yang diharapkan. Topik dipicu sebagai hasil dari frasa pemicunya atau ketika topik lain dialihkan ke topik tersebut.

Ketika topik dinonaktifkan :

• Ikon topik berubah menjadi abu-abu dengan indikator.
• Topik tidak memicu sama sekali.
• Topik tidak terpicu saat frasa pemicu digunakan dalam percakapan atau jika topik lain mengalihkan ke topik tersebut.
• Pemeriksa topik mengidentifikasi kesalahan jika topik lain dialihkan ke topik Nonaktif .
• Saat Anda menerbitkan agen, semua topik akan dipublikasikan, baik Aktif maupun Nonaktif.

Tip

Matikan topik untuk mengerjakannya dalam status draf. Biarkan statusnya di Nonaktif saat memublikasikan perubahan ke topik-topik lain yang siap ditayangkan.

Menyalin topik

Setelah membuat beberapa topik, Anda dapat menggunakan topik sebelumnya sebagai dasar saat membuat topik baru.

Di halaman Topik , pilih tiga titik (...) di samping nama topik Anda, lalu pilih Buat salinan.

Ini menduplikasi topik yang dipilih dengan (Salin) ditambahkan ke nama. Semua konten topik, seperti deskripsi, frasa pemicu, dan seluruh percakapan, disalin ke topik baru.

Untuk mencegah kebingungan dengan topik asli, yang memiliki frasa pemicu yang sama, pertimbangkan untuk menonaktifkan topik baru.

Setelah selesai mengedit topik baru, aktifkan untuk mengujinya. Setelah siap, publikasikan topik baru.

Tidak ada batasan berapa kali Anda dapat menyalin topik. Setiap topik memiliki ID internalnya sendiri.

Mengubah nama topik

Anda dapat menggunakan toolbar kanvas penulisan untuk mengganti nama topik dengan cepat. Di toolbar, pilih Topik, lalu pilih nama topik dalam daftar. Pada halaman topik, pilih nama topik, ketik nama baru, lalu tekan Enter.

Important

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

Alihkan ke topik lain

Untuk mengalihkan percakapan dari topik ke topik lain tanpa memulai dari awal, tambahkan simpul Pengalihan . Ketika percakapan mencapai akhir topik tujuan, percakapan akan dilanjutkan di topik asal secara default. Anda dapat menyisipkan lebih banyak simpul setelah simpul Pengalihan sesuai keinginan.

1. Pilih ikon Tambahkan simpul di bawah simpul setelah itu Anda ingin transisi terjadi, arahkan ke Manajemen topik dan pilih Buka topik lain.

2. Pilih topik tujuan yang diinginkan dari daftar.

3. Teruskan variabel antar topik jika diperlukan. Jika topik yang Anda alihkan memerlukan variabel input atau diharapkan mengembalikan variabel output ke topik asal, masukkan atau pilih nilai untuk masing-masing variabel.

4. Simpan topik Anda, lalu gunakan panel Test agent untuk mengonfirmasi bahwa agen Anda berhasil memanggil topik tujuan.

Pertimbangan status percakapan untuk memanggil ulang topik

Jika topik Anda menyertakan kartu pratinjau, perintah konfirmasi, dan tindakan konektor (seperti membuat item kerja Azure DevOps), topik tersebut tidak dapat dimasuki kembali dalam percakapan yang sama. Eksekusi pertama selesai seperti yang diharapkan, tetapi jika Anda dialihkan ke awal topik yang sama, pengatur agen dapat menggunakan kembali status dialog yang ada dan mungkin menganggap langkah-langkah konfirmasi sebelumnya sudah selesai. Akibatnya, pelaksanaan dapat berhenti setelah pratinjau.

Menghapus variabel atau mengalihkan ke simpul mulai tidak mengatur ulang status ini. Menduplikasi topik membuat konteks dialog baru, tetapi pendekatan ini tidak menskalakan untuk eksekusi berulang. Untuk mengatasi batasan ini:

• Pisahkan alur menjadi dua topik:
  • Gunakan topik induk (loop) untuk menanyakan apakah pengguna ingin membuat item kerja lain.
  • Gunakan topik child (eksekusi) untuk menangani pengumpulan data, pratinjau, konfirmasi, dan pembuatan item kerja Azure DevOps.
• Alihkan antar topik untuk mengatur ulang status percakapan dengan andal.

Pola ini memungkinkan pengguna untuk membuat beberapa item kerja dalam satu percakapan tanpa masalah.

Mengakhiri topik saat ini atau semua topik

Secara default, percakapan yang dialihkan kembali ke topik asal di akhir topik yang dipanggil. Untuk keluar dari topik, atau untuk mengakhiri percakapan, gunakan simpul Akhiri topik saat ini atau simpul Akhiri semua topik .

• Simpul Akhiri topik saat ini berfungsi untuk mengakhiri topik saat ini. Jika topik saat ini dipanggil dari topik lain, percakapan akan segera kembali ke topik asli. Penggunaan umum dari node ini adalah dalam cabang kondisi. Satu cabang keluar dari topik lebih awal, sementara cabang lain melanjutkan topik saat ini.

• Simpul Akhiri semua topik segera mengakhiri semua topik aktif. Agen Anda menganggap pesan berikutnya dari pengguna sebagai pesan pertama dalam percakapan baru.

  Untuk memberi tahu pengguna bahwa percakapan telah berakhir, tambahkan simpul Akhiri Percakapan sebelum simpul Akhiri semua topik .

Banyak topik sistem menggunakan node ini untuk mengontrol bagaimana percakapan berakhir atau memulai dari awal. Pelajari cara menggunakan topik sistem.

Tip

Simpul Akhiri semua topik tidak menghapus atau mengatur ulang variabel global apa pun. Untuk menghapus variabel global, gunakan simpul Hapus semua variabel terlebih dahulu. Anda dapat melihat contoh ini dalam topik sistem yang disebut Reset Percakapan di Copilot Studio.