Menyebarkan ke Microsoft Foundry atau Azure Machine Learning Studio endpoint online

Azure Developer CLI (azd) memungkinkan Anda menyebarkan ke titik akhir online Studio Azure Machine Learning atau Microsoft Foundry. azd mendukung fitur-fitur berikut, yang dijelaskan di bagian depan:

Prasyarat

Untuk bekerja dengan Microsoft Foundry atau titik akhir online Studio Azure Machine Learning, Anda perlu:

Templat Foundry Starter dapat membantu membuat semua infrastruktur yang diperlukan untuk memulai dengan endpoint Foundry.

Mengonfigurasi titik akhir online

Konfigurasikan dukungan untuk titik akhir online di bagian servicesazure.yaml file:

  • Atur nilai ke hostai.endpoint.
  • Bagian config untuk ai.endpoint mendukung konfigurasi berikut:
    • workspace: Nama ruang kerja Microsoft Foundry. azd Mendukung substitusi dan sintaks variabel lingkungan.
      • Jika tidak ditentukan, azd cari variabel lingkungan dengan nama AZUREAI_PROJECT_NAME.
    • lingkungan: Konfigurasi kustom opsional untuk lingkungan ML. azd membuat versi lingkungan baru dari definisi file YAML yang dirujuk.
    • flow: Konfigurasi kustom opsional untuk alur. azd membuat alur prompt baru dari jalur berkas yang ditentukan.
    • model: Konfigurasi kustom opsional untuk model ML. azd membuat versi model baru dari definisi file YAML yang dirujuk.
    • penyebaran: Konfigurasi yang diperlukan untuk penyebaran titik akhir online. azd membuat penyebaran baru secara online ke titik akhir terkait berdasarkan definisi file YAML yang dirujuk.

Pertimbangkan contoh file berikut azure.yaml yang mengonfigurasi fitur-fitur ini:

name: contoso-chat
metadata:
  template: contoso-chat@0.0.1-beta
services:
  chat:
    # Referenced new ai.endpoint host type
    host: ai.endpoint
    # New config flow for AI project configuration
    config:
      # The name of the Foundry workspace
      workspace: ${AZUREAI_PROJECT_NAME}
      # Optional: Path to custom ML environment manifest
      environment:
        path: deployment/docker/environment.yml
      # Optional: Path to your prompt flow folder that contains the flow manifest
      flow:
        path: ./contoso-chat
      # Optional: Path to custom model manifest
      model:
        path: deployment/chat-model.yaml
        overrides:
          "properties.azureml.promptflow.source_flow_id": ${AZUREAI_FLOW_NAME}
      # Required: Path to deployment manifest
      deployment:
        path: deployment/chat-deployment.yaml
        environment:
          PRT_CONFIG_OVERRIDE: deployment.subscription_id=${AZURE_SUBSCRIPTION_ID},deployment.resource_group=${AZURE_RESOURCE_GROUP},deployment.workspace_name=${AZUREAI_PROJECT_NAME},deployment.endpoint_name=${AZUREAI_ENDPOINT_NAME},deployment.deployment_name=${AZUREAI_DEPLOYMENT_NAME}

Bagian config.deployment ini diperlukan dan melakukan penyebaran online baru ke endpoint online terkait dari definisi file YAML yang dirujuk. Fungsionalitas ini menangani hal berikut:

  • Lingkungan dan model terkait dirujuk saat tersedia.
  • azd menunggu penyebaran memasuki status penyediaan terminal.
  • Pada penyebaran yang berhasil, semua lalu lintas digeser ke versi penyebaran baru.
  • Semua penyebaran sebelumnya dihapus untuk membebaskan komputasi untuk penyebaran di masa mendatang.

Jelajahi opsi konfigurasi

Setiap fitur yang didukung untuk titik akhir online AI/ML mendukung kustomisasi untuk skenario spesifik Anda menggunakan opsi yang dijelaskan di bagian berikut.

Flow

Bagian flow konfigurasi bersifat opsional dan mendukung nilai berikut:

  • nama: Nama alur. Menggunakan <service-name>-flow-<timestamp> jika tidak ditentukan.

  • jalur: Jalur relatif ke folder yang berisi flow manifest.

  • penyesuaian: Semua penyesuaian kustom yang diterapkan pada alur.

    Nota

    Setiap panggilan untuk azd deploy membuat alur bertanda waktu baru.

Lingkungan

Bagian environment konfigurasi bersifat opsional dan mendukung nilai berikut:

  • nama: Nama lingkungan kustom. Menggunakan <service-name>-environment jika tidak ditentukan.

  • jalur: Jalur relatif ke manifes yaml lingkungan kustom.

  • penggantian: Setiap penggantian kustom untuk diterapkan ke lingkungan.

    Nota

    Setiap panggilan untuk azd deploy membuat versi lingkungan baru.

Model

Bagian model konfigurasi bersifat opsional dan mendukung nilai berikut:

  • nama: Nama model kustom. Menggunakan <service-name>-model jika tidak ditentukan.

  • jalur: Jalur relatif ke manifes YAML model kustom.

  • penggantian: Setiap penggantian kustom yang diterapkan pada model.

    Nota

    Setiap panggilan untuk azd deploy membuat versi model baru.

Penyebaran

Bagian deployment konfigurasi diperlukan dan mendukung nilai berikut:

  • nama: Nama dari penyebaran kustom. Menggunakan <service-name>-deployment jika tidak ditentukan.

  • jalur: Jalur relatif ke manifes yaml penyebaran kustom.

  • environment: Peta pasangan nilai kunci untuk mengatur variabel lingkungan untuk penyebaran. Mendukung substitusi variabel lingkungan dari variabel lingkungan OS/AZD menggunakan ${VAR_NAME} sintaksis.

  • penggantian: Setiap penggantian kustom untuk diterapkan ke penyebaran.

    Nota

    Hanya mendukung penyebaran online terkelola.

AgentSchema dan agent.yaml

AgentSchema adalah spesifikasi terbuka untuk menentukan agen AI dalam format YAML yang mengutamakan kode. File agent.yaml menjelaskan konfigurasi agen, termasuk model, instruksi, alat, dan koneksinya. AgentSchema berfungsi sebagai format pertukaran terpadu antara Microsoft Copilot Studio, Microsoft Foundry, dan platform lainnya.

AgentSchema mendukung dua format utama:

  • AgentDefinition — Spesifikasi lengkap dan konkret dari agen yang dapat dijalankan secara langsung. Gunakan format ini untuk agen berfungsi tunggal di mana semua nilai konfigurasi diketahui dan tetap.
  • AgentManifest — Templat berparameter untuk membuat agen secara dinamis. Gunakan format ini untuk pola agen yang dapat digunakan kembali di mana nilai seperti nama model, koneksi, atau instruksi dikonfigurasi saat runtime menggunakan {{parameter}} sintaksis.

Contoh agent.yaml

Contoh berikut menunjukkan definisi yang dihosting agent.yaml yang dapat azd sebarkan ke Microsoft Foundry. Anotasi skema di bagian atas memberi tahu editor yang mendukung YAML agar memvalidasi berdasarkan AgentSchema yang diterbitkan:

# yaml-language-server: $schema=https://raw.githubusercontent.com/microsoft/AgentSchema/refs/heads/main/schemas/v1.0/ContainerAgent.yaml

kind: hosted
name: customer-support
description: Handles customer inquiries and support requests
protocols:
  - protocol: responses
    version: v1
code_configuration:
  runtime: python_3_14
  entry_point: main.py

Contoh ini menggunakan kind: hosted dengan blok code_configuration, yang memberi tahu azd agar mengemas kode sumber Anda sebagai ZIP dan membiarkan Foundry mengelola runtime. Untuk mendeploy image kontainer bawaan sebagai gantinya, ganti code_configuration dengan field image yang mengarah ke image di Azure Container Registry.

Menggunakan agent.yaml dengan azd

Skema azure.yaml mendukung jenis host azure.ai.agent untuk menyebarkan agen ke Microsoft Foundry. Saat Anda mengatur host ke azure.ai.agent, azd membaca file agent.yaml di direktori layanan Anda dan menggunakan field kind-nya untuk menentukan cara mendeploy agen. Untuk informasi selengkapnya, lihat referensi skema azure.yaml.

Nilai kind yang didukung

Bidang kind di bagian agent.yaml atas memilih bentuk penyebaran. azd memvalidasi bidang ini terhadap nilai dalam tabel berikut dan menolak nilai lain pada waktu penyebaran.

kind Apa yang diterapkan azd Kapan digunakan
hosted Agen yang di-host oleh Foundry. Sub-mode penyebaran tergantung pada bidang yang Anda sertakan dalam file: tambahkan code_configuration untuk penyebaran kode (unggahan ZIP, runtime yang dikelola Foundry), atau tambahkan image untuk penyebaran kontainer (gambar bawaan Anda dari Azure Container Registry). Sebagian besar agen dibuat oleh azd ai agent init. Gunakan penyebaran kode saat Anda ingin Foundry mengelola runtime; gunakan penyebaran kontainer saat Anda memerlukan kontrol penuh atas gambar.

Nota

AgentSchema adalah spesifikasi yang lebih luas dibandingkan dengan yang saat ini diterapkan oleh azd. Jika Anda melihat nilai lain kind dalam referensi AgentSchema (misalnya, definisi agen prompt-only), format tersebut tidak didukung oleh azd dan tidak diterima oleh azd deploy.

Untuk informasi selengkapnya tentang AgentSchema, lihat sumber daya berikut ini:

Konten terkait

Minta bantuan

Untuk informasi tentang cara mengajukan bug, meminta bantuan, atau mengusulkan fitur baru untuk Azure Developer CLI, silakan kunjungi halaman troubleshooting dan dukungan.

  • Terakhir diperbarui pada