Microsoft Foundry'de Ajanlar

Foundry Agent Service, yapay zeka aracıları oluşturmaya, dağıtmaya ve ölçeklendirmeye yönelik yönetilen bir platformdur. Herhangi bir çerçeveyi, Foundry model kataloğundaki herhangi bir desteklenen modeli ve model çıkarımı ile araçlar için tek bir giriş noktasını kullanarak oluşturun.

Dökümhane, bildirim temelliden tam koda kadar spektrumda herhangi bir yerde sizinle karşılaşır: bir istem aracısı tanımlayın ve Foundry'nin bunu çalıştırmasına izin verin, kendi kodunuzu barındırılan bir aracı olarak paketleyip başka bir yerde çalıştırdığınız bir aracıdan Yanıtlar API'sini çağırın. Derlemenin nasıl yapılacağını seçin, her yolu kapsar.

Bir bakışta Aracı Hizmetleri

Bileşen Ne yapar?
Aracı Çalışma Zamanı Prompt ajanlarını ve barındırılan ajanları barındırır ve ölçeklendirir. Konuşmaları, araç çağrılarını ve temsilci yaşam döngüsünü yönetir.
Araç Kutuları Web araması, dosya arama, kod yorumlayıcı, MCP sunucuları ve özel işlevler gibi bir araç kümesini bir kez seçin. Ardından bunları merkezi kimlik doğrulaması, idare ve sürüm oluşturma ile tek bir yönetilen MCP uç noktası aracılığıyla aracılar arasında paylaşın.
Modeller GpT-4o, Lama ve DeepSeek gibi Dökümhane model kataloğundaki birçok modelle çalışır. Aracı kodunuzu değiştirmeden modelleri değiştirin.
Gözlemlenebilirlik Uçtan uca izleme, ölçümler, değerlendirmeler ve Application Insights tümleştirmesi. Temsilcinizin verdiği her kararı görün ve kalitesini ölçün.
İyileştirme Aracı iyileştiricisi (önizleme) aracı davranışını değerlendirir ve istem aracıları ve Barındırılan aracılar için otomatik olarak daha iyi yönergeler, beceriler, araç açıklamaları ve model seçimleri oluşturur.
Kimlik ve Güvenlik Microsoft Entra kimlik, RBAC, içerik filtreleri ve sanal ağ izolasyonu. Yerleşik kurumsal düzeydeki güven.
Yayımcılık Versiyon ajanları oluşturun, kararlı uç noktalar oluşturun ve Microsoft Teams, Microsoft 365 Copilot ve Entra Ajan Kaydı ile paylaşın.

Nasıl derleneceğini seçin

Tip

İlk temsilcini mi kuruyorsun? İstem aracısına, Foundry portalını veya kodla istem aracısı oluşturmaya yönelik hızlı başlangıcı kullanarak başlayın.

Foundry, tek bir model çağrısından tam kapsayıcılaştırılmış bir ajana kadar geliştirmeniz için çeşitli yollar sunar. Yapmaya çalıştığınız şeye göre yolunuzu seçin:

  • En az yönetmek mi istiyorsunuz?bir istem aracısı ile başlayın. Yönergeleri, modeli ve araçları yapılandırın; Foundry bunu kod yazmadan veya altyapıyla uğraşmadan çalıştırır.
  • Foundry'de tam kontrol mü istiyorsunuz?Barındırılan bir aracı devreye alın. Kendi kodunuzu ve framework'ünüzü bir konteyner olarak getirin; Foundry bunu yönetilen bir uç nokta, ölçeklendirme ve kimlik yönetimiyle çalıştırır.
  • Aracı kodunu zaten başka bir yerde mi çalıştırabilirsiniz?Yönetecek aracı kaynağı olmadan Foundry modellerini ve araçlarını kullanmak için Yanıtlar API'sini doğrudan çağırın.

Prompt aracıları ve barındırılan aracılar, Foundry'deki iki aracı türüdür. Sonraki bölüm, her birinin değerini ayrıntılı olarak açıklayarak gönül rahatlığıyla seçim yapmanızı sağlar.

Aracı türleri

Agent Service iki temsilci türü sunar. Seçiminiz, ne kadarını sizin oluşturacağınızı ve ne kadarını Foundry'nin yöneteceğini belirler:

  • İstem aracıları: en hızlı yol. Yönergeleri, modeli ve araçları tanımlayın ve Foundry aracıyı sizin için yönetecek kod veya altyapı olmadan çalıştırır.
  • Barındırılan aracılar: en fazla denetim. Kendi kodunuzu ve çerçevenizi getirin; Foundry bunu yönetilen uç nokta, ölçeklendirme ve kimliğe sahip bir kapsayıcı olarak çalıştırır.

Komut Ajanları

Yönergeler, model seçimi ve araçlar dahil olmak üzere istem aracılarını tamamen yapılandırma aracılığıyla tanımlarsınız. Hızlı bir başlangıç için bunları Foundry portalında yazın veya CI/CD iş akışlarınızla tümleştirmek için SDK'lar veya REST API ile program aracılığıyla tanımlayın. Her iki durumda da Foundry aracıyı sizin için çalıştırır. Bakımını yapmanız gereken bir uygulama kodu ve güvenlik açısından optimize etmeniz, ölçeklendirmeniz veya izlemeniz gereken kapsayıcılar ya da paketler yoktur.

Başlamak için iki yol:

  • Portal öncelikli: Foundry portalında etkileşimli olarak bir aracı oluşturun, onu oyun alanında test edin ve ardından uygulama kodunuzdan çağırın.
  • Kod öncelikli: Dağıtım işlem hattınızda SDK'yı veya REST API'yi kullanarak aracıyı tanımlayarak sürüm denetimini, kod gözden geçirmeyi ve otomatik dağıtımı etkinleştirebilirsiniz.

En iyi yöntem: Hızlı çalışmaya başlama, iç araçlar, özel düzenleme mantığı gerektirmeyen üretim aracıları ve altyapı ek yükü olmadan yönetilen çalışma zamanı isteyen ekipler.

Barındırılan aracılar

Barındırılan aracılar, Agent Framework, LangGraph, OpenAI Agents SDK, Anthropic Agent SDK, GitHub Copilot SDK veya kendi kodunuz ile oluşturduğunuz kod tabanlı aracılardır. Ajanınızı ister bir kapsayıcı görüntüsü ister kaynak kodunuzun .zip dosyası olarak sunabilirsiniz (.zip dosyası sağladığınızda Foundry görüntüyü sizin için oluşturur) ve Foundry, ajanınızı yönetilen bir uç nokta, otomatik ölçeklendirme, özel bir Microsoft Entra kimliği, oturum düzeyinde durum kalıcılığı ve uçtan uca gözlemlenebilirlikle çalıştırır.

Aracı kodunuz, model çıkarımı ve araç düzenlemesi için Foundry proje uç noktanızı çağırır. Bu sayede katalogdan Foundry modellerine ve dosya arama, kod yorumlayıcı ve web araması gibi standart araçlara ek olarak SharePoint, WorkIQ ve Fabric IQ gibi ek araçlar gibi birleşik bir platform araçları kümesine erişebilirsiniz.

En iyisi: Kendi özel kodunuzla çağıran aracılar; İkincil olarak, özel düzenleme mantığı, çok aracılı sistemler ve özel protokoller (web kancaları, ses, AG-UI), burada Foundry'nin barındırma, ölçeklendirme ve kimlik işlemlerini işlemesine izin verirken aracı mantığı üzerinde tam denetime sahip olmasını istersiniz.

Ajan türlerini karşılaştırın

Komut Ajanları Barındırılan aracılar
Yazma yüzeyi Portal, SDK veya REST Agent Framework, LangGraph, OpenAI Agents SDK, Anthropic Agent SDK, GitHub Copilot SDK'sı, özel kod
Dökümhane modelleri + platform araçları Evet Evet (Dökümhane proje uç noktasındaki Yanıtlar API'sini kullanarak)
Beceri desteği Evet Evet
Bakım için çalışma zamanı kodu Hiçbiri Evet, ajan mantığınız
Yönetim için işlem gücü Yok, tam olarak yönetiliyor Foundry tarafından yönetilen kapsayıcı işlem altyapısı
Yönetilen uç nokta Evet Evet
Autoscale Otomatik, Foundry tarafından yönetilir; istek hacmine göre ölçeklenir Otomatik, Foundry tarafından yönetilen; kapsayıcı örneklerini oturum ve istek hacmine göre ölçeklendirir
Aracı kimliği (Entra) Evet Otomatik, aracı başına özel
Maliyet modeli Çağrı başına çıkarım + araç kullanımı Çağrı başına çıkarım + araç kullanımı + kapsayıcı bilgi işlem
En iyi için Hızlı başlangıç, özel orkestrasyon olmadan üretim ajanları Özel kodu çağıran aracılar; ikincil olarak, özel orkestrasyon mantığı

Kısa ömürlü aracılar için Yanıtlar API'sini kullanma

Yanıtlar API'sini doğrudan kendi kodunuzdan çağırdığınızda kısa ömürlü bir aracı oluşturursunuz: Aracının tanımı (yönergeler, araçlar ve model), Foundry'de kalıcı bir kaynak yerine uygulama kodunuzda bulunur. Her çağrı, aracıyı sürecinizde oluşturur ve Responses API ile çalıştırır; bu nedenle Foundry'de oluşturulacak, güncellenecek veya silinecek bir aracı yoktur.

aşağıdaki durumlarda bu düzeni kullanın:

  • Uygulamanızla birlikte sunulan ajan mantığı. Tanım sürümlerini, birinin uygulamayla senkronize tutmak zorunda olduğu ayrı bir Foundry kaynağı olarak değil, kodunuzun geri kalanıyla birlikte kaynak denetimi ve kod incelemesi aracılığıyla yönetin.
  • Ek kaynak yükü olmadan Foundry yetenekleri. Katalog modellerini, platform araçlarını, proje kapsamındaki verileri, On-Behalf-Of kimlik doğrulamasını ve proje düzeyinde gözlemlenebilirlik ile yönetişimi elde etmeye devam edersiniz. Hepsi Foundry projenizin uç noktası üzerinden.

Bilgi için bkz . Hızlı Başlangıç: Yanıtlar API'sini kullanma .

Model desteği

Aracı Servisi, Foundry model katalogunda bulunan birçok modelle çalışır. Listenin tamamı için Foundry portalına bakın.

Araçlar ve araç kutuları

Ajanlar, dünya üzerinde araçlar aracılığıyla eylemde bulunur. Foundry web araması, dosya arama, kod yorumlayıcı ve bellek gibi yerleşik araçlar sunarken işlevler, OpenAPI özellikleri ve MCP sunucuları aracılığıyla özel araçlar eklemenize de izin verir. Tam küme için bkz. araç kutusuna genel bakış.

Araç kutusu bu araçları tek ve yeniden kullanılabilir bir ünitede gruplandırabilir. Araçları bir kez seçip düzenlersiniz; Foundry ise bunları, hangi çerçevenin kullanıldığından bağımsız olarak, herhangi bir ajan veya çalışma zamanı tarafından tüketilebilen tek bir yönetilen, MCP ile uyumlu uç nokta üzerinden sunar. Araç kutuları kimlik doğrulamayı, idareyi ve sürüm oluşturma işlemini merkezi hale getirerek araçları her aracıyı yeniden kullanmak yerine tek bir yerde güncelleştirmenizi sağlar. Yeni bir sürüm oluşturun, test edin ve hazır olduğunuzda varsayılan sürüme yükseltin. Daha fazla bilgi edinmek için bkz. Foundry'de Araç Kutusu nedir?.

MCP uzak sunucularına bağlanma ve kimlik doğrulaması

Foundry, Azure DevOps MCP Sunucusu gibi aracınıza ekleyebileceğiniz uzak MCP sunucularını destekler. Aracı erişimini etkinleştirmek için Azure DevOps kuruluşunuzu bağlayın ve aracıların gerçekleştirebileceği eylemleri denetlemek için kullanılabilir araçların bir alt kümesini yapılandırın. Özel araçları aracılarınıza göstermek için İşlevler MCP web kancası uç noktasını (/runtime/webhooks/mcp) kullanarak Azure İşlevleri üzerinde barındırılan özel MCP sunucularını da bağlayabilirsiniz.

MCP sunucuları ve diğer araç bağlantıları için desteklenen kimlik doğrulama seçenekleri şunlardır:

  • Anahtar tabanlı erişim
  • Microsoft Entra (aracının yönetilen kimliğini veya projenin yönetilen kimliğini kullanarak)
  • OAuth kimlik geçişi (Adına Kullanım)
  • Uygun yerlerde kimliği doğrulanmamış erişim

Bu kimlik doğrulama seçenekleri, araç yapılandırmasında yönetilen kimlik bilgileri ve kapsamlarla uzak MCP sunucularını bağlarken de geçerlidir.

Geliştirme yaşam döngüsü

Aracı Hizmeti tam derleme-test-dağıtma-izleme iş akışını destekler:

  1. Oluşturma: Portalda veya SDK ile bir istem aracısı tanımlayın veya Yanıtlar API'sini çağıran bir Barındırılan aracı yazın.
  2. Test: temsilci oyun alanında temsilcinizle sohbet edin veya yerel ortamda çalıştırın. Azure İşlevleri üzerinde barındırılan özel MCP sunucuları da dahil olmak üzere MCP sunucu tümleştirmeleri, yayımlamadan önce araç bağlantısını, izinlerini ve davranışını doğrulamak için doğrudan oyun alanında kullanılabilir.
  3. İzleme: Ajan izleme ile her model çağrısını, araç çağrısını ve kararı inceleyin.
  4. Değerlendirme: Kaliteyi ölçmek ve regresyonları yakalamak için değerlendirmeleri çalıştırın.
  5. İyileştirme: Aracı iyileştiricisini kullanarak barındırılan aracınızın yönergelerini otomatik olarak geliştirin.
  6. Yayımlama: Aracınızı kararlı bir uç noktaya sahip yönetilen bir kaynağa dönüştürün.
  7. İzleme: Hizmet ölçümleri ve panoları ile performansı ve güvenilirliği izleyin.

Ayrıntılı bir inceleme için Aracı geliştirme yaşam döngüsü bölümüne bakın.

Kurumsal özellikler

Aracı Hizmeti, dağıttığınız her aracı için kurumsal düzeyde altyapı sağlar:

  • Aracı kimliği: Her aracı, kimlik bilgilerini paylaşmadan kaynaklara ve API'lere güvenli, kapsamlı erişim sağlayan ayrılmış bir Microsoft Entra kimliğine sahip olabilir. Aracı kimlikleri, Azure İşlevleri üzerinde barındırılanlar dahil olmak üzere dış MCP sunucularında kimlik doğrulaması yapabilir ve yapılandırıldığında OAuth On-Behalf-Of (OBO) geçişi desteklenir.
  • Özel ağ: Tam ağ yalıtımı ve veri yerleşimi gereksinimleriyle uyumluluk için Azure sanal ağınızda aracıları çalıştırın. Özel ağ, istem aracıları için kullanılabilir. Barındırılan hizmet temsilcileri, her oturumun sanal ağınıza bağlı olarak VM ile yalıtılmış bir korumalı alanda çalıştığı, kendi Azure Sanal Ağınızı Getirme (BYO VNet) desteği sağlar.
  • Rol tabanlı erişim denetimi: Microsoft Entra ve Azure RBAC aracılığıyla ayrıntılı izinler. Aracıları kimlerin oluşturabileceğini, çağırabileceğini ve yönetebileceğini denetleme.
  • İçerik güvenliği: Tümleşik içerik filtreleri, istem ekleme risklerini (çapraz istem ekleme dahil) azaltmaya ve güvenli olmayan çıkışları önlemeye yardımcı olur.

Ortam kurulum yönergeleri için bkz. Ortamınızı ayarlama.

Yayımlama ve paylaşma

Aracı Hizmeti, aracılarınızın geliştirme aşamasından üretim aşamasına güvenle geçebilmesi için yerleşik sürüm oluşturma ve yayımlama sağlar.

  • Sürümleme: Aracınız üzerinde yineleme yaptıkça, sürümlerin anlık görüntüleri otomatik olarak alınır. Önceki sürümlere geri dönün veya sürümler arasındaki değişiklikleri karşılaştırın.
  • Yayımlama: Aracıyı, kararlı bir uç noktaya sahip yönetilen bir kaynağa dönüştürün. Yayımlanan aracılar, projeniz için yapılandırılan kurumsal kimliği ve erişim denetimlerini devralır ve program aracılığıyla çağrılabilir.
  • Dağıtım: Yayımlanan aracıları Microsoft 365 Copilot ve Teams ile Entra Agent Kayıt Defteri aracılığıyla paylaşın ve aracılarınızı kullanıcılarınızın zaten çalıştığı yere getirin. Foundry Agent Service, Microsoft 365 yayımlama için OpenResponses ve Etkinlik Protokollerini, özel uygulamalar ve hizmetlerle esnek uç nokta tümleştirmesi için bir Çağırma protokolü ve aracıdan aracıya iletişim için A2A protokolü (önizleme) destekler.

Güvenlik, gizlilik ve uyumluluk

Aracı Hizmeti, kimlik, ağ, veri işleme ve güvenlik üzerinde güçlü denetimlere ihtiyacınız olan kurumsal iş yükleri için tasarlanmıştır.

  • Güvenlik denetimleri: Güvenli olmayan çıktıları azaltmak ve çapraz komut ekleme saldırıları (XPIA) dahil olmak üzere komut ekleme risklerini azaltmak için entegre güvenlik raylarını kullanın.
  • Ağ yalıtımı ve veri yerleşimi denetimleri: Gereksinimlerinizi karşılamak için sanal ağları kullanın ve kendi kaynaklarınızı getirin.
  • Kendi kaynaklarınızı alma: Uyumluluk ve operasyonel gereksinimleri karşılamak için kendi Azure kaynaklarınızı (konuşma durumu için depolama, Azure Yapay Zeka Arama ve Azure Cosmos DB gibi) kullanın. Bkz . Kendi kaynaklarınızı kullanma.
  • Responsible AI kılavuzu: Daha geniş bir öneri ve idare kaynağı kümesi için bkz. Microsoft Foundry için Sorumlu Yapay Zeka.

İlgili içerik

  • Last updated on