Membuat proyek untuk Microsoft Foundry

Nota

Artikel ini mengacu pada portal Microsoft Foundry (klasik).

🔄 Beralih ke dokumentasi Microsoft Foundry (baru) jika Anda menggunakan portal 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 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.

  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

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

    5. (Opsional) Jika Anda bekerja di wilayah Azure Government - AS 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

Portal Foundry

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

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 tidak memiliki proyek yang sudah ada: Ikuti langkah-langkah di Mulai Cepat: Mulai menggunakan Microsoft Foundry untuk membuat proyek pertama Anda.

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

     

   • Jika Anda tidak berada dalam proyek: Pilih Buat baru di kanan atas untuk membuat proyek Foundry 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 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	✅	✅
Agen	✅	✅
Evaluasi	✅	✅
Memetakan	✅	✅
Kumpulan Data	✅	✅
Indexes	✅	✅
SDK dan API Foundry	✅	✅
Pemahaman terhadap konten	✅	✅
OpenAI SDK dan API	✅	Respons, File, Percakapan
OpenAI Batch, Penyetelan, Penyelesaian yang Disimpan	✅	-
Penyempurnaan bahasa	✅	✅
Penyempurnaan ucapan	✅	-
Koneksi	✅	✅

• 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 \
   --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 menjadi host bagi hub yang menampung proyek.
• Grup sumber daya: Grup sumber daya yang menampung hub yang menampung proyek tersebut.

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 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 Microsoft Azure.
2. Di portal Microsoft Azure, pilih Hapus untuk menghapus sumber daya dan semua proyek terkait.

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?