Bekerja dengan agen Foundry dan alat server MCP di Visual Studio Code (klasik)

Hanya berlaku untuk:Portal Foundry (klasik). Artikel ini tidak tersedia untuk portal Foundry baru. Pelajari selengkapnya tentang portal baru.

Catatan

Tautan dalam artikel ini mungkin membuka konten dalam dokumentasi Microsoft Foundry baru alih-alih dokumentasi Foundry (klasik) yang Anda lihat sekarang.

Dalam artikel ini, Anda menambahkan dan menggunakan alat server Model Context Protocol (MCP) dengan agen di Foundry Agent Service. Anda menggunakan Microsoft Foundry untuk ekstensi Visual Studio Code untuk mengonfigurasi dan menguji agen panggilan alat MCP.

Catatan

Artikel ini mengacu pada versi klasik API agen.

Setelah Anda membangun agen di Agent Service dengan menggunakan ekstensi Visual Studio Code (VS Code), Anda dapat menambahkan alat MCP kepadanya. Menambahkan server MCP memungkinkan agen Anda untuk:

Akses informasi terkini dari API dan layanan Anda.
Ambil konteks yang relevan untuk meningkatkan kualitas respons dari model AI Anda.

Prasyarat

Langganan Azure. Jika Anda tidak memilikinya, buat secara gratis.
Proyek Foundry dengan model yang diimplementasikan.
Visual Studio Code dengan Microsoft Foundry untuk ekstensi Visual Studio Code terinstal.
Agen yang ada dibuat melalui ekstensi Visual Studio Code. Untuk membuatnya, ikuti langkah-langkah pada Bekerja dengan Agent Service di Visual Studio Code.
URL server MCP jarak jauh untuk tersambung ke agen Anda.

Membuat agen di perancang

Untuk membuat agen, ikuti langkah-langkah dalam Membuat agen di perancang.

Menambahkan alat server MCP ke agen

Setelah membuat agen, Anda dapat menambahkan alat ke dalamnya, termasuk alat MCP. Untuk informasi selengkapnya tentang alat yang tersedia, lihat Alat untuk agen.

Anda dapat membawa beberapa server MCP jarak jauh dengan menambahkannya sebagai alat. Untuk setiap alat, Anda perlu memberikan nilai Label Server unik dalam agen yang sama dan nilai URL Server yang menunjuk ke server MCP jarak jauh.

Peringatan

Server MCP jarak jauh yang Anda gunakan dengan alat MCP dalam artikel ini bukan berasal dari Microsoft. Microsoft tidak menguji atau memverifikasi server ini. Untuk detailnya, lihat Pertimbangan untuk menggunakan layanan dan server non-Microsoft.

Untuk menambahkan alat server MCP ke agen Anda, ikuti langkah-langkah berikut:

Di perancang, di sudut kanan atas bagian TOOL , pilih tombol Tambahkan alat . Di daftar dropdown, pilih alat MCP Server .
Temukan server MCP jarak jauh yang ingin Anda sambungkan, seperti server MCP GitHub. Buat atau perbarui agen Foundry dengan alat MCP dengan menggunakan informasi berikut:
1. URL Server: URL server MCP; contohnya, https://gitmcp.io/Azure/azure-rest-api-specs.
2. Label Server: Pengidentifikasi unik server MCP ini ke agen; misalnya, fetch_rest_api_docs.
Di daftar dropdown Alat yang diizinkan , pilih alat mana yang dapat digunakan server MCP.
Setelah Anda memasukkan informasi yang diperlukan, pilih tombol Buat alat . Alat MCP muncul di bagian TOOL dari perancang agen.

Menyebarkan agen ke Foundry

Setelah Anda menambahkan alat MCP, sebarkan agen ke Foundry sehingga tersedia untuk pengujian dan penggunaan.

Di perancang, pilih tombol Buat Agen di Microsoft Foundry.
Di Visual Studio Code, refresh tampilan Sumber Daya . Agen yang disebarkan muncul di subbagian Agen Klasik.

Melihat rincian agen yang disebarkan

Setelah menyebarkan agen, Anda dapat memeriksa konfigurasinya dan berinteraksi dengannya. Pilih agen yang disebarkan dalam tampilan Sumber Daya untuk membuka panel PREFERENSI AGEN dalam mode hanya tampilan. Kamu bisa:

Pilih tombol Edit Agen untuk melihat perancang agen dan definisi .yaml agen untuk pengeditan.
Pilih tombol Tampilkan Kode untuk membuat file kode sampel yang menggunakan agen.
Pilih tombol Buka Playground untuk membuka taman bermain agen.

Mengedit agen yang telah disebarkan

Untuk mengubah konfigurasi agen Anda setelah penyebaran, ikuti langkah-langkah berikut:

Pada panel PREFERENSI AGEN , pilih tombol Edit Agen . Pembuka perancang agen dimulai dengan file .yaml milik agen.
Edit konfigurasi agen, seperti model, alat, dan instruksi.
Setelah selesai mengedit, pilih tombol Update Agent di Microsoft Foundry untuk menyimpan perubahan Anda. Konfigurasi yang diperbarui diterapkan ke Foundry.

Menguji agen dengan alat MCP di taman bermain

Gunakan platform pengujian agen untuk memverifikasi bahwa alat server MCP Anda berfungsi secara optimal dengan agen yang terinstal.

Klik kanan agen yang Anda sebarkan yang memiliki alat MCP Server , lalu pilih opsi Buka Playground . Tindakan ini memulai percakapan dengan agen Anda sehingga Anda dapat mengirim pesan.
Pada panel Remote Agent Playground , masukkan perintah seperti Beri saya contoh untuk membuat aplikasi kontainer dan mengirimkannya.
Pilih metode autentikasi untuk alat server MCP dan lanjutkan. Metode autentikasi bervariasi tergantung pada server MCP. Opsi umum termasuk kunci API, OAuth, atau tanpa autentikasi untuk server publik.
Pilih preferensi persetujuan untuk alat server MCP dan lanjutkan. Anda dapat memilih Tanyakan setiap saat untuk meninjau setiap panggilan alat, atau Selalu izinkan untuk mengizinkan agen memanggil alat MCP secara otomatis.
Jika Anda memilih Tanyakan setiap kali untuk preferensi persetujuan Anda, Anda perlu menyetujui atau menolak setiap panggilan alat sebelum agen melanjutkan.
Agen menggunakan model dan alat server MCP yang Anda konfigurasi untuk mengambil informasi. Setelah agen selesai diproses, respons muncul di taman bermain. Sumber informasi muncul di bagian anotasi agen.

Memecahkan masalah koneksi server MCP

Jika Anda mengalami masalah saat menggunakan alat server MCP dengan agen Anda, coba resolusi berikut.

Masalah	Resolusi
URL server MCP tidak dapat dijangkau	Verifikasi bahwa URL sudah benar dan server sedang berjalan. Periksa koneksi jaringan Anda dan aturan firewall apa pun yang mungkin memblokir permintaan keluar dari Visual Studio Code.
Kegagalan autentikasi	Konfirmasikan bahwa Anda memilih metode autentikasi yang benar untuk server MCP. Jika server memerlukan kunci API atau token OAuth, verifikasi bahwa kredensial valid dan tidak kedaluwarsa.
Alat tidak muncul di daftar alat yang diizinkan	Refresh daftar alat dengan menutup dan membuka kembali dialog alat MCP. Verifikasi bahwa server MCP mengekspos alatnya dengan benar melalui protokol MCP standar.
Agen mengembalikan kesalahan saat memanggil alat MCP	Periksa anotasi agen di taman bermain untuk detail kesalahan. Server MCP mungkin mengembalikan respons kesalahan. Verifikasi bahwa server sehat dan parameter panggilan alat sudah benar.

Membersihkan sumber daya

Sumber daya Azure yang Anda buat dalam artikel ini ditagihkan ke langganan Azure Anda. Jika Anda tidak mengharapkan untuk membutuhkan sumber daya ini di masa mendatang, hapus sumber daya tersebut untuk menghindari dikenakan lebih banyak biaya.

Menghapus agen Anda

Untuk menghapus agen yang tidak lagi Anda butuhkan:

Di Visual Studio Code, refresh tampilan Sumber Daya . Perluas subbagian Agen Klasik untuk menampilkan daftar agen yang disebarkan.
Klik kanan agen yang disebarkan yang ingin Anda hapus, lalu pilih Hapus.

Menghapus model Anda

Untuk menghapus model yang disebarkan yang tidak lagi Anda butuhkan:

Di Visual Studio Code, refresh tampilan Sumber Daya . Perluas subbagian Model untuk menampilkan daftar model yang disebarkan.
Klik kanan model yang disebarkan yang ingin Anda hapus, lalu pilih Hapus.

Menghapus alat tersambung Anda

Untuk menghapus sumber daya alat terhubung yang tidak lagi Anda butuhkan, hapus satu per satu di portal Azure:

Buka portal Azure.
Buka grup sumber daya yang berisi proyek Foundry Anda.
Temukan sumber daya alat tertentu yang ingin Anda hapus, dan pilih.
Pilih tombol Hapus dan konfirmasi penghapusan.