Bagikan melalui

Menambahkan alat ke agen kustom

Alat adalah blok bangunan yang memungkinkan agen Anda berinteraksi dengan sistem eksternal. Alat memperluas apa yang dapat dilakukan agen Anda, memungkinkan agen Anda melakukan berbagai tindakan sebagai respons terhadap permintaan pengguna atau pemicu otonom. Setiap alat mewakili kemampuan tertentu yang dapat dilakukan agen Anda. Misalnya, Anda dapat melengkapi agen Anda dengan alat yang melakukan tugas seperti:

  • Mengirim email menggunakan konektor Office 365 Outlook
  • Periksa kondisi dan prakiraan cuaca saat ini
  • Membaca dan menulis data dari Dataverse
  • Membaca dan memposting pesan ke Teams

Mekanisme untuk menambahkan alat ke agen

Anda dapat memperluas kemampuan agen kustom Anda dengan menambahkan satu atau beberapa alat. Agen Anda dapat menggunakan alat untuk merespons pengguna secara otomatis, menggunakan orkestrasi generatif. Anda juga dapat memanggil alat secara eksplisit dari dalam topik.

Dengan orkestrasi generatif (aktif secara default), agen Anda dapat secara otomatis memilih alat atau topik yang paling tepat, atau mencari di seluruh pengetahuan, untuk menanggapi pengguna. Mode orkestrasi ini menciptakan pengalaman percakapan yang lebih dinamis dan cerdas.

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

Ada beberapa mekanisme yang tersedia untuk Anda untuk menambahkan alat ke agen Anda:

  • Konektor: Sambungkan ke API dan layanan eksklusif menggunakan Konektor Power Platform untuk menarik data atau melakukan tindakan.
    • Konektor bawaan: Pilih dari pilihan koneksi prasetel ke ribuan API populer dari layanan Microsoft dan non-Microsoft.
    • Konektor kustom: Tentukan koneksi ke layanan atau sistem kustom untuk mengaktifkan opsi alat kustom menggunakan Konektor Power Platform. Konektor memerlukan izin melihat dan berbagi untuk organisasi agar agen dapat menggunakan konektor.
  • Alur agen: Tentukan alur agen, termasuk satu atau beberapa tindakan yang harus dilakukan.
  • Prompt: Prompt tunggal berbasis model yang dapat mereferensikan pengetahuan yang Anda berikan dan menghasilkan kode untuk menganalisis data.
  • REST API: Tentukan koneksi ke REST API, dan pilih satu atau beberapa titik akhir API dan metode untuk ditambahkan sebagai alat.
  • Protokol Konteks Model: Sambungkan ke server MCP untuk mengakses alat dan sumber daya.
  • Penggunaan komputer: Memungkinkan agen Anda berinteraksi dengan sistem apa pun yang memiliki antarmuka pengguna grafis, untuk situs web dan aplikasi desktop, memilih tombol, memilih menu, dan memasukkan teks ke bidang di layar.

Ada dua mekanisme lain yang dapat Anda gunakan untuk menambahkan perilaku seperti alat ke agen Anda:

  • Keterampilan: Wadah untuk sekumpulan alat terkait.
  • Alat klien: Kirim aktivitas peristiwa ke klien sehingga klien melakukan tindakan dan mengembalikan respons.

Untuk informasi selengkapnya tentang keterampilan dan alat klien, lihat tautan di bagian Konten terkait .

Membuat dan menambahkan alat baru di tingkat agen

Membuat alat baru langsung dalam Copilot Studio menyederhanakan proses pengembangan dan memastikan integrasi yang tepat dengan agen Anda. Alat yang ditambahkan ke agen tersedia untuk orkestrasi otomatis di seluruh percakapan agen Anda.

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

  2. Buka halaman Alat untuk agen.

  3. Pilih Tambahkan alat.

  4. Di panel Tambahkan alat , pilih Alat baru.

  5. Pilih jenis alat yang ingin Anda tambahkan dari daftar yang muncul:

    • Cepat
    • Alur agen
    • Penggunaan komputer
    • Konektor kustom
    • Protokol Konteks Model
    • REST API

    Cuplikan layar menampilkan pilihan untuk jenis alat baru yang akan ditambahkan ke agen

  6. Lakukan langkah-langkah konfigurasi khusus untuk jenis alat yang Anda pilih. Misalnya, jika Anda memilih Prompt, Anda harus melakukan langkah-langkah berikut:

    • Tentukan templat dan instruksi prompt
    • Tentukan parameter input
    • Mengonfigurasi sumber pengetahuan
    • Mengatur format respons dan batasan

  7. Pilih Simpan atau Publikasikan, sebagaimana berlaku, untuk membuat alat baru.

  8. Pilih Tambahkan dan konfigurasikan. Alat ini ditambahkan ke agen Anda. Halaman konfigurasi untuk alat Anda muncul. Anda dapat melihat dan membuat perubahan pada konfigurasi alat Anda di sini.

Anda dapat melihat alat baru di halaman Alat untuk agen.

Melihat dan membuat perubahan pada konfigurasi alat Anda

Anda dapat melihat dan mengedit konfigurasi alat Kapan saja: buka halaman Alat untuk agen Anda, dan pilih alat dari daftar alat.

Halaman konfigurasi untuk alat Anda terbuka. Detail ditampilkan dalam tiga bagian:

  • Detail lebih lanjut
  • Masukan
  • Completion

Untuk server MCP yang terhubung sebagai alat agen, halaman konfigurasi berbeda dari jenis alat lainnya. Bagian Detail serupa, namun alih-alih Input dan Penyelesaian, ada Alat dan Sumber daya dengan informasi tentang alat dan sumber daya yang tersedia untuk server MCP. Untuk informasi selengkapnya, lihat Menampilkan alat dan sumber daya di server MCP yang sudah ada.

Detail lebih lanjut

Bagian Detail memungkinkan Anda mengonfigurasi detail dasar tentang alat Anda.

Di sini, Anda dapat melihat dan memperbarui:

  • Nama: Nama alat. Nama ini muncul dalam daftar alat untuk agen Anda. Pilih nama yang dengan jelas menunjukkan fungsi alat.

  • Deskripsi: Deskripsi alat. Orkestrasi generatif bergantung pada deskripsi ini untuk menentukan kapan agen Anda harus menggunakan alat ini. Tulis deskripsi yang jelas dan spesifik termasuk apa yang dilakukan alat dan kapan alat tersebut harus digunakan.

  • Detail tambahan:

    • Izinkan agen untuk memutuskan secara dinamis kapan menggunakan alat: Ketika opsi ini dipilih, agen dapat menggunakan orkestrasi generatif untuk menentukan kapan harus menggunakan alat. Jika opsi ini tidak dipilih, agen hanya menggunakan alat saat secara eksplisit dipanggil dari topik. (Secara default, opsi ini dipilih ketika orkestrasi generatif diaktifkan.)
    • Tanyakan kepada pengguna akhir sebelum menjalankan: Dalam pengalaman obrolan pengguna akhir, mintalah konfirmasi kepada agen sebelum menjalankan alat. Opsi ini diatur ke Tidak secara default.
    • Autentikasi: Pilih apakah akan menggunakan kredensial yang disediakan pengguna (Pengguna akhir) atau pembuat (disediakan Pembuat-provided) untuk alat tersebut. Secara default, autentikasi pengguna berlaku.
    • Deskripsi: Secara opsional, Anda dapat menambahkan deskripsi alat yang ditunjukkan agen kepada pengguna saat ingin menjalankan alat. Deskripsi ini memungkinkan pengguna mengetahui apa yang diminta untuk diautentikasi.

Masukan

Di sini, Anda dapat melihat dan mengonfigurasi input untuk alat Anda. Input digunakan untuk mengumpulkan informasi dari pengguna untuk mengisi input yang diperlukan untuk alat tersebut. Informasi ditampilkan sebagai tabel, satu baris untuk setiap input.

Secara default, nilai kolom Isi menggunakan untuk setiap input diatur ke Isi secara dinamis dengan AI. Agen mencoba mengekstrak nilai dari konteks yang tersedia—misalnya, dari pesan pengguna. Jika tidak ada nilai yang sesuai ditemukan, ia akan menghasilkan pertanyaan untuk menanyakan nilai kepada pengguna. Pilih Sesuaikan untuk mengakses kustomisasi yang lebih halus untuk pengumpulan dan pengisian input:

  • Nama tampilan dan Deskripsi: Bagaimana input muncul kepada pengguna.
  • Identifikasi sebagai: Bagaimana respons pengguna ditafsirkan, misalnya sebagai string teks atau dipetakan ke entitas yang telah ditentukan sebelumnya.
  • Logika coba lagi: Jika agen tidak mengidentifikasi entitas dalam pernyataan pengguna, agen dapat mengajukan pertanyaan lagi.
  • Validasi input: Mengonfigurasi perilaku validasi tambahan pada input pengguna di luar default untuk jenis entitas.

Anda juga dapat memilih untuk mengambil alih input dengan nilai eksplisit alih-alih membiarkan agen mengekstraknya. Untuk menetapkan pengesampingan, atur Isi menggunakan ke Nilai kustom, dan masukkan nilai, pilih variabel, atau gunakan rumus Power Fx. Jika input diubah, agen tidak meminta pengguna untuk memberikan nilai.

Completion

Di sini, Anda dapat memilih apa yang ingin Anda lakukan ketika alat selesai berjalan.

Anda dapat meminta agen secara otomatis menghasilkan respons kontekstual untuk pengguna, berdasarkan kueri mereka dan hasil alat.

Atau, Anda dapat memilih untuk menulis respons tertentu yang diformat agar dapat digunakan oleh alat Anda. Anda dapat menyisipkan referensi ke variabel output dari alat menggunakan pemilih variabel. Anda juga bisa menggunakan rumus Power Fx untuk memformat respons.

Di bawah Setelah berjalan, pilih salah satu dari beberapa opsi berbeda untuk bagaimana alat harus merespons pengguna setelah alat berjalan:

  • Jangan merespons (default): Agen menggabungkan output alat ke dalam responsnya
  • Tulis respons dengan AI generatif: Biarkan AI membuat respons kontekstual menggunakan output alat
  • Mengirim respons tertentu: Menulis respons templat dengan penyisipan variabel
  • Mengirim kartu adaptif: Membuat respons interaktif yang kaya dengan tombol dan tindakan

Anda juga dapat mengonfigurasi variabel output mana yang akan tersedia untuk agen dan alat lainnya.

Pemilihan alat dan pengumpulan input

Saat menentukan alat di Copilot Studio, Anda juga memberikan informasi yang menjelaskan tujuannya. Informasi ini memungkinkan agen mengidentifikasi kapan harus menggunakan alat. Deskripsi alat ini juga membantu orkestrator menggunakan AI generatif untuk menghasilkan pertanyaan, sesuai kebutuhan, untuk mengumpulkan input. Agen Anda dapat menggunakan pertanyaan untuk mengumpulkan informasi untuk mengisi input yang diperlukan untuk menggunakan alat ini. Akibatnya, Anda tidak perlu menulis node pertanyaan secara manual untuk mengumpulkan semua input yang diperlukan, seperti input dalam alur. Orkestrator agen menangani pengumpulan input untuk Anda saat runtime.

Agen mempertimbangkan beberapa faktor untuk menentukan pemilihan alat:

  • Nama dan deskripsi alat
  • Konteks percakapan saat ini
  • Niat pengguna berasal dari pesan mereka
  • Input dan output yang tersedia
  • Penggunaan alat sebelumnya dalam percakapan

Saat menggunakan mode generatif, secara default, alat mengembalikan informasinya kembali ke agen. Dengan respons alat, agen dapat menghasilkan respons kontekstual untuk kueri pengguna. Atau, Anda dapat menginstruksikan alat anda untuk selalu segera merespons, baik membuat pesan atau menulis pesan eksplisit.

Petunjuk / Saran

Saat menggunakan pertanyaan yang dihasilkan dari alat, beri tahu pengguna Anda bahwa AI menghasilkan beberapa percakapan.

Misalnya, tambahkan pesan tambahan dalam topik sistem Mulai Percakapan . Topik ini menentukan pesan yang ditampilkan kepada pengguna saat percakapan baru dimulai.

Memanggil alat yang sudah ada dari dalam topik

Anda dapat memanggil alat secara eksplisit dari dalam topik. Bergantung pada kasus penggunaan Anda, Anda dapat menggunakan alat Anda sebagai bagian dari topik yang lebih luas, yang menggunakan beberapa simpul. Atau, seperti dalam contoh berikut, menambahkan satu simpul tindakan (alat) ke topik mungkin semua yang Anda butuhkan.

Untuk memanggil alat dari dalam topik:

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

  2. Buat topik baru, dan beri nama, misalnya, Dapatkan cuaca.

  3. Tambahkan Frasa pemicu yang sesuai. Untuk melanjutkan dengan contoh cuaca yang sama dari langkah sebelumnya, frasa pemicu dapat mencakup:

    • apakah akan hujan
    • prakiraan hari ini
    • dapatkan cuaca
    • apa cuacanya

  4. Pilih Tambahkan simpul (+) lalu pilih Tambahkan alat.

  5. Pilih alat dari alat yang tersedia. Ada tiga tab yang memperlihatkan berbagai jenis alat:

    • Alat dasar
    • Connector
    • Tool

    Simpul Tindakan Anda sekarang ditambahkan ke topik Anda.

  6. Pilih Simpan.

Informasi konektor MCP

Untuk konektor MCP, Anda dapat melihat nama dan deskripsi alat dan sumber daya MCP yang disediakan oleh konektor MCP. Informasi untuk alat dan sumber daya ditampilkan dalam tabel, satu baris untuk setiap alat.

Pertimbangan autentikasi untuk alat

Beberapa alat mengharuskan autentikasi berfungsi dengan benar, seperti Dynamic Prompt atau alat lain yang memanggil API Dataverse. Konfigurasi autentikasi yang tepat memastikan keamanan sambil mempertahankan pengalaman pengguna yang lancar.

Alat selalu dijalankan dalam waktu aktif agen dalam konteks pengguna dan tidak dapat dijalankan kecuali autentikasi diaktifkan. Dua jenis metode autentikasi didukung:

  • Kredensial pengguna akhir: Agen menggunakan kredensial pengguna untuk mengautentikasi dengan layanan. Metode ini memastikan pengguna hanya mengakses data yang diizinkan untuk dilihat.
  • Kredensial yang disediakan pembuat: Agen menggunakan kredensial penulisnya untuk diautentikasi dengan layanan. Gunakan mode autentikasi ini untuk sumber daya bersama atau ketika pengguna seharusnya tidak memerlukan akses individual.

Uji alat Anda

Dengan orkestrasi generatif, orkestrator memilih alat Anda saat dianggap relevan dengan kueri pengguna.

Atau, Anda dapat memanggil alat yang ada dari dalam topik.

Mengaktifkan atau menonaktifkan alat di agen Anda

Anda dapat mengaktifkan atau menonaktifkan alat untuk agen Anda dari halaman konfigurasi alat. Mematikan alat akan memblokir agen agar tidak menggunakan alat, tetapi alat ini masih terhubung ke agen dan dapat dihidupkan kembali nanti. Saat Anda menambahkan alat ke agen, alat tersebut diaktifkan secara default.

Untuk menonaktifkan alat di agen:

  1. Buka agen Anda dan pilih halaman Alat untuk agen Anda.
  2. Pilih alat untuk membuka halaman konfigurasi alat.
  3. Di bagian atas halaman konfigurasi, nonaktifkan alat menggunakan tombol Diaktifkan.
  4. Pilih Simpan untuk menerapkan perubahan.

Alat ini masih muncul di daftar alat agen, tetapi tidak lagi diaktifkan.

Menghapus alat dari agen Anda

Mematikan alat akan memblokir alat agar tidak digunakan, tetapi juga memberi Anda fleksibilitas untuk mengaktifkannya kembali nanti. Anda juga dapat menghapus alat secara lebih permanen dari agen Anda. Untuk menghapus alat dari agen Anda:

  1. Buka agen Anda dan pilih halaman Alat untuk agen Anda.
  2. Temukan alat pada daftar alat dan arahkan mouse ke atas nama alat. Pilih tiga titik (...).
  3. Pilih Hapus. Jendela konfirmasi ditampilkan.
  4. Pilih Hapus untuk menghapus alat.

Alat ini menghilang dari daftar alat agen.

Nota

Anda hanya dapat menghapus alat dari halaman alat agen. Anda tidak dapat menghapus alat dari halaman utama Alat Copilot Studio.

Batasan alat di agen

  • Saat menggunakan orkestrasi generatif, orkestrator dapat menangani maksimal 128 alat per agen. Namun, untuk performa dan hasil terbaik, sebaiknya batasi jumlah alat di agen Anda tidak lebih dari 25-30.
  • Saat menggunakan orkestrasi multi-agen dengan agen turunan, agen turunan memiliki orkestrasi mereka sendiri dan dapat mengelola kumpulan mereka sendiri hingga 128 alat.

Konten terkait

  • Last updated on