Yerel MAF Ajansınız Artık Üretimde Bir Yuva Buldu

Emiliano Montesdeoca — Sat, 30 May 2026 00:00:00 +0000

Bir ajanı yerel olarak çalıştırmak eğlenceli kısımdır. Zor kısım sonrasında gelen her şeydir: aklını kaybetmeden deploy etmek, oturumları yönetmek, kimlik oluşturmak, gözlemlenebilirliği bağlamak. Genellikle bu çok sayıda özel altyapı gerektirmek anlamına gelir.

Foundry Hosted Agents, Microsoft Agent Framework (MAF) kullanıcıları için bu altyapının büyük bölümünü ortadan kaldırdı.

Foundry Hosted Agents Gerçekte Ne Yapar

Bir MAF ajanını Foundry Hosted Agents’a deploy ettiğinizde, platform normalde kendiniz oluşturmanız gereken şaşırtıcı derecede uzun bir liste işlemi üstlenir:

Sıfıra ölçekleme — ajanınız boşta iken hiçbir şey ücretlendirmez ve otomatik olarak yeniden başlar
Oturum başına VM-izole sandbox’lar — her kullanıcı oturumu, ölçek küçültme olaylarını atlatan dosya sistemi kalıcılığı olan kendi sandbox’ını alır
Yerleşik Entra ID — her ajan, imaja gömülü sırlar olmaksızın Foundry modellerini, Toolbox’ı ve Azure hizmetlerini çağırabilmek için kendi kimliğini alır
Sürümlü deployment’lar — her deployment, blue/green ve canary rollout desteği olan değiştirilemez bir snapshot’tır
Sıfır yapılandırmalı gözlemlenebilirlik — APPLICATIONINSIGHTS_CONNECTION_STRING çalışma zamanında enjekte edilir, böylece MAF’ın OpenTelemetry izleri App Insights’a otomatik olarak akar

Sonuncusu gerçekten güzel. Ekstra kablo bağlantısı yok, ekstra yapılandırma yok. İzler sadece görünür.

Kod Farkı Minimumdur

Bu entegrasyonda en çok takdir ettiğim budur. Ajanınızı yeniden yazmanıza gerek yok. Sadece sarmanız yeterli:

.NET’te:

using Microsoft.Agents.AI.Foundry.Hosting;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddFoundryResponses(agent);

var app = builder.Build();
app.MapFoundryResponses();

app.Run();

Python’da:

server = ResponsesHostServer(agent)
server.run()

Hepsi bu kadar. Yerel olarak test ettiğiniz mantığın aynısı üretimde çalışır. Platform bunu oturum yönetimi, kimlik ve ölçekleme altyapısıyla sarar.

İki Protokol, Bir Ajan

Hosted Agents iki endpoint stili destekler:

Responses (/responses) — OpenAI uyumlu, konuşma geçmişini ve akışı yönetir. Sohbet biçimli ajanlar için iyi varsayılan.
Invocations (/invocations) — istek/yanıt şemasını kendiniz tanımlarsınız. Konuşma dışı iş akışları için uygundur.

Konuşmaya benzeyen bir şey oluşturuyorsanız Responses ile başlayın. Yapılandırılmış girdi alan ve yapılandırılmış çıktı döndüren API biçimli bir ajan oluşturuyorsanız Invocations size esneklik sağlar.

`azd` ile Deployment Akışı

Bir MAF ajanıyla azd up çalıştırdığınızda:

İsteğe bağlı olarak Foundry projesi oluşturur ve model deploy eder
Kodunuzu paketler ve Azure Container Registry’ye imaj iter
ACR imajından işlem kapasitesi sağlar
Ajana özel bir Entra ID atar
Stabil bir endpoint açar (https://{project_endpoint}/agents/{agent_name})
O noktadan itibaren geri kalan her şeyi yönetir

Oturumlar 30 güne kadar devam eder. Boşta işlem kapasitesi 15 dakika sonra kaldırılır ve bir sonraki istekte şeffaf şekilde geri yüklenir. Ajanın bakış açısından hiçbir şey değişmemiştir.

Sonuç

“Yerel olarak çalışan” ile “üretimde çalışan” arasındaki mesafe, AI ajanları için tarihsel olarak uzun ve acı verici olmuştur. Foundry Hosted Agents + MAF bu boşluğu önemli ölçüde kapatır. Agent Framework ile oluşturulmuş yerel bir ajanınız varsa bugün denemek değer.

Ekip GA’nın yakında geleceğini söylüyor — bu şu anda önizlemede. Başlamak için MAF Hosted Agent entegrasyon belgelerine ve .NET örneklerine bakın.

Orijinal makale: From Local to Production: Deploy Your Microsoft Agent Framework Agent with Foundry Hosted Agents