Membuat proyek untuk Microsoft Foundry (klasik)

Gunakan artikel ini untuk membuat proyek Foundry dan konfirmasikan bahwa lingkungan Anda siap sebelum Anda mulai membangun agen, evaluasi, dan file.

Sedang menampilkan:Versi portal Foundry (klasik) - Beralih ke versi portal Foundry yang baru

Artikel ini menjelaskan cara membuat proyek Foundry di Microsoft Foundry. Proyek memungkinkan Anda mengatur pekerjaan—seperti agen, evaluasi, dan file—saat Anda membuat aplikasi stateful dan menjelajahi ide baru.

• Proyek Foundry dikelola di bawah sumber daya Microsoft Foundry. Ini adalah kontainer untuk manajemen akses, pengunggahan dan integrasi data, dan pemantauan. Ini memungkinkan Anda memisahkan pekerjaan Anda di antara kasus penggunaan tanpa perlu membuat sumber daya Azure tambahan.

• Jika Anda memerlukan akses ke model sumber terbuka atau PromptFlow, buat jenis proyek hub sebagai gantinya.

• Untuk informasi selengkapnya tentang berbagai jenis proyek, lihat Jenis proyek.

Jika organisasi Anda memerlukan konfigurasi Azure yang disesuaikan seperti nama alternatif, kontrol keamanan, atau tag biaya, Anda mungkin perlu menggunakan portal Azure atau opsi template untuk mematuhi persyaratan Azure Policy organisasi Anda.

Prasyarat

• Akun Azure dengan langganan aktif. Jika Anda tidak memilikinya, buat akun Azure free, yang menyertakan langganan uji coba gratis.

• Akses ke peran yang memungkinkan Anda membuat sumber daya Foundry, seperti Azure Pemilik AI Akun atau Azure Pemilik AI pada langganan atau grup sumber daya. Untuk informasi selengkapnya tentang izin, lihat Kontrol akses berbasis peran untuk Microsoft Foundry.

  Jika Anda tidak memiliki peran ini, minta administrator langganan Anda untuk membuat sumber daya Foundry lalu lewati untuk Membuat beberapa proyek pada sumber daya yang sama.

Gunakan tab berikut untuk memilih metode yang ingin Anda gunakan untuk membuat proyek Foundry:

Portal Foundry

• Tidak ada prasyarat lain yang diperlukan saat menggunakan portal.

Python SDK

• Siapkan lingkungan pengembangan Anda.

• Jalankan az login atau az login --use-device-code di lingkungan Anda sebelum menjalankan kode.

• Pasang paket: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Jika Anda berada di sel buku catatan, gunakan %pip install sebagai gantinya.

• Gunakan pip show azure-mgmt-cognitiveservices untuk memeriksa apakah versi Anda adalah 13.7 atau lebih tinggi.

• Validasi cepat: Sebelum membuat proyek, verifikasi SDK dan autentikasi Anda dengan menguji klien:

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  # Test authentication by instantiating the client
  credential = DefaultAzureCredential()
  subscription_id = "<your-subscription-id>"  # Replace with your subscription ID
  client = CognitiveServicesManagementClient(credential, subscription_id)
  print("✓ Authentication successful! Ready to create a project.")
  

• Mulai skrip Anda dengan kode berikut untuk membuat client koneksi dan variabel yang digunakan di seluruh artikel ini. Contoh ini membuat proyek di Amerika Serikat Timur:

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  subscription_id = 'your-subscription-id'
  resource_group_name = 'your-resource-group-name'
  foundry_resource_name = 'your-foundry-resource-name'
  foundry_project_name = 'your-foundry-project-name'
  location = 'eastus'
  
  client = CognitiveServicesManagementClient(
      credential=DefaultAzureCredential(), 
      subscription_id=subscription_id,
      api_version="2025-04-01-preview"
  )
  

• (Opsional) Jika Anda memiliki beberapa akun, tambahkan ID penyewa ID Microsoft Entra yang ingin Anda gunakan ke dalam DefaultAzureCredential:

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

• (Opsional) Jika Anda bekerja di wilayah Azure Government - US atau Azure yang dioperasikan oleh 21Vianet, tentukan wilayah yang ingin Anda autentikasi. Contoh ini mengautentikasi ke wilayah Azure Government - AS:

  from azure.identity import AzureAuthorityHosts
  DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
  

Azure CLI

• Instal Azure CLI.
• Atur nilai default untuk subscription.

# Set your default subscription
az account set --subscription "{subscription-name}"

Membuat proyek Foundry

Gunakan salah satu metode berikut.

Portal Foundry

Langkah-langkah ini menyediakan cara untuk membuat sumber daya Azure baru dengan pengaturan default dasar.

Untuk membuat proyek Foundry, ikuti langkah-langkah berikut:

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

   

2. Apa yang Anda lakukan selanjutnya tergantung pada di mana Anda berada:

   • Jika Anda belum berada dalam proyek, atau belum memiliki proyek apa pun: Pilih Buat baru di kanan atas untuk membuat proyek Foundry baru

     

   • Jika Anda berada dalam proyek: Pilih breadcrumb proyek, lalu pilih Buat sumber daya baru.

     

3. Pilih Sumber daya Foundry, lalu pilih Berikutnya.

4. Berikan nama untuk proyek Anda dan pilih Buat. Atau lihat bagian berikutnya untuk opsi tingkat lanjut.

Opsi tingkat lanjut

1. Anda membuat proyek Foundry di sebuah sumber daya Foundry. Portal secara otomatis membuat sumber daya ini saat Anda membuat proyek. Pilih grup Sumber Daya yang sudah ada untuk digunakan, atau biarkan default untuk membuat grup sumber daya baru.

   Petunjuk / Saran

   Terutama untuk memulai, buat grup sumber daya baru untuk proyek Anda. Grup sumber daya memudahkan untuk mengelola proyek dan semua sumber dayanya bersama-sama.

2. Pilih Lokasi atau gunakan default. Lokasi adalah wilayah tempat sumber daya proyek dihosting.

3. Pilih Buat. Anda melihat kemajuan pembuatan sumber daya. Proyek dibuat ketika proses selesai.

Python SDK

Untuk membuat proyek Foundry:

• Tambahkan kode berikut untuk membuat proyek Foundry dengan menggunakan variabel dan client koneksi dari bagian prasyarat.

  # Create resource
  resource = client.accounts.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      account={
          "location": location,
          "kind": "AIServices",
          "sku": {"name": "S0",},
          "identity": {"type": "SystemAssigned"},
          "properties": {
              "allowProjectManagement": True,
              "customSubDomainName": foundry_resource_name
          }
      }
  )
  
  # Wait for the resource creation to complete
  resource_result = resource.result()
  
  # Create default project
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=foundry_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Referensi: CognitiveServicesManagementClient.

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

Membuat beberapa proyek pada sumber daya yang sama

Buat beberapa proyek Foundry pada sumber daya yang ada Foundry untuk memungkinkan kolaborasi tim dan akses sumber daya bersama termasuk keamanan, penyebaran, dan alat yang terhubung. Penyiapan ini sangat ideal dengan langganan Azure terbatas di mana pengembang membutuhkan kemampuan eksplorasi mandiri dalam penyiapan lingkungan yang telah dikonfigurasi sebelumnya.

Proyek foundry, yang termasuk sebagai sumber daya turunan Azure, dapat diberikan kontrol akses tersendiri, namun tetap berbagi pengaturan umum seperti keamanan jaringan, penggelaran, dan integrasi alat Azure dari sumber daya induk mereka.

Meskipun belum semua fitur Foundry mendukung pengorganisasian pekerjaan dalam proyek saat ini, proyek "default" pertama dari sumber daya Anda memiliki kapabilitas lebih kuat. Anda dapat mengidentifikasinya dengan tag "default" dalam pengalaman UX dan properti sumber daya "is_default" saat menggunakan opsi kode.

Fitur	Proyek bawaan	Proyek lain
Inferensi model	✅	✅
Taman Bermain	✅	✅
Agents	✅	✅
Evaluations	✅	✅
Memetakan	✅	✅
Kumpulan Data	✅	✅
Indeks	✅	✅
SDK dan API Foundry	✅	✅
Pemahaman terhadap konten	✅	✅
OpenAI SDK dan API	✅	Respons, File, Percakapan
OpenAI Batch, Penyetelan, Penyelesaian yang Disimpan	✅	-
Penyempurnaan bahasa	✅	✅
Penyempurnaan ucapan	✅	-
Connections	✅	✅

• Untuk menambahkan proyek ke sumber daya Foundry:

  Portal Foundry

  Petunjuk / Saran

  Karena Anda bisa mengkustomisasi panel kiri di portal Microsoft Foundry, Anda mungkin melihat item yang berbeda dari yang diperlihatkan dalam langkah-langkah ini. Jika Anda tidak melihat apa yang Anda cari, pilih ... Lainnya di bagian bawah panel kiri.

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

     

  2. Pilih proyek Foundry atau sumber daya terkait.

  3. Di panel kiri, pilih Pusat manajemen.

  4. Di bagian sumber daya, pilih Gambaran Umum.

  5. Pilih Proyek baru dan berikan nama.

     

  Python SDK

  Tambahkan kode ini ke skrip Anda untuk membuat proyek baru di sumber daya yang sudah ada:

  # Create additional project
  new_project_name = 'your-new-project-name'
  
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=new_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Azure CLI

  Untuk menambahkan proyek baru ke my-foundry-resource:

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

• Jika Anda menghapus proyek default sumber daya Foundry, proyek berikutnya yang dibuat akan menjadi proyek default.

Menampilkan pengaturan proyek

Portal Foundry

Pada halaman Proyek beranda , Anda menemukan informasi tentang proyek.

• Nama: Nama proyek muncul di sudut kiri atas.
• Langganan: Langganan yang menampung sumber daya yang menampung proyek.
• Grup sumber daya: Grup sumber daya yang menjadi tempat sumber daya yang digunakan untuk proyek.

Python SDK

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

Referensi: CognitiveServicesManagementClient.

Azure CLI

Untuk melihat pengaturan proyek, gunakan az cognitiveservices account project show perintah . Contohnya:

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

Menghapus proyek

Portal Foundry

1. Masuk ke Microsoft Foundry. Pastikan tombol New Foundry nonaktif. Langkah-langkah ini mengacu pada Foundry (klasik).
2. Buka proyek Anda.
3. Pilih Pusat Manajemen.
4. Di bawah Sumber Daya, pilih Gambaran Umum.
5. Pilih proyek apa pun yang tidak ingin Anda simpan lagi.
6. Pilih Hapus proyek.

Untuk menghapus sumber daya Foundry dan semua proyeknya:

1. Di pusat Manajemen, pilih nama sumber daya dari bagian Gambaran Umum untuk masuk ke portal Azure.
2. Di portal Azure, pilih Delete untuk menghapus sumber daya dan semua proyek terkait.

Python SDK

Kode ini menggunakan variabel dan konektivitas client berdasarkan prasyarat. Untuk menghapus satu proyek:

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Referensi: CognitiveServicesManagementClient.

Hapus sumber daya Foundry dan semua proyeknya:

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

Referensi: CognitiveServicesManagementClient.

Azure CLI

Jalankan perintah berikut:

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

Referensi: az cognitiveservices account project delete.

Penting

Gunakan dengan hati-hati. Anda tidak dapat memulihkan proyek setelah dihapus.

Membuat koneksi pertama Anda

Konten terkait

• Panduan Awal Microsoft Foundry
• Apa itu Foundry?
• Membuat sumber daya menggunakan templat Bicep