Bir kodlama aracısı ile Agent Framework uygulamaları oluşturma

.NET için Microsoft Agent Framework builder yeteneği, agent-framework-builder-dotnet, uyumlu kodlama ajanlarına .NET (C#) Agent Framework çözümleri oluşturmak için Microsoft tarafından sağlanan rehberlik sunar. Kodlama aracısının uygun bir desen seçmesine ve görev için aşamalı olarak odaklanmış yönergeleri yüklemesine yardımcı olur.

Beceri, aşağıdakilerle yapılan çalışmaları yönlendirebilir:

  • Plain aracılar, model sağlayıcıları, araçlar, oturumlar, geçmiş, bağlam sağlayıcıları ve ara yazılım.
  • Aracıları yapılacaklar, modlar, bellek, onaylar, beceriler, arka plan aracıları, kabuk araçları, sıkıştırma ve döngülerle kullanın.
  • İş akışları, yerleşik orkestrasyonlar ve bildirimsel tanımlar.
  • Değerlendirme, gözlemlenebilirlik, özel istemciler, özel ajanlar ve tümleştirmeler.
  • Barındırma ve dağıtım.

Beceri, harici bir kodlama ajanı için geliştirme yönergeleri sağlar. Bu bir NuGet paketi değildir ve Agent Framework uygulamanızın içinde çalışmaz.

Important

Bu coding-agent becerisi, runtime Agent Skills'den farklıdır. Çalışma zamanı yetenekleri, uygulamanız çalışırken bir Agent Framework aracısı tarafından yüklenir. Oluşturucu becerisi, bir kodlama aracısının uygulama kaynak kodunuzu oluşturmasını veya değiştirmesini sağlar.

Tip

Microsoft Learn MCP Sunucusu ile oluşturucu becerisini eşleştirin. Beceri, kodlama aracısına odaklanmış Agent Framework iş akışı ve uygulama kılavuzu sağlarken Learn MCP Sunucusu, görev sırasında güncel Microsoft belgelerinde arama yapmasını, eksiksiz makaleleri getirmesini ve kod örneklerini bulmasını sağlar. Uyumlu bir kodlama aracısında bu genel, kimliği doğrulanmamış Streamable HTTP uç noktasını yapılandırın:

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

Prerequisites

  • Açık Agent Skills spesifikasyonunu destekleyen bir kodlama aracısı.
  • önizleme gh skill komutlarıyla GitHub CLI veya aracılar arası skills CLI kullanıyorsanız Node.js 22.20 ya da sonraki bir sürüm.
  • Yeni Agent Framework uygulamaları için şu anda desteklenen bir .NET SDK'sı.

GitHub CLI beceri yönetimi önizleme aşamasındadır ve değişebilir.

GitHub CLI ile gözden geçirin ve kurun

.NET oluşturucu becerisi henüz etiketli bir sürümde olmadığından @main ref'ini belirtmeniz gerekir. Yüklemeden önce becerinin önizlemesini görüntüleyin:

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

Skill'i yükleyin:

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

Varsayılan yükleme proje kapsamlıdır ve etkileşimli olmayan kullanımda GitHub Copilot'u hedefler. Gerektiğinde desteklenen başka bir kod ajanı veya kullanıcı kapsamı seçin:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent claude-code \
  --scope user

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

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

Geçerli istemci ve kapsam seçenekleri için bkz gh skill install. .

cross-agent skills CLI ile yükleyin

Alternatif olarak, beceriyi cross-agent skills CLI ile yükleyin:

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

Yüklemeden önce CLI'nın desteklenen kodlama araçlarını ve çalışma zamanı gereksinimlerini gözden geçirin.

Beceriyi kullan

Kodlama aracısına doğal bir şekilde komut verin. Uyumlu istemciler beceriyi meta verilerinden keşfeder ve etkinleştirir; evrensel eğik çizgi komutunu varsaymayın.

Örnek komutlar:

  • Build a .NET Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
  • Add approval-required tools and persistent conversation history to this Agent Framework application.
  • Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
  • Create a harness agent with todos, file access, and safe shell tooling.
  • Review this .NET Agent Framework application for current APIs and package requirements.
  • Prepare this Agent Framework agent for hosting in ASP.NET Core and add an evaluation plan.

Model sağlayıcısı, barındırma hedefi, kalıcılık gereksinimleri, güvenlik sınırı ve bunları biliyorsanız hedef .NET sürümü gibi kısıtlamaları dahil edin.

Kodlama aracısının yapması gerekenler

Beceri, bir kodlama aracısına şunları yapmasını söyler:

  • Hedef çerçeveler, SDK sürümü, paket yönetimi ve yüklü Microsoft.Agents.AI.* paketler dahil olmak üzere mevcut çözümü inceleyin.
  • Yalın ajan, harness, iş akışı, orkestrasyon veya bildirim temelli tanım gibi en küçük uygun deseni seçin.
  • Yalnızca ilgili odaklanılan referansları yükleyin.
  • Yalnızca uygulamanın ihtiyaç duyduğu dar paket kümesini ekleyin ve bazı paketler yayın öncesi olduğundan, ona bağımlı hale gelmeden önce her paketin olgunluğunu denetleyin.
  • Yapılandırmadan uç noktaları, modelleri ve anahtarları okuyun ve sabit kodlanmış API anahtarları yerine belirteç kimlik bilgilerini tercih edin.
  • Oluşturulan uygulamayı deponun mevcut testleriyle ve çalıştırılabilir örneklerle doğrulayın.

Beceri, oluşturulan kodun üretime hazır olduğunu garanti etmez. Onaydan önce kodlama aracısının planını, paket seçimlerini, güvenlik sınırlarını, komutlarını ve oluşturulan değişiklikleri gözden geçirin.

Sürümlendirme ve güven

Bu beceri genel, yüklenebilir, Microsoft tarafından sürdürülen bir tüketici becerisidir. Beceri meta veri sürümü 0.1'dir.

  • Beceriyi içeren etiketli bir sürüm yayınlanana kadar @main ref'ini kullanın.
  • Yüklemeden önce beceri içeriğinin önizlemesini yapın ve yeni betiklere veya yönergelere güvenmeden önce güncelleştirmeleri gözden geçirin.

Kaynak ve odak referansları için bkz:

Sonraki Adımlar

İlk aracınızı oluşturma

Daha derine gidin:

Python için Microsoft Agent Framework Builder Skill, agent-framework-builder-pythonPython Agent Framework çözümleri oluşturmak için uyumlu kodlama aracılarına Microsoft tarafından sağlanan yönergeler sunar. Kodlama aracısının uygun bir desen seçmesine ve görev için aşamalı olarak odaklanmış yönergeleri yüklemesine yardımcı olur.

Beceri, aşağıdakilerle yapılan çalışmaları yönlendirebilir:

  • Düz ajanlar, model sağlayıcıları, araçlar, onaylar, oturumlar, geçmiş ve bağlam sağlayıcıları.
  • Planlama, yapılacaklar, bellek, sıkıştırma, dosyalar, arka plan ajanları, kabuk araçları ve döngülerle ajanlardan yararlanın.
  • İşlevsel ve grafik iş akışları, yerleşik orkestrasyonlar ve bildirimsel tanımlar.
  • Değerlendirme, gözlemlenebilirlik, middleware, özel istemciler, özel ajanlar ve entegrasyonlar.
  • Kendi kendine barındırma ve Microsoft Foundry tarafından barındırılan aracı geliştirme.

Beceri yalnızca Python'a özeldir. Bir dış kodlama aracısı için geliştirme yönergeleri sağlar; bir Python paketi değildir, pip install agent-framework tarafından yüklenmez ve Agent Framework uygulamanızın içinde çalışmaz.

Important

Bu coding-agent becerisi, runtime Agent Skills'den farklıdır. Çalışma zamanı yetenekleri, uygulamanız çalışırken bir Agent Framework aracısı tarafından yüklenir. Oluşturucu becerisi, bir kodlama aracısının uygulama kaynak kodunuzu oluşturmasını veya değiştirmesini sağlar.

Tip

Microsoft Learn MCP Sunucusu ile oluşturucu becerisini eşleştirin. Beceri, kodlama aracısına odaklanmış Agent Framework iş akışı ve uygulama kılavuzu sağlarken Learn MCP Sunucusu, görev sırasında güncel Microsoft belgelerinde arama yapmasını, eksiksiz makaleleri getirmesini ve kod örneklerini bulmasını sağlar. Uyumlu bir kodlama aracısında bu genel, kimliği doğrulanmamış Streamable HTTP uç noktasını yapılandırın:

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

Prerequisites

  • Açık Agent Skills spesifikasyonunu destekleyen bir kodlama aracısı.
  • önizleme gh skill komutlarıyla GitHub CLI veya aracılar arası skills CLI kullanıyorsanız Node.js 22.20 ya da sonraki bir sürüm.
  • Yeni Agent Framework uygulamaları için Python 3.11 veya sonraki bir sürüm. Agent Framework 1.23, Python 3.10'ı desteklemeye devam eder, ancak Python 3.10, yukarı akış ömrünün sonuna ulaşmıştır.

GitHub CLI beceri yönetimi önizleme aşamasındadır ve değişebilir.

GitHub CLI ile gözden geçirin ve kurun

Kullanıma sunulan beceriyi yüklemeden önce önizleyin:

gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0

En son etiketli sürümü yükleyin:

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

Yeniden üretilebilir rehberliğe ihtiyacınız olduğunda Python 1.23 sürümünü sabitleyin:

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

Varsayılan yükleme proje kapsamlıdır ve etkileşimli olmayan kullanımda GitHub Copilot'u hedefler. Gerektiğinde desteklenen başka bir kod ajanı veya kullanıcı kapsamı seçin:

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent codex

Geçerli istemci ve kapsam seçenekleri için bkz gh skill install. .

cross-agent skills CLI ile yükleyin

Alternatif olarak, beceriyi cross-agent skills CLI ile yükleyin:

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

Yüklemeden önce CLI'nın desteklenen kodlama araçlarını ve çalışma zamanı gereksinimlerini gözden geçirin.

Beceriyi kullan

Kodlama aracısına doğal bir şekilde komut verin. Uyumlu istemciler beceriyi meta verilerinden keşfeder ve etkinleştirir; evrensel eğik çizgi komutunu varsaymayın.

Örnek komutlar:

  • Build a Python Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
  • Add approval-required tools and persistent conversation history to this Agent Framework application.
  • Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
  • Create a harness agent with planning, todos, file access, and safe shell tooling.
  • Review this Python Agent Framework application for current APIs and package requirements.
  • Prepare this Agent Framework agent for Foundry hosting and add an evaluation plan.

Biliyorsanız model sağlayıcısı, barındırma hedefi, kalıcılık gereksinimleri, güvenlik sınırı ve desteklenen Python sürümü gibi kısıtlamaları dahil edin.

Kodlama aracısının yapması gerekenler

Beceri, bir kodlama aracısına şunları yapmasını söyler:

  • Yalın ajan, harness, iş akışı, orkestrasyon veya bildirim temelli tanım gibi en küçük uygun deseni seçin.
  • Yalnızca ilgili odaklanılan referansları yükleyin.
  • Geçerli Microsoft Learn kılavuzlarını, genel API başvurularını, paket yaşam döngüsü bilgilerini ve sık değişen ayrıntılar için bakımlı örnekleri tercih edin.
  • Her tümleştirmenin kararlı veya gerekli olduğunu varsaymak yerine dar paket kümeleri yükleyin.
  • Açıkça tanımlanmış oturum, onay, kimlik doğrulaması ve barındırma sınırlarını koruyun.
  • Oluşturulan uygulamayı deponun mevcut testleri, tür denetimleri ve çalıştırılabilir örneklerle doğrulayın.

Beceri, oluşturulan kodun üretime hazır olduğunu garanti etmez. Onaydan önce kodlama aracısının planını, paket seçimlerini, güvenlik sınırlarını, komutlarını ve oluşturulan değişiklikleri gözden geçirin.

Sürümlendirme ve güven

Bu beceri, python-1.23.0 depo etiketinde yayımlanan, genel kullanıma açık, yüklenebilir, Microsoft tarafından bakımı yapılan bir tüketici becerisidir. Beceri meta veri sürümü 0.3'dir.

  • En son etiketli sürüm için niteliksiz install komutunu kullanın.
  • @python-1.23.0 öğesini yeniden üretilebilirlik önemli olduğunda sabitleyin.
  • Yalnızca kasıtlı olarak yayınlanmamış yönergeler istediğinizde kullanın @main .
  • Yüklemeden önce beceri içeriğinin önizlemesini yapın ve yeni betiklere veya yönergelere güvenmeden önce güncelleştirmeleri gözden geçirin.

Kaynak ve odak referansları için bkz:

Sonraki Adımlar

İlk aracınızı oluşturma

Daha derine gidin:

Note

Go için Microsoft Agent Framework oluşturucu becerisi henüz mevcut değil. Geçerli yönergeler için Go kullanmaya başlama öğreticisini ve Agent Framework Go örneklerini kullanın.

  • Son güncelleştirme: