Agent Framework Skills ile .NET ve Python Ajan Geliştirme

Microsoft, Microsoft Agent Framework için .NET ve Python tarafında builder skill’ler yayımladı. Bu skill’ler kodlama ajanınıza rehberlik sağlayarak araçlar, oturumlar, workflow ve hosting bağlantılarını doğru şekilde kurmanıza yardımcı olur.

Microsoft, Microsoft Agent Framework için.NET ve Python tarafında kurulabilir builder skill‘ler yayımladı. Bu skill’ler, kod yazan ajanınıza (coding agent) Agent Framework uygulamalarını kurma ve değiştirme konusunda Microsoft’un bakımını üstlendiği bir rehberlik taşıyor; doğru mimari deseni seçmekten araçların, oturumların, workflow’ların ve hosting tarafının bağlanmasına kadar. “Agent Framework ile şunu yap” dediğinizde asistanın sıfırdan tahmin yürütmesi yerine çerçeveye özgü yönlendirmeyle hareket etmesini bekleyebilirsiniz.

Bunlar geliştirme zamanı skill’leri. Yayına aldığınız uygulamanın çalışma anında yüklediği bileşenler değiller, kodlama asistanınızın kullandığı rehberlik paketleri.

Kurulum: GitHub CLI veya skills CLI

Kullandığınız kodlama ajanının Agent Skills formatını desteklemesi gerekiyor. GitHub CLI ile.NET skill’ini main dalından kurmak için:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main

Python tarafı için:

gh skill install microsoft/agent-framework agent-framework-builder-python@main

Her iki örnek de depodaki en güncel rehberliği almak üzere main kullanıyor. Tekrarlanabilir bir anlık görüntüye ihtiyacınız varsa bir etiketi veya commit’i sabitlemeniz öneriliyor.

Ajanlar arası çalışan skills CLI de bir seçenek:

npx skills add microsoft/agent-framework --skill agent-framework-builder-dotnet
npx skills add microsoft/agent-framework --skill agent-framework-builder-python

İki kurulum yolundan birini seçip desteklenen istemciler ve kapsam için ilgili aracın dokümantasyonuna bakmanız gerekiyor: GitHub CLI veya skills CLI. Skill kurmanız uygulamanızın kendi gereksinimlerini ortadan kaldırmıyor, SDK paketleri ve model kimlik bilgileri yine sizin sorumluluğunuzda.

Microsoft Learn MCP ile birlikte kullanmak

Builder skill’lerin doğal tamamlayıcısı Microsoft Learn MCP Server. Skill odaklı ve sınırlı bir uygulama rehberliği verirken Learn MCP, kodlama ajanınızın Agent Framework dokümantasyonunun tamamında arama yapmasını, daha fazla ayrıntı gerektiğinde makalelerin ve kod örneklerinin tamamını çekmesini sağlıyor.

Streamable HTTP uç noktası şöyle yapılandırılıyor:

https://learn.microsoft.com/api/mcp

Rehberlik neyi kapsıyor?

Her skill’in bir SKILL.md giriş noktası ve odaklı referansları var. Kodlama ajanı önce projenizi ve bağımlılıklarınızı inceliyor, sonra çerçevenin tüm özelliklerini birden yüklemek yerine yalnızca o göreve ilişkin rehberliği devreye alıyor.

Her iki skill de işe yarayan en küçük deseni tercih ediyor:

  • Araçlar ve oturumlar yeterliyse tek bir agent,
  • Bir işletim döngüsü (operating loop) gerekiyorsa harness,
  • Açık aşamalar, yönlendirme ve checkpoint gereksinimi varsa workflow.

Bir destek asistanının, sırf birkaç aracı var diye çok ajanlı bir sisteme ihtiyacı olmadığı da kaynakta bu yaklaşımın örneği olarak veriliyor.

Rehberlik dile özgü hazırlanmış..NET skill’i AIAgent, Microsoft.Extensions.AI, NuGet paketleri, dependency injection ve ASP.NET Core hosting konularını kapsıyor. Python skill’i ise Agent, sağlayıcı paketleri, middleware, context provider’lar ve Python tarafındaki workflow desenlerini ele alıyor.

Diğer Microsoft servisleriyle çalışıyorsanız

Uygulamanız Azure ve Foundry tarafına da dokunuyorsa bu işler için Azure Skills Plugin öneriliyor. Eklentinin microsoft-foundry skill’i Foundry model ve agent akışlarını kapsıyor; azure-prepare, azure-deploy ve azure-diagnostics skill’leri de Azure uygulamalarını hazırlama, dağıtma ve sorun giderme adımlarına yardımcı oluyor.

Eklenti, kaynak listeleme ve log sorgulama gibi görevler için Azure MCP Server‘ı, model ve agent operasyonları için de Foundry MCP’yi içeriyor. Bunları yalnızca uygulamanızın ihtiyaç duyduğu noktada eklemek mantıklı, çünkü Azure operasyonları uygun kimlik bilgileri ve izinler gerektiriyor.

Pratikte nasıl kullanılıyor?

Kodlama ajanına doğal dille istek veriyorsunuz. Uyumlu istemciler skill’leri metadata üzerinden keşfettiği için evrensel bir slash komutu yok. Kaynakta.NET için verilen örnek istem şöyle:

Add an Agent Framework support assistant to our ASP.NET Core app. Use our model provider, isolate conversations per user, require approval before changing tickets, and test tool behavior with a fake IChatClient.

Mevcut bir Python uygulaması için verilen örnek ise şu:

Turn this Python Agent Framework research agent into a research-and-review workflow. Preserve its response format, add checkpointing, and test resume behavior using the project’s existing test tooling.

Biliyorsanız sağlayıcınızı, hosting hedefinizi, kalıcılık (persistence) gereksinimlerinizi ve onay sınırlarınızı isteme dahil etmeniz tavsiye ediliyor. Skill’ler kodlama ajanını, sonuç doğuracak belirsizlikleri netleştirmeye, mevcut davranışı korumaya ve yapılan değişikliği doğrulamaya yönlendiriyor.

Sorun yaşarsanız

Kendi projenizde dilinize uygun builder skill’i deneyebilirsiniz. Bir şey beklediğiniz gibi çalışmazsa Agent Framework deposunda issue açarken skill adını, kullandığınız kodlama ajanını, ne yapmaya çalıştığınızı ve neyin yanlış gittiğini belirtmeniz isteniyor.

Kaynaklar ve İleri Okuma

Bu yazı yapay zeka (büyük dil modelleri) ile hazırlanmış, insan editör tarafından incelenmiştir. İçerik üretim sürecimiz.
Aşkın KILIÇ

20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.

AZ-305AZ-104AZ-500AZ-400DP-203AI-102

Bu içerik işinize yaradı mı?

Benzer içerikleri kaçırmamak için YouTube ve GitHub hesaplarımı takip edin.

Haftalık Bülten

Her pazar özenle seçilmiş teknoloji yazıları doğrudan e-postanıza gelsin.

Kurumsal DevOps ve bulut dönüşümü danışmanlığı: Danışmanlık Hizmetleri

2 Yorum

  1. Semantic Kernel’den Agent Framework’e geçiş sürecinde kafam karışıktı, bu skill’ler tam zamanında gelmiş. Python tarafındaki skill’ler .NET ile birebir aynı kapsamda mı acaba, onu merak ettim.

  2. Python tarafında Semantic Kernel ile uğraşırken bu tarz rehber skill’lerin eksikliğini çok hissetmiştim, iyi olmuş yani. Workflow bağlantıları kısmını deneyen var mı, hosting tarafı ne kadar stabil acaba?

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

✉

Haftalık Bülten

Azure, DevOps ve Yapay Zeka dünyasındaki en güncel içerikleri her hafta doğrudan e-postanıza alın.

Spam yok. İstediğiniz zaman iptal edebilirsiniz.
📱
Uygulamayı Yükle Ana ekrana ekle, çevrimdışı oku
Kategoriler
Ara
Paylaş
WhatsApp
İçindekiler
← SharePoint Server’da Low...
Azure Cobalt 200 ile EDA İş Yü... →
📩

Gitmeden önce!

Her pazar özenle seçilmiş teknoloji yazıları ve AI haberleri doğrudan e-postanıza gelsin. Ücretsiz, spam yok.

🔒 Bilgileriniz güvende. İstediğiniz zaman ayrılabilirsiniz.

📬 Haftalık bülten: Teknoloji + AI haberleri
Beni Takip Et Yeni Azure / AI / DevOps yazılarını GitHub ve RSS üzerinden takip edin.