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 kepada 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

• Akun Azure dengan langganan aktif. Jika Anda tidak memilikinya, buat akun Azure free, yang menyertakan langganan uji coba gratis.
• Jika Anda membuat project sendiri:
  • Akses ke peran yang memungkinkan Anda membuat sumber daya Foundry, seperti Azure AI Account Owner atau Azure AI Owner dalam 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 tugas peran, seperti Owner. 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.

Buat 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 project dalam sumber daya ini.

3. Buat subdomain kustom untuk sumber daya. Nama custom domain 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 project 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 daya.

Referensi: akun az cognitiveservices

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 project, 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 project dan semua sumber dayanya bersama-sama.
   • Lokasi: Pilih wilayah yang paling dekat dengan tim Anda.

5. Pilih Buat project.

   Tunggu hingga project dibuat. Saat halaman gambaran umum project muncul, project Anda sudah 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. Pilih Temukan di navigasi kanan atas, lalu Model di panel kiri.
2. Cari gpt-4.1-mini.
3. Pilih Deploy>Pengatelandefault untuk menambahkannya ke project Anda.
4. Perhatikan nama deployment (misalnya, gpt-4.1-mini). Tim Anda memerlukan nama ini untuk menggunakan model.

Dapatkan detail koneksi untuk proyek Anda

Anda memerlukan titik akhir proyek Anda untuk terhubung melalui kode. Jika Anda mengelola proyek ini untuk orang lain, kirimkan kepada mereka endpoint ini beserta nama penyebarannya.

1. Masuk ke Microsoft Foundry dengan menggunakan akun Azure Anda.
2. Pilih project 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.

Bagi administrator - berikan akses

Jika Anda mengelola tim, tetapkan peran Pengguna Azure AI 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 Role untuk Microsoft Foundry

Azure CLI

1. Peroleh ID sumber daya untuk 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 AI Azure kepada 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: penetapan peran az

Portal Foundry

1. Di portal Foundry, pilih Operasikan di navigasi kanan atas.
2. Pilih Admin di panel kiri.
3. Pilih nama project 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.

Verifikasi 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 dengan memilih Build di navigasi kanan atas, lalu Models di panel kiri.

Jika anggota tim tidak dapat mengakses proyek, lakukan verifikasi bahwa penugasan 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 project 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 selanjutnya

Microsoft Foundry Quickstart