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.
Azure İşlevleri, bulutta barındırılan akıllı uygulamalar oluşturmanıza yardımcı olmak için yapay zeka ve Azure hizmetleriyle tümleşen sunucusuz işlem kaynakları sağlar. Bu makale, işlev uygulamalarınızda kullanabileceğiniz yapay zekâ ile ilgili senaryolara, tümleştirmelere ve kaynaklara genel bir bakış sunar.
İşin nasıl başladığına ve diğer bileşenlerin bunu nasıl kullandığına göre bir entegrasyon seçmek için aşağıdaki tabloyu kullanın:
| Seçenek | En uygun | Çağırma modeli | Dikkat edilmesi gereken temel konular |
|---|---|---|---|
| Azure İşlevleri üzerinde barındırılan beceriler | Olay odaklı iş yüklerine bildirimli talimatlar ve araçlar kullanarak yapay zeka mantığı ekleyin. | Fonksiyon tetikleyicileri veya isteğe bağlı yerleşik HTTP ve MCP uç noktaları | Preview |
| Python için ajan bağlayıcıları | Bir Python işlevine sınırlandırılmış aracı akıl yürütmesi ekleyin ve doğrulama, dallanma, hatalar ve çıktılar üzerinde kod güdümlü kontrolü koruyun. | Standart bir Fonksiyonlar tetikleyicisi, enjekte edilen Microsoft Agent Framework Agent nesnesini çağıran Python kodunu çağırır |
Önizleme; Sadece Python |
| Model Bağlam Protokolü (MCP) uç nokta uygulamaları | Microsoft Foundry ajanlarına ve diğer MCP istemcilerine senkronize, yeniden kullanılabilir araçları açığa çıkarın. | Akışlı HTTP | Barındırılan beceriler, genel kullanıma sunulan MCP uzantısı ve SDK tabanlı önizleme barındırması arasından seçim yapabilirsiniz. |
| Kuyruk tabanlı Azure İşlevleri araçları | Microsoft Foundry ajanları için asenkron arka plan araçlarını çalıştırın. | Azure Kuyruk Depolama giriş ve çıkış kuyrukları | Foundry’ye özel; standart kurulumlu bir Foundry aracısı gerektirir. |
| Aracı iş akışları | Yeniden başlatma ve beklemeye dayanması gereken uzun süreli veya çok adımlı yapay zeka çalışmalarını koordine edin. | Uygulama olaylarıyla başlatılan dayanıklı orkestrasyonlar | Doğrudan Dayanıklı İşlevler orkestrasyonunu veya barındırılan becerilere dayalı dinamik iş akışlarını seçin. |
Bu makale dile özgüdür, bu nedenle sayfanın üst kısmında programlama dilinizi seçtiğinizden emin olun.
Azure İşlevleri'ta barındırılan beceriler
Azure İşlevleri hosted skills, Azure İşlevleri üzerinde bulut barındırıcılı, olay odaklı akıllı yetenekler oluşturmak için bir programlama modelidir. Davranışı Markdown, doğal dil talimatları ve deklaratif yapılandırma ile tanımlarsınız. Çalışma zamanı, .agent.md dosyalarını algılar, tetikleyicileri ve uç noktaları kaydeder ve olaylar meydana geldiğinde barındırılan becerileri çalıştırır.
Important
Azure İşlevleri tarafından barındırılan beceriler şu anda önizleme sürümündedir. Özellikler, yapılandırma adları ve desteklenen bağlayıcılar genel kullanılabilirlik öncesinde değişebilir.
Barındırılan bir yetenek tanımlamak için Python kodu yazmanıza gerek yok. Davranışlarını, tetikleyicilerini ve yapılandırılmış araçları Markdown ve yapılandırma dosyalarında tanımlıyorsunuz. Bu yapılandırılmış yeteneklerin ötesinde özel uygulama mantığına ihtiyacınız varsa, özel Python araçları ekleyebilirsiniz.
HTTP isteği, zamanlama, mesaj, veri değişikliği, yönetilen bir bağlayıcıdan gelen bir olay veya başka bir olaya yanıt olarak olay odaklı bir uygulamaya akıllı davranış eklemek istediğinizde Azure İşlevleri hosted skills kullanın. Ayrıca, barındırılan her beceriyi diğer uygulamalar, ajanlar veya ajan çatıları için yapay zeka destekli bir araç olarak sunan isteğe bağlı yerleşik MCP uç noktasını etkinleştirebilirsiniz.
Başlamak için şu makalelere bakın:
- Genel Bakış: Azure İşlevleri tarafından barındırılan beceriler
- Başlayın: Azure İşlevleri barındırılan becerilerle olay odaklı bir yapay zeka uygulaması oluşturun
- Başvuru: Azure İşlevleri üzerinde barındırılan beceriler yapılandırması
Python için aracı bağlayıcıları
Important
Python fonksiyon uygulamaları için ajan bağlamaları şu anda önizleme aşamasında. Özellikler, paket isimleri ve yapılandırma genel erişilebilirlikten önce değişebilir.
Ajan bağlamaları, standart bir Python fonksiyon çağrısına yapılandırılmış bir Microsoft Agent Framework Agent nesnesi ekler. Fonksiyon, tetikleyicisini ve deterministik uygulama mantığını kontrol eder ve yöneticisi, Ajan'ı ne zaman, ne zaman ve nasıl çağıracağına karar verir.
Python işlevi birincil yürütme modeli olduğunda ve Ajanın akıl yürütmesi işlevinin yalnızca sınırlı bir bölümünü oluşturduğunda Ajan bağlayıcılarını kullanın. Uygulamanın birincil yürütme modeli bildirim temelli olarak tanımlanmış bir barındırılan beceri ise bunun yerine Azure İşlevleri tarafından barındırılan becerileri kullanın. Kodunuz tüm Ajan yaşam döngüsünü kontrol etmek zorunda olduğunda, yapılandırmalı bir Ajan almak yerine doğrudan Microsoft Agent Framework SDK'sını kullanın.
Ajan bağlamaları ayrıca Dayanıklı İşlevler orkestrasyonlarından gelen tekrar oynatılabilir Ajan çağrılarını destekler. Daha fazla bilgi edinmek ve başlamak için Azure İşlevleri'ta Agent bindings for Python bölümüne bakabilirsiniz.
Araçlar ve MCP sunucuları
Yapay zeka modelleri ve aracıları, araç olarak bilinen dış kaynakları istemek için işlev çağrısını kullanır. Fonksiyon çağrısı kullanılarak, modeller ve ajanlar bir konuşma veya görevin bağlamına göre belirli işlevleri dinamik olarak çağırabilirler.
İşlevler, talebi işlemek için verimli bir şekilde ölçeklendirildiğinden ve aracıları uzak Azure hizmetleriyle bağlamayı basitleştiren binding uzantıları sağladığından, aracı iş akışlarında işlev çağrısı uygulamak için özellikle uygundur. İşlevler'de yapay zeka araçları oluştururken veya barındırırken sunucusuz fiyatlandırma modelleri ve platform güvenlik özellikleri de elde edersiniz.
MCP, uzak sunucularla etkileşimde endüstri standardıdır. Yapay zeka modellerinin ve aracılarının dış sistemlerle iletişim kurması için standartlaştırılmış bir yol sağlar. Bir MCP sunucusu kullanarak, bu yapay zeka istemcileri harici bir sistemin araçları ve yeteneklerini verimli bir şekilde belirleyebilir.
Azure İşlevleri şu anda aşağıdaki araç türlerini kullanarak işlev kodunuzun açığa çıkartılması destekleniyor:
| Araç türü | Açıklama |
|---|---|
| Barındırılan beceriler için yerleşik MCP uç noktası | Yerleşik bir MCP uç noktası aracılığıyla yapay zeka akıl yürütmeyi araç olarak uygulayan barındırılan becerileri ortaya çıkarın. |
| Uzak MCP sunucusu | Senkron araç çağrıları için deterministik MCP araçları oluşturun veya SDK tabanlı MCP sunucuları barındırın. |
| Queue tabanlı Azure İşlevleri aracı | Mesaj kuyrukları üzerinden asenkron fonksiyon çağrısı için Microsoft Foundry'ye özgü aracı kullanın. |
MCP uç noktasını nasıl açığa çıkaracağınızı seçin
Functions, MCP üzerinden açığa çıkarma yetenekleri için şu seçenekleri destekler:
- Azure İşlevleri üzerinde barındırılan becerilere yönelik,
.agent.mddosyalarında tanımlanan yapay zeka destekli araçları kullanıma sunmak için yerleşik MCP uç noktasını etkinleştirin. Barındırılan beceriler şu anda ön izleme aşamasında. - MCP bağlama uzantısını kullanarak deterministik MCP araçlarını oluşturup barındırabilirsiniz, diğer herhangi bir fonksiyon uygulaması gibi.
- Resmi MCP SDK'ları kullanılarak oluşturulan kendi kendine barındıran MCP sunucuları. Bu barındırma seçeneği şu anda önizleme aşamasındadır.
İşte Functions tarafından sağlanan mevcut MCP uç nokta seçeneklerinin karşılaştırması:
| Özellik | Barındırılan beceriler için yerleşik MCP uç noktası | MCP bağlama uzantısı | Kendi kendine barındırılan MCP sunucuları |
|---|---|---|---|
| En uygun | Yapay zeka destekli barındırılan bir beceriyi MCP aracı olarak sunun. | Fonksiyon tetikleyicileri ve bağlayıcılarıyla deterministik MCP araçları oluşturun. | Resmi bir MCP SDK ile oluşturulmuş mevcut bir sunucuyu barındırın. |
| Geçerli destek düzeyi | Preview | Genel kullanıma sunuldu | Önizleme* |
| Programlama modeli |
.agent.md barındırılan beceri |
İşlev tetikleyicileri ve bağlamaları | Standart MCP SDK'ları |
| Durumlu yürütme | Oturum geçmişi destekleniyor | Destekleniyor | Şu anda desteklenmiyor |
| Özel kod dilleri | Python (isteğe bağlı özel araçlar) | C# (yalıtılmış işlem) Python TypeScript JavaScript Java |
C# (yalıtılmış işlem) Python TypeScript Java |
| Barındırma planı | Esnek Tüketim Premium Özel (App Service) |
Desteklenen Azure İşlevleri hosting planları | Sadece Flex Tüketimi |
| Diğer gereksinimler | Barındırılan beceride builtin_endpoints.mcp öğesini etkinleştirin |
Hiç kimse | Akışlanabilir HTTP taşıması kullanan durumsuz sunucu |
| Nasıl uygulanır? | hosted-skills çalışma zamanındaki yerleşik MCP uç noktası | MCP bağlama uzantısı | Özel işleyiciler |
*Yerel olarak barındırılan MCP sunucuları için yapılandırma ayrıntıları önizleme sırasında değişir.
Fonksiyonlarda uzak MCP sunucularına başlamak için aşağıdaki dile özgü kaynakları kullanın:
C# için, MCP uzantısı ve SDK tabanlı barındırma için bu kaynakları karşılaştırın:
| Options | MCP bağlama uzantısı | Kendi kendine barındırılan MCP sunucuları |
|---|---|---|
| Documentation | MCP bağlama uzantısı | Uygulanamaz |
| Samples | Uzak özel MCP sunucusu | Weather sunucusu |
| Şablonlar | HelloTool | Uygulanamaz |
Python için, MCP uzantısı ve SDK tabanlı barındırma için bu kaynakları karşılaştırın:
| Options | MCP bağlama uzantısı | Kendi kendine barındırılan MCP sunucuları |
|---|---|---|
| Documentation | MCP bağlama uzantısı | Uygulanamaz |
| Samples | Uzak özel MCP sunucusu | Weather sunucusu |
TypeScript için, MCP uzantısı ve SDK tabanlı barındırma için bu kaynakları karşılaştırın:
| Options | MCP bağlama uzantısı | Kendi kendine barındırılan MCP sunucuları |
|---|---|---|
| Documentation | MCP bağlama uzantısı | Uygulanamaz |
| Samples | Uzak özel MCP sunucusu | Weather sunucusu |
JavaScript için MCP uzantı kaynaklarını kullanın. SDK tabanlı barındırma destekleniyor, ancak şu anda JavaScript hızlı başlatma mevcut değil.
| Options | MCP bağlama uzantısı | Kendi kendine barındırılan MCP sunucuları |
|---|---|---|
| Documentation | MCP bağlama uzantısı | Uygulanamaz |
| Samples | Henüz kullanılamıyor | Henüz kullanılamıyor |
Java için MCP uzantı dokümantasyonunu kullanın. Dile özgü örnekler şu anda mevcut değil.
| Options | MCP bağlama uzantısı | Kendi kendine barındırılan MCP sunucuları |
|---|---|---|
| Documentation | MCP bağlama uzantısı | Uygulanamaz |
| Samples | Henüz kullanılamıyor | Henüz kullanılamıyor |
PowerShell şu anda her iki MCP sunucusu barındırma seçeneği için de desteklenmiyor.
Microsoft Foundry Agent Service için kuyruk tabanlı Azure İşlevleri araçlarını seçin
Microsoft Foundry Agent Service ayrıca asenkron fonksiyon çağrısı için Azure İşlevleri'a özgü bir araç da sunar. Ajan, bir isteği Azure Kuyruk Depolama giriş kuyruğuna yerleştirir. Kuyruk tetikleyici bir fonksiyon isteği işler ve sonucu çıktı kuyruğu üzerinden döndürür.
Anında yanıt gerektirmeyen ve güvenilir mesaj teslimi ile yeniden denemelerden faydalanan arka plan işlemleri için Foundry’ye özel bu entegrasyonu kullanın. Eşzamanlı etkileşimler veya diğer yapay zeka istemcileriyle yeniden kullanmak istediğiniz araçlar için MCP sunucusu kullanın.
Kuyruk tabanlı Azure İşlevleri araçları, standart kuruluma sahip bir Foundry ajanı gerektirir. Desteklenen SDK'ları incelemek ve bir araç oluşturmak için Use Azure İşlevleri with Foundry Agent Service bölümüne bakınız.
Aracı iş akışları
Uygulama kodunuz güvenilir bir ajan, model çağrısı, onay ve diğer işler dizisini tanımladığında Dayanıklı İşlevler'u kullanın. Dayanıklı İşlevler, bekleme ve yeniden başlatma arasında orkestrasyon durumunu korur ve fonksiyon zincirleme, fan-out/fan-in ve insan etkileşimi gibi yaygın kalıpları destekler.
Azure İşlevleri barındırılan beceriler kullanıyorsanız, dinamik iş akışları bir önizleme seçeneği sunar; bu yöntemde bir model aracı çağrıları, alt ajan görevleri ve beklemelerden oluşan yapılandırılmış bir plan oluşturur. Hosted-skills çalışma zamanı, bu planı bir Dayanıklı İşlevler orkestrasyonu olarak yürütür. İş tek bir etkileşimde tamamlanabiliyorsa doğrudan araç çağrısı kullanın; işin tek bir etkileşimin ötesine geçmesi, paralel dallanması, beklemesi veya yeniden başlatmalardan etkilenmeden sürmesi gerekiyorsa dinamik bir iş akışı kullanın.
| Seçenek | İş akışını kim tanımlıyor | En uygun | Dikkat edilmesi gereken temel konular |
|---|---|---|---|
| Direct Dayanıklı İşlevler orkestrasyonu | Uygulama kodu | Açık kontrol akışı, yeniden denemeler, beklemeler ve onaylarla öngörülebilir iş akışları | Diliniz için Dayanıklı İşlevler programlama modelini kullanın. |
| Barındırılan beceri dinamik iş akışı | yapay zekâ modeli | Araç çağrılarını, alt ajan görevlerini, beklemeleri ve çalışma zamanında yayılmayı planlayan uyarlanabilir iş akışları | Önizleme; Azure İşlevleri tarafından barındırılan beceriler gerektirir. |
Uygulama rehberliği için Uygulama kalıpları ve Dinamik iş akışları oluştur ve çalıştır bölümlerine bakabilirsiniz.
Azure İşlevleri için yapay zeka araçları ve çerçeveleri
Functions ile tercih ettiğiniz dilde uygulamalar oluşturabilir ve favori kütüphanelerinizi kullanabilirsiniz. Bu esneklik nedeniyle yapay zeka özellikli işlev uygulamalarınızda çok çeşitli yapay zeka kitaplıkları ve çerçeveleri kullanabilirsiniz.
Bu Microsoft yapay zeka platformları ve çerçeveleri farklı uygulama mimarilerini destekler:
| Platform veya çerçeve | En uygun | Azure İşlevleri ile nasıl çalışır |
|---|---|---|
| Microsoft Agent Framework | Uygulamanızda çalışan kod-öncelikli ajan mantığı ve iş akışları | Framework SDK'larını fonksiyon kodunuzda çalıştırın. |
| Microsoft Foundry Agent Service | Functions tarafından barındırılan araçları kullanan yönetilen ajanlar | Barındırılan bir hizmet olarak ajanlar oluşturun ve yönetin. Foundry ajanları, MCP, kuyruklar veya OpenAPI üzerinden Fonksiyonlar tarafından barındırılan araçları çağırabilir. |
| Microsoft Foundry SDK'leri | Yönetilen bir ajan gerektirmeyen doğrudan model ve hizmet çağrıları | Foundry modelleri ve hizmetlerini doğrudan fonksiyon kodunuzdan çağırın. |
Functions'ta uygulamalarınız üçüncü taraf kütüphanelere ve çerçevelere de referans verebilir, böylece tüm favori yapay zeka araçlarınızı ve kütüphanelerinizi yapay zeka özellikli fonksiyonlarınızda kullanabiliyorsunuz.