Mulai cepat: Menyiapkan sumber daya Microsoft Foundry

Dalam panduan cepat ini, Anda membuat proyek Microsoft Foundry dan menyebarkan model. Jika Anda mengelola tim, Anda juga memberikan akses ke anggota tim. Setelah menyelesaikan langkah-langkah ini, Anda atau tim Anda dapat mulai membangun aplikasi AI menggunakan model yang disebarkan.

Petunjuk / Saran

Panduan cepat ini menunjukkan kepada Anda cara membuat sumber daya teknis untuk mengembangkan agen dengan konfigurasi dasar. Untuk skenario lebih lanjut yang menggunakan sumber daya Anda sendiri, lihat Menyiapkan lingkungan Anda untuk pengembangan agen.

Prasyarat

• Sebuah akun Azure dengan langganan aktif. Jika Anda tidak memilikinya, buat akun Azure gratis, yang menyertakan langganan uji coba gratis.
• Jika Anda membuat proyek untuk diri Anda sendiri:
  • Akses ke peran yang memungkinkan Anda membuat sumber daya Foundry, seperti Pemilik AI Akun Azure atau Pemilik Azure AI pada grup langganan atau sumber daya. Untuk informasi selengkapnya tentang izin, lihat Kontrol akses berbasis peran untuk Microsoft Foundry.
• Jika Anda membuat proyek untuk tim:
  • Akses ke peran yang memungkinkan Anda menyelesaikan penugasan peran, seperti Pemilik. Untuk informasi selengkapnya tentang izin, lihat Kontrol akses berbasis peran untuk Microsoft Foundry.
  • Daftar alamat email pengguna atau ID grup keamanan Microsoft Entra untuk anggota tim yang memerlukan akses.

Pilih metode pilihan Anda dengan menggunakan tab berikut:

Azure CLI

• Instal Azure CLI versi 2.67.0 atau yang lebih baru (periksa dengan az version).

• Masuk ke Azure:

  az login
  

Portal Foundry

• Akses ke portal Microsoft Foundry.

Membuat proyek

Buat proyek Foundry untuk mengatur pekerjaan Anda. Proyek ini berisi model, agen, dan sumber daya lain yang digunakan tim Anda.

Azure CLI

1. Buat grup sumber daya atau gunakan yang sudah ada. Misalnya, buat my-foundry-rg di eastus:

   az group create --name my-foundry-rg --location eastus
   

2. Buat sumber daya Foundry. Misalnya, buat my-foundry-resource di my-foundry-rg grup sumber daya:

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku s0 \
       --location eastus \
      --allow-project-management
   

   Bendera --allow-project-management memungkinkan pembuatan proyek dalam sumber daya ini.

3. Buat subdomain kustom untuk sumber daya. Nama domain kustom harus unik secara global. Jika my-foundry-resource diambil, coba nama yang lebih unik.

   az cognitiveservices account update \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --custom-domain my-foundry-resource
   

4. Membuat proyek. Misalnya, buat my-foundry-project di my-foundry-resource:

   az cognitiveservices account project create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --location eastus
   

5. Verifikasi bahwa proyek telah dibuat:

   az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project
   

   Output menampilkan properti proyek, termasuk ID sumber dayanya.

Referensi: az layanan kognitif akun

Portal Foundry

1. Buka Microsoft Foundry.

2. Masuk dengan akun Azure Anda.

3. Pilih nama proyek di sudut kiri atas, lalu pilih Buat proyek baru.

4. Masukkan nama proyek, seperti my-foundry-project.

5. Pilih Opsi tingkat lanjut untuk mengonfigurasi grup sumber daya dan lokasi:

   • Grup sumber daya: Buat grup sumber daya baru atau pilih grup sumber daya yang sudah ada. Jika Anda membuat grup sumber daya baru, Anda dapat lebih mudah mengelola proyek dan semua sumber dayanya bersama-sama.
   • Lokasi: Pilih wilayah yang paling dekat dengan tim Anda.

6. Pilih Buat proyek.

   Tunggu hingga proyek dibuat. Saat halaman gambaran umum proyek muncul, proyek Anda siap.

Terapkan model

Sebarkan model yang dapat Anda gunakan. Contoh ini menggunakan gpt-4.1-mini, tetapi Anda dapat memilih model yang tersedia.

Azure CLI

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini \
    --model-name gpt-4.1-mini \
    --model-version "2025-04-14" \
    --model-format OpenAI \
    --sku-capacity 10 \
    --sku-name Standard

Verifikasi penyebaran berhasil:

az cognitiveservices account deployment show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini

Ketika penerapan sudah siap, output memperlihatkan "provisioningState": "Succeeded".

Referensi: penyebaran akun az cognitiveservices

Portal Foundry

1. Di proyek Anda, pilih Temukan di navigasi kanan atas.
2. Pilih Model.
3. Cari gpt-4.1-mini.
4. Pilih Sebarkan>Pengaturan default untuk menambahkannya ke proyek Anda.
5. Perhatikan nama deployment (misalnya, gpt-4.1-mini). Tim Anda memerlukan nama ini untuk menggunakan model.

Mendapatkan detail koneksi proyek Anda

Anda memerlukan titik akhir proyek Anda agar dapat terhubung dari kode. Jika Anda mengelola proyek ini untuk orang lain, kirimkan titik akhir ini kepada mereka bersama dengan nama penyebaran.

1. Masuk ke Microsoft Foundry dengan menggunakan akun Azure Anda.
2. Pilih proyek Anda.
3. Temukan titik akhir proyek Anda di layar selamat datang proyek.
4. Salin nilai titik akhir. Anda menggunakan nilai ini dalam panduan memulai cepat dan tutorial lainnya.

Untuk administrator - berikan akses

Jika Anda mengelola tim, tetapkan peran Pengguna Azure AI ke anggota tim sehingga mereka dapat menggunakan proyek dan model yang disebarkan. Peran ini menyediakan izin minimum yang diperlukan untuk membangun dan menguji aplikasi AI. Untuk peran lain yang mungkin perlu Anda tetapkan, lihat Kontrol akses berbasis peran untuk Microsoft Foundry

Azure CLI

1. Dapatkan ID sumber daya proyek:

   PROJECT_ID=$(az cognitiveservices account project show \
     --name my-foundry-resource \
     --resource-group my-foundry-rg \
     --project-name my-foundry-project \
     --query id -o tsv)
   

2. Tetapkan peran Pengguna Azure AI ke anggota tim:

   az role assignment create \
       --role "Azure AI User" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

   Untuk menambahkan grup keamanan, bukan pengguna individual:

   az role assignment create \
       --role "Azure AI User" \
       --assignee-object-id "<security-group-object-id>" \
       --assignee-principal-type Group \
       --scope $PROJECT_ID
   

3. Verifikasi penetapan peran:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "Azure AI User" \
       --output table
   

Referensi: az role assignment

Portal Foundry

1. Di portal Foundry, pilih Operasikan di navigasi kanan atas.
2. Pilih Admin di panel kiri.
3. Pilih nama proyek Anda dalam tabel.
4. Pilih Tambahkan pengguna di kanan atas.
5. Masukkan alamat email anggota tim.
6. Pilih Tambahkan.

Ulangi langkah-langkah ini untuk setiap anggota tim atau grup keamanan.

Petunjuk / Saran

Untuk menambahkan beberapa pengguna sekaligus, gunakan grup keamanan Microsoft Entra alih-alih alamat email individual.

Memverifikasi akses anggota tim

Minta anggota tim untuk memverifikasi akses mereka dengan masuk ke Microsoft Foundry, memilih proyek dari daftar proyek, dan mengonfirmasi model yang disebarkan muncul di bawahModel>.

Jika anggota tim tidak dapat mengakses proyek, verifikasi bahwa penetapan peran berhasil diselesaikan. Periksa apakah Anda menggunakan alamat email atau ID grup keamanan yang benar. Pastikan akun Azure anggota tim berada di penyewa Microsoft Entra yang sama.

Membersihkan sumber daya

Saat Anda tidak lagi menginginkan proyek ini, hapus grup sumber daya untuk menghapus semua sumber daya yang terkait dengannya.

Azure CLI

az group delete --name my-foundry-rg --yes --no-wait

Portal Foundry

Di portal Microsoft Azure, temukan dan pilih grup sumber daya Anda. Pilih Hapus dan konfirmasi untuk menghapus grup sumber daya dan semua sumber daya terkait.

Langkah selanjutnya

Mulai cepat Microsoft Foundry