Menggunakan dan memigrasikan alur kerja agen deklaratif dengan Microsoft Foundry Toolkit

Gunakan Microsoft Foundry Toolkit untuk Visual Studio Code bekerja dengan alur kerja deklaratif yang ada dan menyiapkannya untuk migrasi. Anda dapat menguji alur kerja yang disimpan, mengedit YAML yang diekspor, dan menggunakan GitHub Copilot untuk membantu mengonversi definisi ke kode Kerangka Kerja Agen Microsoft.

Penting

Alur kerja deklaratif di Microsoft Foundry masih dalam pratinjau dan akan dihentikan pada 1 Desember 2026. Gunakan Microsoft Agent Framework untuk pengembangan alur kerja baru. Penghentian ini tidak memengaruhi orkestrasi berbasis kode di agen terhosting. Lihat panduan migrasi alur kerja untuk jalur migrasi yang didukung.

Prasyarat

Menampilkan alur kerja agen deklaratif

Temukan alur kerja dalam daftar agen terkonsolidasi proyek Anda.

  1. Dalam tampilan Foundry Toolkit , di bawah Sumber Daya Saya, konfirmasikan proyek Foundry yang dipilih.
  2. Pilih Agen, lalu pilih tab Alur Kerja .
  3. Pilih nama alur kerja untuk membuka taman bermainnya.
  4. Gunakan pemilih versi untuk memilih versi tersimpan yang ingin Anda periksa.

Taman bermain memperlihatkan grafik alur kerja dan area percakapan. Grafik bersifat baca-saja. Gunakan YAML yang diekspor atau portal Foundry untuk mengedit definisi.

Mengedit definisi alur kerja yang sudah ada

Ekspor definisi sebelum Anda mengedit atau memigrasikannya. Simpan salinan YAML asli sehingga Anda dapat membandingkannya dengan perubahan Anda.

  1. Buka alur kerja yang ada di portal Foundry.
  2. Di perancang alur kerja, beralihlah ke tampilan YAML dan salin atau ekspor definisi. Untuk detailnya, lihat Mengekspor definisi alur kerja Anda.
  3. Simpan definisi di ruang kerja lokal Anda dengan nama yang berakhiran .workflow.yaml, seperti support.workflow.yaml.
  4. Buka file di Visual Studio Code dan edit YAML.
  5. Simpan file tersebut. Perubahan file lokal tidak memperbarui alur kerja di Foundry.

Simpan versi baru alur kerja yang sudah ada

Sebelum pensiun, Anda dapat menyebarkan definisi yang diedit ke alur kerja yang sama. Konfirmasikan nama proyek dan alur kerja untuk menghindari pembuatan sumber daya yang berbeda.

  1. Konfirmasikan bahwa proyek alur kerja asli dipilih di Foundry Toolkit.
  2. .workflow.yaml Dengan file terbuka, pilih Sebarkan di toolbar editor.
  3. Di Masukkan nama alur kerja, masukkan nama alur kerja yang sudah ada.
  4. Tunggu pemberitahuan keberhasilan penyebaran.
  5. Buka kembali alur kerja dariAlur KerjaAgen> dan pilih versi baru.

Menyebarkan dengan nama alur kerja yang sudah ada akan membuat versi baru. Nama yang berbeda membuat alur kerja terpisah; jangan gunakan jalur ini untuk memulai pengembangan alur kerja baru.

Menguji alur kerja di taman bermain

Uji versi tersimpan yang Anda rencanakan untuk dipertahankan atau dimigrasikan. Gunakan permintaan yang sama nanti untuk membandingkan implementasi yang dimigrasikan.

  1. Buka taman bermain alur kerja dan pilih versi yang diperlukan.
  2. Pada tab Playground , pilih Baru untuk memulai sesi playground baru.
  3. Masukkan permintaan yang menguji alur kerja, lalu kirimkan.
  4. Tinjau respons dan grafik eksekusi. Pastikan agen, cabang, dan langkah yang diharapkan berjalan.
  5. Ulangi dengan permintaan yang mencakup berbagai cabang alur, masukan yang tidak lengkap, dan setiap langkah persetujuan dalam alur kerja Anda.

Playground menjalankan alur kerja Foundry yang tersimpan. Ini tidak menjalankan perubahan yang tidak disimpan dalam file YAML lokal Anda atau kode yang Copilot hasilkan.

Mengonversi alur kerja YAML ke kode Kerangka Kerja Agen

Gunakan aksi pembuatan kode di playground untuk meminta GitHub Copilot mengonversi definisi alur kerja yang dipilih. Kode yang dihasilkan adalah titik awal yang harus Anda tinjau dan uji.

  1. Di taman bermain alur kerja, pilih versi yang akan dimigrasikan.
  2. Pilih Buat Kode.
  3. Pilih Python atau C#.
  4. Tinjau permintaan konversi di Copilot Chat dan ikuti perintahnya untuk menghasilkan kode.
  5. Tinjau proyek, dependensi, koneksi model, alat, dan konfigurasi autentikasi yang dihasilkan.
  6. Bandingkan orkestrasinya dengan YAML yang diekspor. Periksa pencabangan, variabel, panggilan agen, dan langkah-langkah persetujuan manusia.
  7. Jalankan kode secara lokal dan uji dengan permintaan yang Anda gunakan untuk alur kerja asli. Gunakan Agent Inspector untuk memeriksa eksekusi.
  8. Saat kode berfungsi sesuai kebutuhan, ikuti Membuat agen terhosting untuk menyiapkan proyek agen terhosting yang didukung, menyebarkannya, dan menguji versi yang telah disebarkan.

Konversi kode tidak menyebarkan agen yang dihosting atau menjamin perilaku yang setara. Pertahankan definisi asli hingga Anda menyelesaikan migrasi dan mengonfirmasi bahwa aplikasi dependen menggunakan penggantian.

Gunakan Agent Inspector untuk memeriksa alur kerja Agent Framework lokal yang didukung. Untuk mengumpulkan span dari kode tersebut atau menyelidiki agen hosted yang telah di-deploy, lihat Tracing di Foundry Toolkit. Langkah-langkah inspeksi lokal ini tidak menggantikan playground remote untuk alur kerja deklaratif.

Untuk pilihan migrasi lainnya, termasuk YAML deklaratif Agent Framework, Azure Logic Apps, dan koneksi A2A langsung, lihat panduan migrasi alur kerja.

Konten terkait

Gunakan panduan ini untuk memilih dan menyelesaikan migrasi Anda:

  • Terakhir diperbarui pada