Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Important
Item-item yang ditandai sebagai (pratinjau) dalam artikel ini saat ini tersedia untuk pratinjau publik. Pratinjau ini disediakan tanpa adanya perjanjian tingkat layanan, dan kami tidak menyarankan penggunaannya untuk beban kerja produksi. Fitur tertentu mungkin tidak didukung atau mungkin memiliki kemampuan terbatas. Untuk informasi lebih lanjut, lihat Supplemental Terms of Use for Microsoft Azure Previews.
Ekstensi Azure Developer CLI (azd) ai memungkinkan Anda membangun, menyebarkan, mengevaluasi, dan mengoperasikan agen AI di Microsoft Foundry dari terminal Anda. Dalam artikel ini, Anda menginstal ekstensi, memverifikasi penginstalan, dan mengautentikasi ke Azure.
Prasyarat
- Sebuah langganan Azure. Buat akun gratis.
- Azure Developer CLI (
azd) versi 1.25.2 atau yang lebih baru. Instal azd. - Python 3.10 atau yang lebih baru, atau .NET 8 atau yang lebih baru, tergantung pada kerangka kerja agen yang Anda rencanakan untuk digunakan.
Izin akses Azure
Anda memerlukan peran berikut pada langganan Azure Anda.
| Peranan | Kegunaan |
|---|---|
| Contributor | Menyediakan dan mengelola sumber daya Azure. |
| Pemilik Pengecoran | Diperlukan hanya jika Anda membuat proyek Foundry baru. |
Important
Peran Foundry RBAC baru-baru ini diubah namanya. Pengguna Foundry, Pemilik Foundry, Pemilik Akun Foundry, dan Manajer Proyek Foundry sebelumnya bernama Pengguna Azure AI, Pemilik Azure AI, Pemilik Akun Azure AI, dan Manajer Proyek Azure AI. Anda mungkin masih melihat nama sebelumnya di beberapa tempat saat penggantian nama diluncurkan. ID peran dan izin inti tidak berubah oleh penggantian nama.
Memahami bagaimana ekstensi dipaketkan
Namespace azd ai terdiri dari beberapa ekstensi independen azd . Masing-masing menyumbangkan satu grup perintah tingkat atas di bawah azd ai.
| ID Ekstensi | Grup perintah | Apa fungsinya |
|---|---|---|
microsoft.foundry |
paket meta | Bundel semua ekstensi Foundry untuk satu instalasi. |
azure.ai.agents |
azd ai agent |
Kirim agen dengan Foundry dari terminal Anda. |
azure.ai.connections |
azd ai connection |
Mengelola koneksi proyek Foundry. |
azure.ai.inspector |
azd ai inspector |
Antarmuka pengguna pemeriksa berbasis browser untuk agen yang dijalankan secara lokal. |
azure.ai.projects |
azd ai project |
Mengelola konteks proyek Foundry (set, unset, show). |
azure.ai.routines |
azd ai routine |
Mengelola rutinitas Foundry (timer, jadwal, pemicu peristiwa). |
azure.ai.skills |
azd ai skill |
Kelola keahlian Foundry (panduan perilaku agen yang dapat digunakan kembali). |
azure.ai.toolboxes |
azd ai toolbox |
Mengelola kotak alat Foundry (koleksi alat berversi). |
Paket microsoft.foundry ini adalah paket meta tipis yang tidak berkontribusi pada perintahnya sendiri. Menginstalnya akan memasang semua ekstensi satu per satu, yang merupakan langkah awal yang direkomendasikan. Menginstal azure.ai.agents saja juga akan ikut memasang azure.ai.inspector secara otomatis, karena ekstensi agen bergantung pada azure.ai.inspector.
Instal paket lengkap
Instal setiap ekstensi Foundry dalam satu langkah melalui paket meta:
azd ext install microsoft.foundry
Untuk memperbarui nanti:
azd ext upgrade microsoft.foundry
Menginstal atau meningkatkan ekstensi individual
Anda juga dapat mengelola setiap ekstensi sendiri:
# Just the agent surface
azd ext install azure.ai.agents
# Just the routine surface
azd ext install azure.ai.routines
# Upgrade one extension without touching the others
azd ext upgrade azure.ai.connections
Ekstensi individual diberi versi independen, sehingga Anda dapat menyematkan atau meningkatkan satu per satu.
Memverifikasi penginstalan
Mencantumkan ekstensi yang terinstal:
azd ext list
Anda akan melihat microsoft.foundry serta masing-masing ekstensi. Setiap ekstensi juga menyediakan subperintah version:
azd ai agent version
azd ai connection version
azd ai inspector version
azd ai project version
azd ai routine version
azd ai skill version
azd ai toolbox version
Authenticate
Masuk ke Azure sehingga CLI dapat menyediakan dan mengelola sumber daya atas nama Anda:
azd auth login
Perintah ini membuka jendela browser untuk autentikasi interaktif. Setelah Anda masuk, CLI menyimpan kredensial Anda secara lokal untuk perintah berikutnya.