Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Foundry Agent Service, yapay zeka aracıları oluşturmaya, dağıtmaya ve ölçeklendirmeye yönelik tam olarak yönetilen bir platformdur. Foundry model kataloğundan herhangi bir çerçeveyi ve birçok model kullanın. Foundry portalında kodsuz istem aracıları oluşturun veya bunların ve Agent Framework, LangGraph ya da kendi kodunuzla oluşturulmuş kod tabanlı Barındırılan aracılar'ın dağıtımını yapmak için kullanılabilen SDK'leri ve REST API'sini kullanın.
Aracı Hizmeti, aracı mantığınıza odaklanabilmeniz için barındırma, ölçeklendirme, kimlik, gözlemlenebilirlik ve kurumsal güvenliği işler.
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. 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 istem tabanlı, iş akışı tanımları veya Barındırılan aracı kodu olabilir.
- Araçlar: Arama, dosya işlemleri veya API çağrıları gibi verilere veya eylemlere erişim sağlayın.
Bir bakışta Aracı Hizmetleri
| Bileşen | Ne yapar? |
|---|---|
| Aracı Çalışma Zamanı | Hem prompt aracılarını hem de host edilen aracıları 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. Altyapı oluşturmadan aracınızın özelliklerini genişletin. Araçlar, hizmet tarafından yönetilen kimlik bilgileri ve Adına (OBO) kimlik doğrulaması dahil olmak üzere yönetilen kimlik doğrulaması sağlar. Azure DevOps MCP Sunucusu (önizleme) gibi bazı MCP sunucuları, kurulum sırasında bir kuruluşa bağlanmayı gerektirir. Erişimin kapsamı, Foundry aracı yapılandırmasıyla belirlenebilir. |
| 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
Ajanları kullanmaya başlamaya hazır mısınız? Nasıl inşa etmek istediğinize bağlı olarak yolunuzu seçin.
- Aracılar için yeni misiniz? Bir istem aracısıyla başlayarak yönergeler ve araçlarla bir aracı oluşturun. Kod gerektirmeden bir tane oluşturmak için Dökümhane portalını veya SDK'ları veya REST API'yi kullanın.
- Bir aracıyı, seçtiğiniz bir çerçeveye sahip bir kapsayıcı olarak dağıtmak mı istiyorsunuz?Agent Framework veya LangGraph ile Barındırılan aracı oluşturun, Bunu Foundry'ye dağıtın ve uçtan uca test edin.
- Birden çok aracıyı düzenlemeyi mi istiyorsunuz?Görsel oluşturucuda aracıları ve iş mantığını düzenlemeye yönelik bir iş akışı oluşturun.
Aracı türleri
Aracı Hizmeti, her biri farklı gereksinimler için tasarlanmış üç aracı türünü destekler:
- Komut Ajanları
- İş akışı aracıları (önizleme)
- Barındırılan aracılar (önizleme)
Komut Ajanları
İstem aracıları tamamen yapılandırmayla tanımlanır; yönergeler, model seçimi ve araçlar. Bunları Foundry portalında veya API veya SDK'lar aracılığıyla oluşturun; Aracı Hizmeti düzenlemeyi ve barındırmayı otomatik olarak işler.
En iyi yöntem: Hızlı prototip oluşturma, iç araçlar ve özel düzenleme mantığı gerektirmeyen aracılar. Portalı kullanarak dakikalar içinde çalışan bir aracı oluşturun.
İş akışı aracıları (önizleme)
İş akışı aracıları , bildirim temelli tanımları kullanarak bir dizi eylem düzenler veya birden çok aracıyı koordine eder. İş akışlarını Dökümhane portalında görsel olarak oluşturun veya Visual Studio Code aracılığıyla YAML'de tanımlayın. İş akışları dallanma mantığını, döngüdeki insan adımlarını ve sıralı veya grup sohbeti desenlerini destekler.
En iyisi: Çok adımlı düzenleme, aracıdan aracıya koordinasyon, onay iş akışları ve özel kod olmadan yinelenebilir otomasyon gerektiren senaryolar.
Barındırılan aracılar (önizleme)
Barındırılan aracılar, seçtiğiniz bir çerçeveyle geliştirilmiş, Aracı Hizmeti'ne kapsayıcı olarak dağıtılan kod tabanlı aracılardır. Düzenleme mantığını (araç çağrıları, çok adımlı mantık, aracıdan aracıya koordinasyon) yazarsınız ve Çalışma zamanını, ölçeklendirmeyi ve altyapıyı Foundry yönetir.
Not
Barındırılan ajanlar şimdi genel önizlemede.
En iyi yöntem: Karmaşık iş akışları, özel araç tümleştirmeleri, çok aracılı sistemler ve aracı davranışı üzerinde tam denetime ihtiyacınız olan senaryolar.
Ajan türlerini karşılaştırın
| Komut Ajanları | İş akışı aracıları | Barındırılan aracılar (önizleme) | |
|---|---|---|---|
| Kod gerekli | Hayır | Hayır (YAML isteğe bağlı) | Evet |
| Barındırma | Tamamen yönetilen | Tamamen yönetilen | Kapsayıcı tabanlı, yönetilen |
| Orkestrasyon | Tek aracı | Çok aracılı, dallanma | Özel mantık |
| En iyi için | Prototip oluşturma, basit görevler | Çok adımlı otomasyon | Tam denetim, özel çerçeveler |
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.
Araç Ekle kataloğu, MCP sunucularını etkinleştirmeye ve aracı için izin verilen araçları seçmeye yönelik giriş noktasıdır.
MCP sunucularını bağlamak 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.
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:
- Oluşturma — Portalda bir istem aracısı tanımlayın veya kodda Barındırılan aracı oluşturun.
- 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ı, izinleri ve davranışı doğrulamak için sohbet istemleri aracılığıyla doğrudan oyun alanında kullanılabilir.
- İzleme — Aracı izleme ile her model çağrısını, araç çağrısını ve kararı inceleyin.
- Evaluate — Kaliteyi ölçmek ve regresyonları yakalamak için değerlendirmeleri çalıştırın.
- Yayımlama — Aracınızı kararlı bir uç nokta ile yönetilen bir kaynağa yükseltin.
- İ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ğ kullanımı, anlık iletim aracıları ve iş akışı aracıları için mümkündür. 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
- Ortamınızı ayarlama
- Ajans geliştirme yaşam döngüsü
- İlk barındırılan aracınızı dağıtın
- Araç kataloğu
- Kotalar, sınırlar ve bölgesel destek
- Yardım almak veya toplulukla bağlantı kurmak için Microsoft AI Discord katılın.