Visual Studio Code'da Foundry Classic ajanlarını oluşturma ve yönetme (önizleme) (klasik)

Uyarı

Bu belge , Microsoft Foundry (klasik) portalını ifade eder.

🔍Yeni portal hakkında bilgi edinmek için Microsoft Foundry (yeni) belgelerini görüntüleyin.

Uyarı

Bu belge aracılar API'sinin klasik sürümünü ifade eder.

Foundry Agent Service , Visual Studio Code'dan (VS Code) çıkmadan aracılar oluşturmanıza, yapılandırmanıza ve dağıtmanıza olanak tanır. Bu makalede tasarımcıyı kullanarak bir aracı oluşturacak, araç ekleyeceksiniz, aracıyı oyun alanında test edin, örnek kod oluşturacak ve işiniz bittiğinde kaynakları temizleyeceksiniz.

Ö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. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Önkoşullar

• Azure aboneliği. Ücretsiz bir tane oluşturun.
• Foundry Agent Hizmetine erişim.
• Visual Studio Code yüklendi.
• VS Code için Microsoft Foundry uzantısı yüklü ve oturum açmış.
• Projenizde dağıtılan bir model .

Tasarımcıda bir ajan oluşturma

Tasarımcı, ajanınızın adını, modelini, yönergelerini ve araçlarını yapılandırmak için görsel bir arabirim sağlar.

1. Azure kaynaklarınızda oturum açın.

2. Varsayılan projenizi ayarlayın.

3. Dökümhane Uzantısı görünümünde, Kaynaklar bölümünde Klasik alt bölümünü bulun.

4. Yeni bir aracı oluşturmak için + alt bölümü yanındaki artı () simgesini seçin.

Tasarımcıda aracıyı yapılandırma

Bir kaydetme konumu seçtikten sonra aracı .yaml dosyası ve tasarımcı görünümü açılır. Aşağıdaki ayarları yapılandırın:

1. Komut istemine, aracınız için bir ad girin.

2. Açılan listeden model dağıtımınızın adını seçin. Dağıtım adı, mevcut bir modeli dağıtırken seçtiğiniz addır.

3. Uzantı, Id değerini oluşturur. Aşağıdaki alanları yapılandırın:

   • Ajanınız için bir açıklama ekleyin.
   • Sistem yönergelerini ayarlayın.
   • Temsilci kullanımı için araçları yapılandırın.

4. .yaml dosyasını kaydetmek için VS Code menü çubuğunda Dosya>Kaydet'i seçin.

Aracı YAML tanımını gözden geçirin

.yaml dosyası tasarımcıyla birlikte açılır ve aracınızın yapılandırma ayrıntılarını içerir. Biçim aşağıdaki örneğe benzer:

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

Aracıya araç ekleme

Aracı Hizmeti, aracınızın özelliklerini genişletmek ve veri kaynaklarınıza bağlanmak için aşağıdaki araçları sağlar:

• Bing araması ile temellendirme
• Dosya arama
• Kod yorumlayıcı
• OpenAPI belirtilen araçları
• Model Bağlam Protokolü (MCP)

MCP araçlarını kullanma hakkında daha fazla bilgi için bkz. Visual Studio Code'da Aracı Hizmeti ve MCP sunucu araçlarıyla çalışma (önizleme).

Temsilciye araç ekle

1. Tasarımcıda, Araç bölümünün sağ üst köşesinde Araç ekle'yi seçin. Açılan listede, eklemek istediğiniz aracı seçin.

   

2. Tasarımcı, aşağıdaki görüntülerde gösterildiği gibi aracı yapılandırmak için uygun bölmeyi görüntüler:

   • Bing araması ile temellendirme:

     

   • Dosya arama:

     

   • Kod yorumlayıcı:

     

   • OpenAPI 3.0 belirtilen araçlar:

     

3. Gerekli bilgileri girdikten sonra Oluştur ve bağlan, Karşıya yükle ve kaydet veya Araç Oluştur'u seçin. Düğme etiketi araç türüne göre değişir.

   Araç oluşturulduktan sonra tasarımcının TOOL bölümünde görünür.

Bir araç eklediğinizde, ihtiyaç duyduğu tüm yeni varlıkları da ekleyebilirsiniz. Örneğin, bir dosya arama aracı eklerseniz, var olan bir vektör deposu varlığını kullanabilir veya karşıya yüklenen dosyalarınızı barındırmak için yeni bir tane oluşturabilirsiniz.

Aracıyı Foundry'ye dağıtma

Ajanınızı yapılandırmayı tamamladıktan sonra bulutta çalışması için Foundry'ye dağıtın.

1. Tasarımcıda Microsoft Foundry'de Aracı Oluştur düğmesini seçin.

2. VS Code'da Kaynaklar görünümünü yenileyin. Dağıtılan ajan, Klasik Ajanlar alt bölümünde görünür.

Dağıtılan aracı ayrıntılarını görüntüleme

Aracı TERCIHLERI bölmesini yalnızca görüntüleme modunda açmak için dağıtılan aracıyı seçin. Bu bölmeden şunları yapabilirsiniz:

• Aracıyı Düzenle'yi seçerek aracı tasarımcısını ve .yaml tanımını düzenlemek üzere açın.
• Aracıyı kullanan bir örnek kod dosyası oluşturmak için Kodu Görüntüle'yi seçin.
• Uzak temsilci oyun alanı açmak için Oyun Alanı Aç'ı seçin.

Dağıtılan aracıyı güncelleştirme

Dağıtılan bir aracının yapılandırmasını değiştirebilir ve değişiklikleri Tekrar Foundry ile eşitleyebilirsiniz.

1. ARACI TERCIHLerİ bölmesinde Aracıyı Düzenle'yi seçin. Aracı tasarımcısı, aracının .yaml dosyasıyla açılır.

2. Ajanın yapılandırmasını, model, araçlar ve talimatlar gibi unsurlar dahil olmak üzere düzenleyin.

3. Değişikliklerinizi kaydetmek için Microsoft Foundry'de Aracıyı Güncelleştir düğmesini seçin. Güncelleştirilmiş yapılandırma hemen geçerli olur.

Örnek kod dosyası oluşturma

Uzantı, dağıtılan ajanınızla programatik olarak etkileşime geçmek için şablon kodu oluşturur.

1. Dağıtılan aracınıza sağ tıklayın ve Kodu Görüntüle'yi seçin. Alternatif olarak, AGENT PREFERENCES bölmesinde Kodu Görüntüle düğmesini de seçebilirsiniz.

2. Tercih ettiğiniz SDK'yı seçin açılan listesinde SDK'nızı seçin.

3. Dil seçin açılan listesinde dilinizi seçin.

4. Kimlik doğrulama yöntemi seçin açılan listesinde kimlik doğrulama yönteminizi seçin.

Uzantı, seçtiğiniz dilde bir kod dosyası oluşturur ve dosyayı düzenleyicide açar.

Örnek kod dosyasını gözden geçirin

Oluşturulan kod dosyası, Döküm Projeleri API'sini kullanarak aracıyla etkileşime geçmek için temel bir çağrı gösterir. Aşağıdaki ekran görüntüsünde bir Python örneği gösterilmektedir:

Oyun alanında aracıyı test edin

Dağıtılmış ajanınıza mesaj göndermek ve davranışını doğrulamak için deneme ortamını kullanın.

1. Dağıtılan aracınıza sağ tıklayın ve ardından Oyun Alanı Aç'ı seçin.

   Alternatif olarak, Araçlar alt bölümündeki Uzak Aracı Oyun Alanı bağlantısını seçin, aracı türünüzü seçin ve ardından açılan listelerden temsilcinizi seçin.

   Uzak Aracı Oyun Alanı bölmesi açılır ve ajanınızla bir iş parçacığı başlatılır.

2. İsteminizi girin ve çıkışları görüntüleyin.

   Bu örnekte, bilgi için bir web aramasını açıklamak için Bing Grounding kullanılır. Ajan, ajan tasarımcısında konfigüre ettiğiniz modeli ve araçları kullanır. Bilgilerin kaynağı aracı ek açıklamaları bölümünde yer alır.

   

Aracı iş parçacıklarını görüntüleme

Konular alt bölümü, aracınızın çalıştırılması sırasında oluşturulan konuşma konularını görüntüler. Kaynaklar görünümünün altındaki Klasik bölümünde, listeyi görüntülemek için İş Parçacıkları alt bölümünü genişletin.

Uyarı

Konu başlığı, bir aracı ile kullanıcı arasındaki konuşma oturumudur. Threadler mesajları depolar ve içeriği modelin bağlamına sığdırmak için kesme işlemini otomatik olarak yürütür. İleti, metin, resim ve diğer dosyaları içerebilen tek bir etkileşimdir. Çalıştırma, birden çok iş parçacığına ve iletiye yayabilen bir aracının tek bir yürütülmesidir.

Konu ayrıntılarını görüntüle

İŞ PARÇACıĞı AYRINTILARI bölmesini görüntülemek için listeden bir iş parçacığı seçin.

Çalıştırma ayrıntılarını görüntüleme

Çalıştırma bilgilerini görüntülemek için İş PARÇACıĞı AYRINTILARIbölmesindeKi Çalıştırma bilgilerini görüntüle düğmesini seçin. Aracı yapılandırması, iletileri ve araç çağrıları dahil olmak üzere çalıştırmanın ayrıntılarını içeren bir .json dosyası açılır.

Kaynakları temizle

Oluşturduğunuz kaynaklara ihtiyacınız yoksa Azure aboneliğinizde sürekli ücret tahsil edilmemesi için bunları silin.

Aracılarınızı silme

Tavsiye

Microsoft Foundry portalında sol bölmeyi özelleştirebildiğiniz için, bu adımlarda gösterilenden farklı öğeler görebilirsiniz. Aradığınızı görmüyorsanız ... seçeneğini belirleyin. Sol bölmenin en altında daha fazlası.

1. VS Code'da Azure Kaynakları görünümünü yenileyin.
2. Dağıtılan aracıların listesini görüntülemek için Aracılar alt bölümünü genişletin.
3. Silmek istediğiniz aracıya sağ tıklayın ve sil'i seçin.

Modellerinizi silme

1. VS Code'da Kaynaklar görünümünü yenileyin. Dağıtılan modellerin listesini görüntülemek için Modeller alt kısmını genişletin.

2. Silmek istediğiniz modele sağ tıklayın ve sil'i seçin.

Bağlı araçlarınızı silme

1. Azure portalını açın.

2. Araç kaynağını içeren kaynak grubuna gidin.

3. Kaynağı ve ardından Sil'i seçin.

İlgili içerik

• Aracılarınıza MCP araçları eklemek için Visual Studio Code'da Aracı Hizmeti ve MCP sunucu araçlarıyla (önizleme) çalışın .
• Dosya arama, kod yorumlayıcı ve diğer kullanılabilir araçlarla ilgili ayrıntılar için aracı araçlarına genel bakış.
• Foundry Agent Servisi'ne genel bakış için, araç kavramlarını ve özelliklerini daha derinlemesine inceleyin.