Mulai Cepat: Menyiapkan sumber daya Microsoft Foundry

Dalam panduan cepat ini, Anda membuat proyek Microsoft Foundry dan meluncurkan 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.

Tips

Panduan ini menunjukkan kepada Anda cara membuat sumber daya yang diperlukan untuk membangun agen dengan pengaturan dasar. Untuk skenario lebih lanjut yang menggunakan sumber daya Anda sendiri, lihat Menyiapkan lingkungan Anda untuk pengembangan agen.

Prasyarat

• Akun Azure dengan langganan aktif. Jika Anda tidak memilikinya, buat akun Azure free, 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 Akun Foundry atau Pemilik Foundry pada grup langganan atau sumber daya. Untuk informasi lebih lanjut tentang izin, lihat kontrol akses berbasis peran Microsoft Foundry.

    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.

• Jika Anda membuat proyek untuk tim:
  • Akses ke peran yang memungkinkan Anda menyelesaikan tugas peran, seperti Pemilik. Untuk informasi lebih lanjut tentang izin, lihat kontrol akses berbasis peran 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.

Tips

Buat proyek Anda di wilayah US Barat 3 jika Anda ingin mencoba model instan (pratinjau).

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 aset 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. Buat 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: Azure Cognitive Services account

Portal Foundry

1. Masuk ke Microsoft Foundry. Pastikan tombol New Foundry aktif. Langkah-langkah ini mengacu pada Foundry (baru).

   

2. Buat proyek.

   • Jika ini adalah penggunaan Foundry pertama Anda, Anda akan diminta untuk membuat atau mencari proyek untuk melanjutkan. Pilih Buat proyek baru di menu dropdown.
   • Jika Anda sudah memiliki proyek yang dimuat, pilih namanya di sudut kiri atas, lalu pilih Buat proyek baru.

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

4. 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.

5. Pilih Buat proyek.

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

Menerapkan model

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

Tips

Anda dapat melewati langkah ini sama sekali jika Anda ingin mencoba model instan (pratinjau).

Azure CLI

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-5.1-mini \
    --model-name gpt-5.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-5.1-mini

Saat deploy sudah siap, output menunjukkan "provisioningState": "Succeeded".

Referensi: penyebaran akun az cognitiveservices

Portal Foundry

1. Pilih Temukan di navigasi kanan atas, lalu Model di panel kiri.
2. Cari gpt-5.1-mini.
3. Pilih Sebarkan>Pengaturan default untuk menambahkannya ke proyek Anda.
4. Perhatikan nama penyebaran (misalnya, gpt-5.1-mini). Untuk menggunakan model, tim Anda memerlukan nama ini.

Mendapatkan detail koneksi proyek Anda

Anda memerlukan titik akhir dari proyek Anda agar dapat terhubung melalui kode. Jika Anda mengelola proyek ini untuk orang lain, kirimi mereka titik akhir ini 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 di panduan cepat dan tutorial lainnya.

Untuk administrator - berikan akses

Jika Anda mengelola tim, tetapkan peran Pengguna Foundry kepada 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

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.

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 Foundry ke anggota tim:

   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.

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

Note

Karena peran RBAC Foundry baru-baru ini diganti namanya, gunakan ID definisi peran (GUID) alih-alih nama peran dalam kode Anda untuk menghindari masalah selama peluncuran nama ulang:

• Pengguna Foundry: 53ca6127-db72-4b80-b1b0-d745d6d5456d
• Pemilik Foundry: c883944f-8b7b-4483-af10-35834be79c4a
• Pemilik Akun Foundry: e47c6f54-e4a2-4754-9501-8e0985b135e1
• Manajer Proyek Foundry: eadc314b-1a2d-4efa-be10-5d325db5065e

Untuk menambahkan grup keamanan, bukan pengguna individual:

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

1. Verifikasi penetapan peran:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

Referensi: penugasan peran az

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.

Tips

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 dan memilih proyek dari daftar proyek.

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.

Untuk mengonfirmasi model yang disebarkan tersedia, minta anggota tim untuk memilih Bangun di navigasi kanan atas, lalu Model di panel kiri.

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 Azure, temukan dan pilih grup sumber daya Anda. Pilih Hapus dan konfirmasi untuk menghapus grup sumber daya dan semua sumber daya terkait.

Langkah berikutnya

panduan memulai Microsoft Foundry