Membuat hub menggunakan Azure Pembelajaran Mesin SDK dan CLI

Nota

Dokumen ini mengacu pada portal Microsoft Foundry (klasik ).

🔍 Lihat dokumentasi Microsoft Foundry (baru) untuk mempelajari tentang portal baru.

Penting

Item-item yang ditandai (pratinjau) dalam artikel ini saat ini sedang berada dalam pratinjau publik. Pratinjau ini disediakan tanpa kesepakatan tingkat layanan, dan kami tidak merekomendasikannya untuk penggunaan dalam lingkungan produksi. Fitur tertentu mungkin tidak didukung atau mungkin memiliki kemampuan terbatas. Untuk informasi lebih lanjut, lihat Supplemental Terms of Use for Microsoft Azure Previews.

Dalam artikel ini, Anda mempelajari cara membuat sumber daya Microsoft Foundry berikut menggunakan Azure Machine Learning SDK dan Azure CLI (dengan ekstensi pembelajaran mesin):

• Pusat Foundry
• Koneksi dengan Microsoft Foundry

Nota

Hub hanya digunakan untuk proyek berbasis hub. Proyek Foundry tidak menggunakan hub. Untuk informasi selengkapnya, lihat Jenis proyek.

Prasyarat

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

Atur lingkungan Anda

Gunakan tab berikut untuk memilih apakah Anda menggunakan Python SDK atau Azure CLI:

Python SDK

1. Instal paket. (Jika dalam sel buku catatan, gunakan %pip install sebagai gantinya.)

   pip install azure-ai-ml
   pip install azure-identity
   

2. Berikan detail langganan Anda:

   # Enter details of your subscription
   subscription_id = "<SUBSCRIPTION_ID>"
   resource_group = "<RESOURCE_GROUP>"

3. Dapatkan kendali atas langganan. Semua kode Python dalam artikel ini menggunakan ml_client:

   # get a handle to the subscription
   
   from azure.ai.ml import MLClient
   from azure.identity import DefaultAzureCredential
   
   ml_client = MLClient(DefaultAzureCredential(), subscription_id, resource_group)

4. (Opsional) Jika Anda memiliki beberapa akun, tambahkan ID tenant Microsoft Entra yang ingin Anda gunakan ke dalam DefaultAzureCredential. Temukan ID tenant Anda dari portal Azure di bawah Microsoft Entra ID, Identitas Eksternal.

   DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
   

5. (Opsional) Jika Anda sedang mengerjakan wilayah Azure Government - AS atau Azure China 21Vianet , tentukan wilayah tempat Anda ingin mengautentikasi. Anda dapat menentukan wilayah dengan DefaultAzureCredential. Contoh berikut mengautentikasi ke wilayah Azure Government - AS:

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

Azure CLI

1. Jika Anda tidak menginstal Azure CLI dan ekstensi pembelajaran mesin, ikuti langkah-langkah dalam artikel Menginstal dan menyiapkan ekstensi pembelajaran mesin.

2. Untuk mengautentikasi ke langganan Azure Anda dari Azure CLI, gunakan perintah berikut:

   az login
   

   Untuk informasi selengkapnya tentang mengautentikasi, lihat Metode autentikasi.

Membuat hub Foundry dan koneksi Microsoft Foundry

Gunakan contoh berikut untuk membuat hub baru. Ganti contoh nilai string dengan nilai Anda sendiri:

Python SDK

from azure.ai.ml.entities import Hub

my_hub_name = "myexamplehub"
my_location = "East US"
my_display_name = "My Example Hub"

# construct a basic hub
my_hub = Hub(name=my_hub_name, 
            location=my_location,
            display_name=my_display_name)

created_hub = ml_client.workspaces.begin_create(my_hub).result()

Azure CLI

az ml workspace create --kind hub --resource-group {my_resource_group} --name {my_hub_name}

Membuat koneksi Foundry

Setelah membuat sumber daya Foundry Anda sendiri atau sumber daya Azure OpenAI dalam grup sumber daya yang sama, Anda dapat menyambungkannya ke hub Anda. Anda juga dapat menyambungkan Azure AI Search dari grup sumber daya apa pun di langganan yang sama.

Python SDK

1. Koneksi Anda ml_client sekarang perlu menyertakan hub Anda:

   • Berikan detail langganan Anda. Untuk <AML_WORKSPACE_NAME>, gunakan nama hub Anda:

     # Enter details of your AML workspace
     subscription_id = "<SUBSCRIPTION_ID>"
     resource_group = "<RESOURCE_GROUP>"
     workspace = "<AML_WORKSPACE_NAME>"

   • Dapatkan handel ke hub:

     # get a handle to the workspace
     from azure.ai.ml import MLClient
     from azure.identity import DefaultAzureCredential
     
     ml_client = MLClient(
         DefaultAzureCredential(), subscription_id, resource_group, workspace
     )

2. Gunakan ml_client untuk membuat koneksi ke Foundry Tools Anda. Anda dapat menemukan titik akhir di portal Microsoft Azure di bawah Kunci manajemen > sumber daya dan titik akhir. Untuk sebuah sumber daya Foundry, gunakan endpoint Foundry Tools. Untuk Pencarian Azure AI, gunakan Url untuk titik akhir.

   from azure.ai.ml.entities import AzureAIServicesConnection
   
   # construct a Foundry connection
   my_connection_name = "myaiservivce" # any name you want
   aiservices_resource_name = <resource_name> # copy from Azure portal
   my_endpoint = "<endpoint>" # copy from Azure portal
   my_api_keys = None # leave blank for Authentication type = AAD
   my_ai_services_resource_id = f"/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.CognitiveServices/accounts/{aiservices_resource_name}"
   
   my_connection = AzureAIServicesConnection(name=my_connection_name,
                                       endpoint=my_endpoint, 
                                       api_key= my_api_keys,
                                       ai_services_resource_id=my_ai_services_resource_id)
   
   # Create the connection
   ml_client.connections.create_or_update(my_connection)
   

Azure CLI

az ml connection create --file {connection.yml} --resource-group {my_resource_group} --workspace-name {my_hub_name}

Anda dapat menggunakan kunci API atau file konfigurasi YAML tanpa kredensial. Untuk informasi selengkapnya tentang file konfigurasi YAML, lihat skema YAML koneksi Foundry Tools:

• Contoh Kunci API:

  name: myazai_ei
  type: azure_ai_services
  endpoint: <endpoint for your Foundry Tools>
  api_key: XXXXXXXXXXXXXXX
  ai_services_resource_id: <fully_qualified_resource_id>
  

• Tanpa kredensial

  name: myazai_apk
  type: azure_ai_services
  endpoint: <endpoint for your Foundry Tools>
  ai_services_resource_id: <fully_qualified_resource_id>
  

<fully_qualified_resource_id> adalah ID sumber daya sumber daya AI Services Anda. Ini dalam format /subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.CognitiveServices/accounts/{aiservices_resource_name}.

Membuat hub Foundry menggunakan sumber daya dependensi yang ada

Anda juga dapat membuat hub menggunakan sumber daya yang ada seperti Azure Storage dan Azure Key Vault. Dalam contoh berikut, ganti contoh nilai string dengan nilai Anda sendiri:

Petunjuk / Saran

Anda dapat mengambil ID sumber daya akun penyimpanan dan brankas kunci dari portal Azure dengan membuka gambaran umum sumber daya dan memilih tampilan JSON. ID sumber daya terletak di bidang id . Anda juga dapat menggunakan Azure CLI untuk mengambil ID sumber daya. Misalnya, az storage account show --name {my_storage_account_name} --query "id" dan az keyvault show --name {my_key_vault_name} --query "id".

Python SDK

from azure.ai.ml.entities import Hub

my_hub_name = "myexamplehub"
my_location = "East US"
my_display_name = "My Example Hub"
my_resource_group = "myresourcegroupname"
my_storage_account_id = "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroupname/providers/Microsoft.Storage/storageAccounts/mystorageaccountname"
my_key_vault_id = "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroupname/providers/Microsoft.KeyVault/vaults/mykeyvaultname"

# construct a basic hub
my_hub = Hub(name=my_hub_name, 
            location=my_location,
            display_name=my_display_name,
            resource_group=my_resource_group,
            storage_account_id=my_storage_account_id,
            key_vault_id=my_key_vault_id)

created_hub = ml_client.workspaces.begin_create(my_hub).result()

Azure CLI

az ml workspace create --kind hub --resource-group {my_resource_group} --name {my_hub_name} --location {hub-region} --storage-account {my_storage_account_id} --key-vault {my_key_vault_id}

Konten terkait

• Mulai membuat aplikasi obrolan menggunakan SDK alur perintah
• Bekerja dengan ekstensi Foundry for Visual Studio Code (Pratinjau)
• Mengonfigurasi jaringan terkelola