Gunakan tindakan dengan agen kustom (pratinjau)

Anda dapat memperluas kemampuan agen Anda dengan menambahkan satu atau beberapa tindakan. Tindakan digunakan oleh agen Anda untuk merespons pengguna secara otomatis, menggunakan orkestrasi generatif, atau Anda dapat memanggilnya secara eksplisit dari dalam suatu topik.

Jenis tindakan inti

Jika Anda mengaktifkan orkestrasi generatif, agen Anda dapat secara otomatis memilih tindakan atau topik yang paling tepat, atau mencari di seluruh pengetahuan, untuk menanggapi pengguna.

Dalam mode klasik (orkestrasi generatif dinonaktifkan), agen hanya dapat menggunakan topik untuk merespons pengguna. Namun, Anda masih dapat mendesain agen Anda untuk memanggil tindakan secara eksplisit dari dalam topik.

Tindakan didasarkan pada salah satu jenis tindakan inti berikut:

• Tindakan konektor yang telah dibuat sebelumnya
• Tindakan konektor kustom
• Power Automate aliran awan
• AI Builder petunjuk (dalam suatu topik)
• Bot Framework keahlian
• Koneksi REST API

Setiap tindakan inti memiliki informasi tambahan yang menjelaskan tujuannya, yang memungkinkan agen menggunakan AI generatif untuk menghasilkan pertanyaan. Pertanyaan-pertanyaan ini diperlukan untuk mengisi masukan yang dibutuhkan untuk melakukan tindakan. Oleh karena itu, Anda tidak perlu membuat simpul pertanyaan secara manual untuk mengumpulkan semua masukan yang diperlukan, seperti masukan dalam alur. Masukan ditangani untuk Anda pada saat runtime.

Secara default, saat menggunakan mode generatif, tindakan mengembalikan informasinya ke agen, sehingga agen dapat menghasilkan respons kontekstual terhadap pertanyaan pengguna. Alternatifnya, Anda dapat menginstruksikan tindakan Anda untuk selalu merespons dengan segera, baik dengan membuat pesan atau menulis pesan yang jelas.

Tambah tindakan

1. Buka agen Anda dengan memilih Agen di panel navigasi sebelah kiri dan pilih agen Anda dari daftar.

2. Pilih Tindakan untuk melihat tindakan bagi agen.

3. Pilih Tambahkan tindakan.

4. Pada panduan Pilih tindakan , cari tindakan yang ingin Anda gunakan dan pilih.

   Daftar default yang ditampilkan memiliki Power Automate Alur dan konektor kustom yang tersedia dalam lingkungan Anda. Daftar ini menyertakan konektor prabangun yang umum digunakan dan Bot Framework Keterampilan yang terdaftar pada agen Anda.

   

   Penting

   Beberapa tindakan yang dibuat dari Plugin AI, seperti Dynamic Prompts dan yang berbasis Dataverse API, memerlukan autentikasi.

   Bergantung pada tindakannya, koneksi Anda dikonfigurasi secara otomatis, seperti yang ditunjukkan dalam contoh. Jika tidak, ikuti petunjuk wizard untuk mengonfigurasi koneksi. Setelah koneksi Anda berhasil dikonfigurasi, pilih Berikutnya.

   

5. Tinjau konfigurasi tindakan plugin Anda, dan buat perubahan jika diperlukan.

   Pilih Selanjutnya.

6. Pilih Selesai untuk menambahkan tindakan ke agen Anda.

Uji tindakan

Jika Anda mengaktifkan orkestrasi generatif, tindakan Anda dipanggil secara otomatis sebagai respons terhadap permintaan pengguna yang relevan.

Alternatifnya, Anda dapat memanggil suatu tindakan secara eksplisit dari dalam suatu topik.

Agen Anda memilih dan menjalankan tindakan Anda berdasarkan nama dan deskripsi. Anda dapat menulis deskripsi berkualitas tinggi, menggunakan peta aktivitas untuk melihat tindakan mana yang dipilih agen Anda dari halaman tindakan .

Anda dapat melihat aksi cuaca yang sedang diuji pada tangkapan layar ini:

Buat perubahan pada konfigurasi tindakan Anda

Ada banyak cara untuk mengonfigurasi tindakan Anda. Pada langkah terakhir panduan tindakan, yang disebut Tinjau dan Selesai, Anda dapat membuat perubahan pada konfigurasi tindakan Anda dengan mengeklik Edit di samping bagian yang sesuai. Dari layar Tinjau masukan dan keluaran di wizard, atau dari halaman detail untuk tindakan yang sudah menjadi bagian dari agen Anda, Anda dapat mengelola parameter masukan dan keluaran untuk tindakan tersebut.

Detail tindakan

Di sini Anda dapat mengonfigurasi detail tentang tindakan Anda, termasuk Nama tampilan Model dan Deskripsi Model untuk tindakan Anda. Biasanya, nama dan deskripsi sudah diisi sebelumnya untuk Anda berdasarkan tindakan yang Anda pilih.

Properti Nama Tampilan dan Deskripsi untuk setiap masukan membantu agen memahami tujuan masukan, untuk menghasilkan pertanyaan yang tepat bagi pengguna, dan untuk mengenali nilai yang benar dalam respons pengguna. Misalnya, berikut ini adalah nama default dan deskripsi parameter input lokasi untuk konektor MSN Weather.

• Nama: Lokasi
• Deskripsi: Permintaan pencarian lokasi. Input yang valid adalah Kota, Wilayah, Negara Bagian, Negara, Landmark, Kode Pos, Lintang dan Bujur.

Ketika agen meminta lokasi kepada pengguna, ia akan membuat pertanyaan seperti Di lokasi mana Anda ingin memeriksa cuaca? Anda dapat memasukkan kota, wilayah, negara bagian, negara, tempat terkenal, atau kode pos.

Anda dapat mengubah opsi Identifikasi sebagai ke jenis entitas tertentu, tergantung pada masukan yang dikumpulkan, yang dapat membantu agen mengekstrak nilai secara akurat dari respons pengguna.

Input

Secara default, setiap masukan diatur ke Diisi secara dinamis dengan opsi terbaik. Agen mencoba mengekstrak nilai dari konteks yang tersedia—misalnya, dari pesan pengguna. Jika tidak ditemukan nilai yang sesuai, maka akan muncul pertanyaan untuk menanyakan nilai kepada pengguna. Anda dapat mengganti masukan dengan suatu nilai, tanpa perlu menanyakannya kepada pengguna. Untuk menetapkan pengesampingan, untuk Bagaimana agen akan mengisi masukan ini?, pilih Tetapkan sebagai nilai, lalu masukkan nilai yang diinginkan. Nilai ini dapat berupa nilai literal, variabel yang ada, atau Power Fx rumus.

Untuk mengontrol perilaku agen Anda saat meminta nilai atau memvalidasi jawaban pengguna, Anda dapat mengonfigurasi pengaturan tambahan untuk input.

Output

Secara default, tindakan Anda dikonfigurasi untuk secara otomatis menghasilkan respons kontekstual bagi pengguna, berdasarkan kueri mereka dan hasil tindakan. Misalnya, jika pengguna bertanya, "Berapa suhu saat ini di London?", jawaban kontekstual dibuat menggunakan GPT, seperti "Suhu saat ini di London adalah 9 derajat Celsius."

Alternatifnya, Anda dapat memilih untuk menulis respons tertentu agar tindakan Anda dapat dibalas. Seperti halnya editor konfirmasi, Anda dapat menyisipkan referensi ke variabel keluaran dari tindakan menggunakan pemilih variabel, seperti yang ditunjukkan dalam contoh ini.

Memanggil tindakan dari dalam suatu topik

Anda dapat memanggil tindakan secara eksplisit dari dalam suatu topik, mirip dengan memanggil tipe tindakan lain seperti Power Automate Flows. Bergantung pada kasus penggunaan Anda, Anda dapat menggunakan Flow sebagai bagian dari topik yang lebih luas, yang menggunakan lebih banyak node. Atau, seperti pada contoh cuaca, menambahkan satu simpul tindakan ke suatu topik mungkin sudah cukup yang Anda perlukan.

Untuk memanggil tindakan dari dalam suatu topik:

1. Di Copilot Studio, buka halaman Topik untuk agen yang ingin Anda edit.

2. Buat topik baru dan beri nama Dapatkan cuaca.

3. Tambahkan frasa pemicu berikut:

   • apakah akan turun hujan
   • ramalan cuaca hari ini
   • dapatkan cuaca
   • bagaimana cuacanya

   

4. Pilih Tambahkan simpul (+) lalu pilih Panggil tindakan. Beralih ke tab Tindakan plugin (pratinjau) lalu pilih tindakan yang Anda buat sebelumnya, Dapatkan ramalan cuaca.

   

5. Node Tindakan Plugin (pratinjau) Anda sekarang telah ditambahkan ke topik Anda.

   

6. Pilih Simpan.

Mengganti masukan saat memanggil tindakan dari suatu topik

Secara default, saat tindakan Anda berjalan, agen Anda akan membuat pertanyaan bagi pengguna untuk mengisi input yang diperlukan. Namun, Anda mungkin ingin mengesampingkan satu atau beberapa masukan dan memberikan nilai eksplisit alih-alih menanyakannya kepada pengguna. Anda dapat mengganti konfigurasi tindakan plugin dalam bagian Input . Atau, Anda dapat mengganti nilai hanya ketika tindakan Anda digunakan dari topik tertentu:

1. Pilih Tetapkan nilai pada node dan pilih masukan yang ingin Anda timpa.

   

2. Masukkan nilai input dengan mengetikkan nilai, memilih variabel, atau menggunakan rumus.

   

Sekarang masukan ini ditimpa, agen tidak meminta nilai kepada pengguna.

Aktifkan autentikasi untuk tindakan AI

Beberapa tindakan, jika dibuat berdasarkan tindakan AI, memerlukan autentikasi agar berfungsi dengan benar, seperti Perintah Dinamis atau tindakan lain yang memanggil Dataverse API.

Tindakan selalu dijalankan dalam runtime agen dalam konteks pengguna dan tidak dapat dijalankan kecuali autentikasi diaktifkan. Dua jenis metode autentikasi didukung:

1. Buka properti tindakan konektor.

2. Di bawah Autentikasi pengguna akhir, pilih Autentikasi penulis agen.

3. Publikasikan dan uji pengalaman di panel pengujian agen, atau di saluran yang diinginkan.

   

Gunakan tindakan aliran dengan kredensial pengguna

Tindakan aliran dapat dikonfigurasi untuk menggunakan kredensial pengguna. Menggunakan alur di saluran yang didukung tidak memerlukan konfigurasi khusus dalam dialog agen Anda, dan pengguna dapat mengelola koneksi mereka untuk alur tertentu dalam pengalaman yang disediakan.

Otentikasi untuk tindakan berdasarkan plugin di perpustakaan Anda

Saat dibuat berdasarkan plugin AI, tindakan memerlukan autentikasi agar berfungsi dengan benar. Hal ini paling sering terlihat pada tindakan berdasarkan perintah atau perintah lain yang memanggil Dataverse API. Tindakan berdasarkan plugin selalu dijalankan dalam konteks pengguna dan tidak dapat dijalankan kecuali autentikasi diaktifkan. Dua jenis metode autentikasi didukung:

• Autentikasi terintegrasi (Teams dan Power Apps): Anda dapat menggunakan metode autentikasi ini jika ingin menerbitkan agen Anda ke saluran Teams. Metode ini juga berfungsi untuk agen yang tertanam dalam aplikasi mana pun yang menggunakan token yang dibuat dengan standar PPAPI. Power Platform

• Otentikasi manual (agen pihak ketiga): Metode autentikasi ini melibatkan pengaturan koneksi Microsoft Entra ID.

Untuk membuat koneksi autentikasi manual:

1. Siapkan aplikasi Microsoft Entra ID.

2. Siapkan autentikasi manual untuk agen Anda.

3. Izinkan aplikasi Anda menggunakan delegasi untuk mengambil token atas nama pengguna. Pastikan untuk menambahkan cakupan yang diperlukan.