Microsoft Foundry Toolkit ile bildirim temelli ajan iş akışlarını kullanma ve taşıma

Mevcut bildirim temelli iş akışlarıyla çalışmak ve bunları geçişe hazırlamak üzere Visual Studio Code için Microsoft Foundry Toolkit'i kullanın. Kaydedilmiş bir iş akışını test edebilir, dışarı aktarılan YAML'sini düzenleyebilir ve tanımı Microsoft Agent Framework koduna dönüştürmeye yardımcı olmak için GitHub Copilot kullanabilirsiniz.

Önemli

Microsoft Foundry'deki bildirimsel iş akışları önizleme aşamasındadır ve 1 Aralık 2026'da kullanımdan kaldırılacaktır. Yeni iş akışı geliştirme için Microsoft Agent Framework kullanın. Bu kullanımdan kaldırma, barındırılan aracılarda kod tabanlı düzenlemeyi etkilemez. Desteklenen geçiş yolları için iş akışı geçiş kılavuzuna bakın.

Prerequisites

Bildirim temelli aracı iş akışını görüntüleme

projenizin birleştirilmiş aracı listesinde iş akışını bulun.

  1. Döküm Aracı Seti görünümündeki Kaynaklarım'ın altında seçili Dökümhane projesini onaylayın.
  2. Aracılar'ı ve ardından İş Akışı sekmesini seçin.
  3. Oyun alanını açmak için iş akışı adını seçin.
  4. İncelemek istediğiniz kaydedilmiş sürümü seçmek için sürüm seçiciyi kullanın.

Oyun alanında iş akışı grafiği ve bir konuşma alanı gösterilir. Grafik salt okunurdur. Tanımı düzenlemek için dışarı aktarılan YAML'yi veya Foundry portalını kullanın.

Mevcut iş akışı tanımını düzenleme

Düzenlemeden veya geçirmeden önce tanımı dışarı aktarın. Değişikliklerinizle karşılaştırabilmeniz için özgün YAML'nin bir kopyasını saklayın.

  1. Mevcut iş akışını Dökümhane portalında açın.
  2. İş akışı tasarımcısında YAML görünümüne geçin ve tanımı kopyalayın veya dışarı aktarın. Ayrıntılar için bkz. İş akışı tanımınızı dışarı aktarma.
  3. Tanımı, gibi support.workflow.yamlile biten .workflow.yamlbir adla yerel çalışma alanınıza kaydedin.
  4. dosyayı Visual Studio Code açın ve YAML'yi düzenleyin.
  5. Dosyayı kaydedin. Yerel dosya değişiklikleri Foundry'de iş akışını güncelleştirmez.

Mevcut iş akışının yeni bir sürümünü kaydetme

Kullanımdan kaldırmadan önce, düzenlenmiş bir tanımı aynı iş akışına dağıtabilirsiniz. Farklı bir kaynak oluşturmaktan kaçınmak için proje ve iş akışı adını onaylayın.

  1. Özgün iş akışının projesinin Döküm Araç Seti'nde seçili olduğunu onaylayın.
  2. Dosya açıkken .workflow.yaml düzenleyici araç çubuğunda Dağıt'ı seçin.
  3. İş akışı adını girin alanına mevcut iş akışının adını girin.
  4. Dağıtım başarı bildirimini bekleyin.
  5. Aracılar>İş Akışı'ndan iş akışını yeniden açın ve yeni sürümü seçin.

Mevcut bir iş akışı adıyla dağıtmak yeni bir sürüm oluşturur. Farklı bir ad ayrı bir iş akışı oluşturur; yeni iş akışı geliştirmeye başlamak için bu yolu kullanmayın.

Oyun alanında iş akışını test edin

Korumayı veya taşımayı planladığınız kaydedilmiş sürümü test edin. Daha sonra taşınan uygulamayı karşılaştırmak için aynı istekleri kullanın.

  1. İş akışının oyun alanını açın ve gerekli sürümü seçin.
  2. Oyun Alanı sekmesinde Yeni'yi seçerek yeni bir oyun alanı oturumu başlatın.
  3. İş akışını test eden bir istek girin ve gönderin.
  4. Yanıtı ve yürütme grafiğini gözden geçirin. Beklenen ajanların, dalların ve adımların çalıştıklarını doğrulayın.
  5. İş akışınızdaki farklı dallanmaları, eksik girdileri ve gerekli onay adımlarını tetikleyen isteklerle bunu tekrarlayın.

Oyun alanı, kaydedilmiş Foundry iş akışını çalıştırır. Yerel YAML dosyanızda veya Copilot oluşturulan kodda kaydedilmemiş değişiklikleri çalıştırmaz.

YAML iş akışını Agent Framework koduna dönüştürme

GitHub Copilot'tan seçili iş akışı tanımını dönüştürmesini istemek için çalışma alanının kod oluşturma eylemini kullanın. Oluşturulan kod, gözden geçirmeniz ve test etmeniz gereken bir başlangıç noktasıdır.

  1. İş akışı çalışma alanında taşınacak sürümü seçin.
  2. Kod Oluştur'a tıklayın.
  3. Python veya C# seçeneğini belirleyin.
  4. Copilot Chat'da dönüştürme isteğini gözden geçirin ve kodu oluşturmak için istemlerini izleyin.
  5. Oluşturulan projeyi, bağımlılıkları, model bağlantılarını, araçları ve kimlik doğrulama yapılandırmasını gözden geçirin.
  6. Orkestrasyonunu dışa aktarılan YAML ile karşılaştırın. Dallanmayı, değişkenleri, ajan çağrılarını ve insan onay adımlarını kontrol edin.
  7. Kodu yerel olarak çalıştırın ve özgün iş akışı için kullandığınız isteklerle test edin. Çalıştırmayı incelemek için Agent Inspector'ı kullanın.
  8. Kod beklendiği gibi çalıştığında, desteklenen bir barındırılan aracı projesi hazırlamak, bunu dağıtmak ve dağıtılan sürümü test etmek için Barındırılan aracıları oluşturma adımlarını izleyin.

Kod dönüştürme, barındırılan bir aracı dağıtmaz veya eşdeğer davranışı garanti etmez. Geçişi tamamlayana kadar özgün tanımı koruyun ve bağımlı uygulamaların değişikliği kullandığını onaylayın.

Agent Framework bildirim temelli YAML, Azure Logic Apps ve doğrudan A2A bağlantıları gibi diğer geçiş seçenekleri için iş akışı geçiş kılavuzuna bakın.

İlgili içerik

Geçişinizi seçmek ve tamamlamak için şu kılavuzları kullanın:

  • Last updated on