Visual Studio Code'da deklaratif aracı iş akışları ekleme

Bildirim temelli aracı iş akışları, açık programlama mantığı yerine yapılandırmaları kullanarak aracılarınız için önceden tanımlanmış eylem dizilerini tanımlar. Bu makalede, Foundry Agent iş akışlarını bir aracıya ekleyecek ve Visual Studio Code için Microsoft Foundry (VS Code) uzantısını kullanarak test edebilirsiniz.

Portalda Foundry Aracı Hizmeti'nde bir aracı oluşturduktan sonra, karmaşık otomasyon senaryoları için önceden tanımlanmış eylem dizilerinde birden çok aracıyı düzenlemeye yönelik iş akışları ekleyebilirsiniz.

Önemli

Bu makalede işaretlenen (önizleme) öğeler şu anda genel önizleme aşamasındadır. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Önkoşullar

• Konumlandırılmış en az bir ajana sahip bir Foundry projesi. Dökümhane portalında bir tane oluşturmak için bkz Hızlı Başlangıç: Bir temsilciyle sohbet.
• Foundry portalında en az bir iş akışı oluşturulmuş. İş akışları hakkında daha fazla bilgi için bkz . Foundry Agent iş akışları.
• Visual Studio Code için Microsoft Foundry uzantısı yüklü.
• GitHub Copilot aboneliği (YAML iş akışlarını Agent Framework koduna dönüştürmek için gereklidir).

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

Web için VS Code'da bildirim temelli bir aracı iş akışını görüntülemek ve düzenlemek için önce Foundry portalında iş akışına gidin:

1. Dökümhane portalında iş akışını içeren projenizi açın.
2. Sol taraftaki menüden İş Akışları sekmesini seçin.
3. Açmak istediğiniz iş akışını seçin.

Ardından, iş akışını Web için VS Code'da açmak için aşağıdaki seçeneklerden birini belirleyin.

WEB için VS Code'da YAML iş akışını açma

1. Oluştur sekmesini ve ardından sağ taraftaki YAML düğmesini seçin.
2. Web için VS Code'da Aç düğmesini seçin. İş akışı YAML dosyası, sol tarafta YAML tanımı ve sağda görsel iş akışı grafı ile Web düzenleyicisi için VS Code'da açılır.
3. İş akışını değiştirmek için YAML'yi gerektiği gibi düzenleyin. Değişiklikler görsel düzenleyicisine yansıtılır.
4. İşiniz bittiğinde, değişikliklerinizi Foundry'ye geri kaydetmek için sağ üst köşedeki üç nokta menüsünden (...) Dağıt'ı seçin.

Foundry portalından iş akışı kodunu açma

1. Oluştur sekmesini seçin ve ardından sağ taraftaki Kod düğmesini seçin.
2. Web için VS Code'da Aç düğmesini seçin. İş akışı kodu dosyası, solda kod tanımı ve sağda görsel iş akışı grafiği ile Web düzenleyicisi için VS Code'da açılır.
3. İş akışını değiştirmek için kodu gerektiği gibi düzenleyin. Değişiklikler görsel düzenleyicisine yansıtılır.
4. İşiniz bittiğinde, değişikliklerinizi Foundry'ye geri kaydetmek için sağ üst köşedeki üç nokta menüsünden (...) Dağıt'ı seçin.

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

VS Code uzantısında uzaktan aracı deneme alanını kullanarak deklaratif aracı iş akışınızı test edin.

1. VS Code uzantısının Kaynaklarım bölümünde Dökümhane projenizi bulun ve seçin.
2. Deklaratif Aracılar öğesini seçin.
3. Test etmek istediğiniz iş akışının sürümünü seçin.
4. Remote Agent Playground bölmesi açılır ve aracınızla görüşme başlatır.
5. Uzak Aracı Oyun Alanı bölmesinin altındaki giriş kutusuna bir ileti yazın ve Enter tuşuna basın.
6. Temsilcinin yanıtını gözden geçirin. Yanıtın iş akışınızın tanımlı eylemleri için beklenen davranışla eşleştiğinden emin olun.

Tavsiye

Ayrıca Araçlar alt bölümündeki Uzak Aracı Oyun Alanı'nı açabilir ve açılan listeden aracınızı seçebilirsiniz.

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

YAML tabanlı iş akışlarınızı özelleştirmek için Bunları GitHub Copilot ile Agent Framework koduna dönüştürün.

1. VS Code'da iş akışı YAML dosyasını açın.
2. YAML düzenleyicisinin sağ üst kısmındaki Kod Oluştur düğmesini seçin.
3. Kodu oluşturmak istediğiniz programlama dilini seçin (Python veya C#). GitHub Copilot, seçilen dilin kod oluşturma istemlerini içeren bir bölme açar ve YAML tanımına göre Agent Framework kodu oluşturur.
4. GitHub Copilot oluşturulan kodu yerel olarak çalıştırmak isteyip istemediğinizi sorduğunda, yerel görselleştiriciyi açmak için Evet'i seçin. Aracı çalıştırılırken her adımı görebilirsiniz.
5. Oluşturulan kodu gereksinimlerinize uyacak şekilde gözden geçirin ve değiştirin.
6. Oluşturulan kod dosyasına sağ tıklayın ve kodu Foundry projenize dağıtmak için Foundry'ye Dağıt'ı seçin.
7. Dökümhane portalında projenize gidin ve kodun Aracılar bölümünde göründüğünü doğrulayın.

İlgili içerik

• Foundry Agent iş akışları