Membuat proyek untuk Microsoft Foundry

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.

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

Prasyarat

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

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

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

  Portal Foundry

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

  Python SDK

  • Menyiapkan lingkungan pengembangan Anda

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

  • Validasi cepat: Sebelum membuat proyek, verifikasi SDK dan autentikasi Anda berfungsi 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.")
    

  • Selesaikan langkah-langkah ini untuk memulai skrip Python Anda:

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

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

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

    4. (Opsional) Jika Anda memiliki beberapa akun, tambahkan ID penyewa dari 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

Portal Foundry

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

Untuk membuat proyek Foundry, ikuti langkah-langkah berikut:

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

   

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

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

4. Beri nama proyek Anda dan pilih Buat proyek. 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 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 dalam langganan Azure terbatas di mana pengembang memerlukan kemampuan eksplorasi mandiri dalam pengaturan lingkungan yang telah dikonfigurasi sebelumnya.

Proyek Foundry yang menjadi bagian dari sumber daya anak Azure mungkin memiliki kontrol aksesnya sendiri, namun tetap berbagi pengaturan umum seperti keamanan jaringan, implementasi, 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

  Portal Foundry (baru) hanya menampilkan proyek default untuk setiap sumber daya Foundry. Anda tidak dapat membuat beberapa proyek, atau melihat proyek nondefault apa pun di portal Foundry (baru).

  Python SDK

  Meskipun kode ini dapat menambahkan proyek tambahan ke sumber daya, Anda tidak akan dapat melihatnya di portal Foundry (baru). Hanya proyek default untuk sumber daya yang tersedia di portal Foundry (baru).
  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

  Meskipun kode ini dapat menambahkan proyek tambahan ke sumber daya, Anda tidak akan dapat melihatnya di portal Foundry (baru). Hanya proyek default untuk sumber daya yang tersedia di portal Foundry (baru). Untuk menambahkan proyek baru ke my-foundry-resource:

   az cognitiveservices account project create \
   --name my-foundry-resource \
   --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 akan melihat titik akhir proyek dan kunci API untuk proyek tersebut. Anda tidak memerlukan kunci API jika Anda menggunakan autentikasi ID Microsoft Entra.

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 connection show perintah . Contohnya:

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

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 proyek Anda.
5. Di kanan atas, pilih ikon tempat sampah untuk menghapus proyek.

Python SDK

Kode ini menggunakan variabel dan client connection dari Prasyarat. Pertama, buat koneksi klien:

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-rg \
--project-name my-foundry-project

Referensi: az cognitiveservices account project delete.

Penting

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

Konten terkait

• Panduan Awal Microsoft Foundry
• Apa itu Foundry?