Microsoft Foundry Temsilci Hizmeti nedir?

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ğundan desteklenen tüm modelleri ve Yanıtlar API'sini tek bir giriş noktası olarak kullanın.

Platformdan ne kadar istediğinizi seçersiniz:

  • İstem aracıları — Foundry portalında bir istem aracısı yazın veya SDK'lar ve REST ile tanımlayın; Foundry bunu sizin için çalıştırır. Bakımı yapılacak uygulama kodu yok, ücretini ödeyeceğiniz bir işlem gücü yok ve optimize edilecek, ölçeklendirilecek veya yamalanacak kapsayıcılar ya da paketler yok.
  • Barındırılan aracılar — aracı kodunuzu Agent Framework, LangGraph, OpenAI Agents SDK, Anthropic Agent SDK, GitHub Copilot SDK ya da kendi kodunuzla yazın, bunu bir kapsayıcı olarak paketleyin ve Foundry'nin bunu yönetilen bir uç nokta, ölçeklendirme, kimlik ve gözlemlenebilirlik ile çalıştırmasına olanak tanıyın.

Zaten Foundry dışında çalışan ajan kodunuz var mı? Kodunuzu taşımadan Foundry modellerini ve platform araçlarını almak için mevcut işleminizden Yanıtlar API'sini çağırın.

Temsilci nedir?

Aracı, kullanıcı isteklerini düşünmek ve bunları yerine getirmek için otonom eylemler gerçekleştirmek için Foundry model kataloğundan bir model kullanan bir yapay zeka uygulamasıdır. Yalnızca metin oluşturan basit bir sohbet botun aksine, bir aracı bir görevi tamamlamak için araçları çağırabilir, dış verilere erişebilir ve birden çok adımda kararlar alabilir. Bazı durumlarda aracılar, bir kullanıcının veya kuruluşun adına görevleri yerine getirmek için sistem olayları tarafından tetiklenen arka planda otonom olarak çalışarak sohbet arabirimi olmadan hareket edebilir.

Her bir ajan üç temel bileşeni birleştirir.

  • Model: Dökümhane modeli kataloğunda yer alan ve mantık ve dil özellikleri sağlayan bir model.
  • Yönergeler: Hedefleri, kısıtlamaları ve davranışı tanımlayın. Foundry'de yönergeler, barındırılan aracıda istem tabanlı veya kod olabilir.
  • Araçlar: Arama, dosya işlemleri veya API çağrıları gibi verilere veya eylemlere erişim sağlayın.

Yapay zeka aracısının bileşenlerini gösteren diyagram.

Bir bakışta Aracı Hizmetleri

Bileşen Ne yapar?
Yanıtlar API'si Tüm aracı türleri için tek erişim noktası. Foundry modellerine ve platform araçlarına (dosya arama, kod yorumlayıcı, bellek, web araması, MCP sunucuları) herhangi bir çerçeve, işlem veya çalışma zamanı erişimi verir.
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çlar Web araması, dosya arama, bellek, kod yorumlayıcı, MCP sunucuları ve özel işlevler gibi yerleşik araçlar. Yönetilen kimlik doğrulama, hizmet tarafından yönetilen kimlik bilgilerini ve On-Behalf-Of (OBO)'yu içerir.
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 ve Application Insights entegrasyonu. Temsilcinizin aldığı her kararı görün.
Kimlik ve Güvenlik Microsoft Entra kimlik, RBAC, içerik filtreleri ve sanal ağ izolasyonu. Yerleşik kurumsal düzeydeki güven.
Yayımlama Versiyon ajanları oluşturun, kararlı uç noktalar oluşturun ve Microsoft Teams, Microsoft 365 Copilot ve Entra Ajan Kaydı ile paylaşın.

Aracılarla işe başlama

Yapmaya çalıştığınız şeye göre yolunuzu seçin:

  • Aracılar için yeni misiniz?bir istem aracısı ile başlayın : Foundry portalında bir aracı oluşturun, bir model seçin, araçları ekleyin ve koddan çağırın. Yazmanız veya bakımını yapmanız gereken bir runtime kodu yok — Foundry ajanı sizin için çalıştırır.
  • Foundry'de kod tabanlı bir aracı oluşturmak mı istiyorsunuz?Barındırılan aracı dağıtma : Aracınızı Agent Framework, LangGraph, OpenAI Aracıları SDK'sı veya kendi kodunuzla yazın, kapsayıcı olarak paketleyin ve Foundry'nin yönetilen uç nokta, ölçeklendirme ve kimlikle çalıştırmasına izin verin.
  • Zaten başka bir yerde çalıştırdığınız aracı kodundaki Foundry modellerini ve araçlarını kullanmak mı istiyorsunuz?Kodunuzu taşımadan Foundry modellerini ve platform araçlarını almak için mevcut işleminizden Yanıtlar API'sini çağırın.

Aracı türleri

Aracı Hizmetinde iki ana aracı türü vardır:

Komut Ajanları

İstem aracıları tamamen yapılandırmayla tanımlanır; yönergeler, model seçimi ve araçlar. Bunları hızlı bir başlangıç için Dökümhane portalında yazar veya CI/CD iş akışlarınızla tümleştirmek için SDK'lar veya REST API ile program aracılığıyla tanımlarsınız. Her iki durumda da Foundry, aracıyı sizin için çalıştırır; bakımı yapılacak bir uygulama kodu, ücretini ödeyeceğiniz bir işlem gücü ya da optimize edeceğiniz, ölçeklendireceğiniz veya güvenlik açısından izleyeceğiniz kapsayıcılar ya da paketler yoktur.

Başlamak için iki yol:

  • Portal öncelikli yaklaşım — Foundry portalında etkileşimli olarak bir aracı oluşturun, test alanında test edin ve ardından uygulama kodunuzdan çağırın.
  • Kod öncelikli — dağıtım işlem hattınızda SDK veya REST API kullanarak aracıyı tanımlayın; böylece sürüm denetimi, kod gözden geçirme ve otomatik dağıtım etkinleştirilir.

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 (önizleme)

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. Aracınızı ister bir kapsayıcı görüntüsü ister kaynak kodunuzun ZIP arşivi olarak dağıtın — bir ZIP arşivi sağladığınızda görüntüyü Foundry sizin için oluşturur — ve Foundry bunu yönetilen bir uç nokta, otomatik ölçeklendirme, ayrılmış bir Microsoft Entra kimliği, oturum düzeyinde durumun kalıcılığı ve uçtan uca gözlemlenebilirlik ile çalıştırır.

Arka planda, ajan kodunuz model çıkarımı ve araç orkestrasyonu için Foundry proje uç noktanızdaki Responses API'sini çağırır; bu da size katalogdaki Foundry modellerine ve birleşik bir platform araçları kümesine erişim sağlar — dosya arama, kod yorumlayıcı ve web araması gibi standart OpenAI araçlarının yanı sıra SharePoint, WorkIQ ve Fabric IQ gibi Foundry'ye özel araçlara da erişebilirsiniz.

Not

Barındırılan ajanlar şimdi genel önizlemede.

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.

Aracı kodunuzu Foundry dışında (örneğin, var olan bir uygulamaya eklenmiş) çalıştırmayı tercih ederseniz, doğrudan sizin işleminizden Yanıtlar API'sini çağırarak Foundry'nin modellerini ve platform araçlarını almaya devam edebilirsiniz. Bkz. Kendi kodunuzdan Yanıtlar API'sini kullanma.

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

Komut Ajanları Barındırılan aracılar (önizleme)
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ığı

Yanıtlar API'sini kendi kodunuzdan kullanma

Yanıtlar API'si, her ajan türünün arkasındaki tek model ve araçlar uç noktasıdır. Foundry'de aracı kaynağı oluşturmadan Foundry modellerini ve platform araçlarını almak için doğrudan kendi kodunuzdan çağırabilirsiniz. Bu model, Hosted agent’lara alternatif değil, onlara ek olarak sunulur — aynı Agent Framework kodu bugün kendi sürecinizden Responses API’sini çağırabilir ve daha sonra, Foundry tarafından yönetilen bir uç nokta istediğinizde kapsayıcıda barındırılan bir aracı olarak paketlenebilir.

Bkz. Hızlı Başlangıç: Uç nokta seçenekleri ve uçtan uca örnekler için Yanıtlar API'sini kullanma .

Model desteği

Aracı Servisi, Foundry model katalogunda bulunan birçok modelle çalışır. Tam liste için bkz. Kotalar, sınırlar ve bölgesel destek.

Araçları

Aracı Hizmeti yerleşik araçlar sağlar ve aracılarınızın eylemler gerçekleştirebilmesi ve verilere erişebilmesi için özel araçları destekler. Tam liste için bkz Döküm aracı kataloğu. Gelişmiş araç seçim desenleri için bkz. Araç en iyi yöntemleri.

Foundry, Foundry portalındaki Araç Ekle kataloğundan ekleyebileceğiniz uzak MCP sunucularını destekler. Örneğin, Azure DevOps MCP Sunucusu (genel önizleme) doğrudan katalogdan eklenebilir. 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

Araç Kutusu (önizleme)

Toolbox , bir kez seçilmiş bir araç kümesi tanımlamanıza, bunları Foundry'de merkezi olarak yönetmenize ve tek bir MCP uyumlu uç nokta aracılığıyla kullanıma sunmanıza olanak tanır. MCP uyumlu herhangi bir ajan çalışma zamanı veya istemci, kullandığınız çerçeveden bağımsız olarak bir araç kutusunu kullanabilir. Araç kutusu sürümü oluşturma, değişikliklerin ne zaman etkin olduğu üzerinde açık denetim sağlar; yeni bir sürüm oluşturun, test edin ve hazır olduğunuzda varsayılan olarak yükseltin.

Not

Bellek ve web araması gibi bazı araçlar önizleme aşamasındadır. Bölgeye ve önizleme durumuna göre kullanılabilirlik için bkz. Bölgeye ve modele göre araç desteği.

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 — Temsilcilerin oyun alanında temsilcinizle sohbet edin veya yerel olarak ç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 — Aracı izleme ile her model çağrısını, araç çağrısını ve kararı inceleyin.
  4. Evaluate — 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ç nokta ile yönetilen bir kaynağa yükseltin.
  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:

  • Agent identity — 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ğ — Azure sanal ağınızda aracıları etkinleştirerek tam ağ yalıtımını sağlayın ve veri barındırma gereksinimleri ile uyumlu hale getirin. Ö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.
  • Role 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üm oluşturma — Aracınızda çalıştıkça, sürümler otomatik olarak kaydedilmektedir. Ö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ç nokta ile yönetilen bir kaynağa yükseltin. 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.
  • Distribution — Yayımlanan aracıları Microsoft 365 Copilot ve Teams ve Entra Agent Registry aracılığıyla paylaşarak aracılarınızı kullanıcılarınızın zaten çalıştığı yere getirir. 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