Membuat project untuk Microsoft Foundry

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

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

Jika organisasi Anda memerlukan konfigurasi Azure yang disesuaikan seperti nama alternatif, kontrol keamanan, atau tag biaya, Anda mungkin perlu menggunakan opsi Azure portal atau 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 Pemilik Akun AI Azure atau Pemilik AI Azure pada langganan atau grup sumber daya. Untuk informasi selengkapnya tentang izin, lihat kontrol akses berbasis peran untuk Microsoft Foundry.

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

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 East US:

  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>")
  

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 foundry project, ikuti langkah-langkah berikut:

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

   

2. project yang sedang Anda kerjakan muncul di sudut kiri atas.

3. Untuk membuat project baru, pilih nama project, lalu pilih Buat project.

4. Beri nama project Anda dan pilih Buat project. Atau lihat bagian berikutnya untuk opsi tingkat lanjut.

Opsi tingkat lanjut

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

   Petunjuk / Saran

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

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

3. Pilih Buat. Anda melihat kemajuan pembuatan sumber daya. Sebuah proyek terciptakan ketika proses telah selesai.

Python SDK

Untuk membuat project 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 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

Membuat beberapa proyek pada sumber daya yang sama

Buat beberapa proyek Foundry di sumber daya Foundry yang ada untuk memungkinkan kolaborasi tim dan akses sumber daya bersama, termasuk keamanan, deployment, 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 sebagai sumber daya anak Azure mungkin diberikan kontrol akses mereka sendiri, tetapi berbagi pengaturan umum seperti keamanan jaringan, penyebaran, dan integrasi alat Azure dari sumber daya induknya.

Meskipun belum semua kemampuan Foundry mendukung pengorganisasian pekerjaan dalam proyek, proyek 'default' pertama sumber daya Anda lebih bertenaga. Anda dapat mengidentifikasinya dengan tag "default" dalam pengalaman UX dan properti sumber daya "is_default" saat menggunakan opsi kode.

Fitur	Proyek Default	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 project ke sumber daya Foundry:

  Portal Foundry

  1. Pilih Operasikan di navigasi kanan atas.
  2. Pilih Admin di panel kiri.
  3. Pilih sumber daya Induk yang ingin Anda tambahkan proyeknya.
  4. Pilih Tambahkan proyek.

  Python SDK

  Tambahkan kode ini ke skrip Anda untuk membuat project 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 project 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 project default sumber daya Foundry, project berikutnya yang dibuat akan menjadi project default.

Lihat pengaturan proyek

Portal Foundry

Pada halaman Home project, Anda akan melihat titik akhir project dan kunci API untuk project. Anda tidak memerlukan kunci API jika Anda menggunakan autentikasi Microsoft Entra ID.

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 untuk project, gunakan perintah az cognitiveservices account project show. 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 aktif. Langkah-langkah ini mengacu pada Foundry (baru).
2. Di navigasi kanan atas, pilih Operasikan.
3. Di panel kiri, pilih Admin.
4. Pilih project Anda.
5. Di kanan atas, pilih ikon tempat sampah untuk menghapus project.

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: akun az cognitiveservices project hapus.

Penting

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

Membuat koneksi pertama Anda

Konten terkait

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