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.
Note
.NET için kendi kendine barındırma protokolü yardımcıları yakında kullanıma sunulacaktır. Barındırma modeli, uygulamanızın sunucu, durum ve protokol tümleştirmelerine sahip olmasına izin verir.
Note
Kendi barındırmalı protokol yardımcıları şu anda Go için mevcut değil.
Kendi kendine barındırma, kendi web uygulamanızda, kapsayıcınızda, hizmetinizde veya çalışma zamanınızda bir Agent Framework aracısı veya iş akışı çalıştırmanıza olanak tanır. Uygulamanız yönlendirmeyi, kimliği, yetkilendirmeyi, istek ilkesini, depolamayı, dağıtımı ve ölçeklendirmeyi denetler. Desteklemeniz gereken istemcileri temel alarak bu sunucuya bir veya daha fazla protokol tümleştirmesi ekleyin.
Aracı uç noktasını mevcut uygulama altyapınızla tümleştirmeniz gerektiğinde bu seçeneği kullanın. Microsoft Foundry'nin aracıyı sizin için çalıştırmasını istiyorsanız bkz. Foundry Barındırılan Aracılar. Azure İşlevleri tetikleyicilerine veya kalıcı yürütmeye ihtiyacınız varsa Durable Extension'a bakın.
Bu paketlerin tasarımı, geliştirici için maksimum esneklik sağlayan şekilde tasarlanmıştır. Bu, Responses API ile bir aracıyı sunan bir ana bilgisayar oluşturmak ve parametreleri başka amaçlar için kötüye kullanmak istiyorsanız (yani temperature öğesini top_p öğesine eşlemek), bunu yapabileceğiniz anlamına gelir. Oturumları depolamak istemiyorsanız bunu yapabilirsiniz; çağıran tarafın aracının tüm çalıştırma sürecini kontrol etmesine izin vermek istiyorsanız, bunu da yapabilirsiniz. Önünüze engel çıkarmayacağız; yaygın kullanım senaryoları için yardımcı araçlar sunuyor, geri kalanını ise tam olarak ihtiyaç duyduğunuz host’u oluşturabilmeniz için size bırakıyoruz.
Important
agent-framework-hosting, agent-framework-hosting-responses, agent-framework-hosting-telegram, agent-framework-a2a, , agent-framework-hosting-a2ave agent-framework-hosting-mcp ön sürüm Python paketleridir. Üretim dağıtımını güncelleştirmeden önce yayın öncesi sürümleri açıkça yükleyin ve sürüm notlarını gözden geçirin.
pip install --pre agent-framework-hosting
Barındırma yardımcıları ne sağlar?
Genel barındırma paketi, uygulamaya ait bir sunucu için paylaşılan yürütme durumu sağlar:
-
AgentStatebir aracı hedefini ileSessionStoreeşleştirip uygulama yeni bir anahtar seçtiğinde oturumlar oluşturur. -
SessionStoreuygulama tarafından seçilen bir kimliğe göre oturumları depolar, alır ve siler. Varsayılan deposu işleme özeldir ve bir tahliye politikası yoktur. -
WorkflowStateiş akışı hedeflerini çözümler. Uygulamanız, denetim noktası depolamasından ve bir istemci devam kimliğini denetim noktasına eşleyen tüm eşlemelerden sorumludur.
AgentState bir sunucu veya protokol kayıt defteri değildir. Uygulamanız yetkili bir oturum anahtarı seçer, hedefi çözümler ve çalıştırma sonrası durumunu kaydeder. Bir veya birden çok protokol uç noktası için aynı hedef ve paylaşılan uygulama altyapısını kullanabilir.
Oturum depolama alanını özelleştirme
SessionStore, getve set yöntemleriyle deleteküçük bir zaman uyumsuz depolama sınıfıdır. Varsayılan uygulama oturumları işlem belleğinde tutar. Nesneleri Redis' te, bir veritabanında, blob depolama alanında veya uygulamaya ait başka bir depoda depolamak AgentSession için bu yöntemleri alt sınıflayın ve geçersiz kılın, ardından örneği öğesine AgentState(session_store=...)geçirin.
SessionStore ve geçmiş sağlayıcıları, bir ajan konuşmasının ayrı bölümlerini kalıcı olarak saklar. Oturum deposu, oturum meta verileri ve sağlayıcı durumu dahil olmak üzere oturum kimliği başına bir oturum nesnesi kaydeder. Ayrı bir HistoryProvider, konuşmayı genellikle ileti başına bir kayıt olacak şekilde ayrı depolar. Ayrı iletiler eklemek, her adımın ardından giderek büyüyen bir oturum nesnesini yeniden yazmaktan genellikle daha verimli olduğundan, bu ayrım kalıcı ana bilgisayarlar için önerilir. Her aracı için, istenen geçmiş sağlayıcısı sınıfı context_providers parametresine geçirilerek bir geçmiş sağlayıcısı tanımlanır.
Note
Varsayılan geçmiş sağlayıcısı: InMemoryHistoryProvider özel durumdur: konuşmanın tamamını içinde AgentSession.statedepolar. Bu sağlayıcı kullanıldığında, SessionStore konuşma oturum nesnesinin içinde kalır. Daha uzun konuşmalar veya üretim ortamında depolama için, oturum deposunun hafif oturum durumuna odaklı kalabilmesi amacıyla özel bir geçmiş sağlayıcısı kullanın.
Kendi çerçevenizi veya istemci kitaplığınızı getirme
Barındırma paketleri bir web çerçevesine veya istemci kitaplığına bağlı değildir. Örnekler, yardımcıların bunları gerektirmesinden değil, kısa ve çalıştırılabilir örnekler sunmaları nedeniyle FastAPI ve aiogram kullanır.
- HTTP uç noktaları için FastAPI, Starlette, Django, Flask, Azure İşlevleri veya başka bir çerçeve gibi uygulama çerçevenizin yönlendirme ve istek/yanıt API'lerini kullanın.
- Telegram gibi protokol istemcileri için bir protokol güncelleştirmesi sağlayabilen ve yardımcı tarafından üretilen işlemleri yürütebilen herhangi bir istemci kitaplığını kullanın.
Uygulama çerçevesini ve istemci kitaplığını seçer; Agent Framework paketleri yalnızca protokol verilerini dönüştürür ve isteğe bağlı yürütme durumunu yönetir. Yolları kaydetmez, arayanların kimliğini doğrulamaz, duruma erişimi yetkilendirmez, izin verilen model seçeneklerini belirlemez veya dayanıklı depolama sağlamaz.
Sunucunuza protokol ekleme
Bir veya daha fazla protokol tümleştirmesi seçin:
| Protocol | Paket ve tümleştirme |
|---|---|
| OpenAI Yanıtları | agent-framework-hosting-responses |
| Telgraf | agent-framework-hosting-telegram |
| A2A |
agent-framework-a2a veya agent-framework-hosting-a2a |
| MCP | agent-framework-hosting-mcp |
Her protokol sayfası, kurulumunu açıklar. Ancak, bir veya daha fazla protokolün etkinleştirildiği ve çağrılabilir bir hedefe sahip tek bir ana makine oluşturmanıza olanak verecek şekilde tasarlanmıştır; yani bir aracı ya da iş akışı. Sizi tek bir web çerçevesiyle sınırlamadığımız için istediğiniz web çerçevesini seçebilir ve konağı bu protokollerle kolayca ayarlayabilirsiniz.
Güvenli oturum devamı
Protokol tarafından sağlanan her tanımlayıcıya güvenilmeyen girdi olarak davranın. Oturum, denetim noktası, görev veya başka bir durumu yüklemek için kimlik kullanmadan önce:
- Çağıranın kimliğini doğrula.
- Çağıranın başvurulan duruma erişmesine izin verin.
- Kalıcı durumu kimliği doğrulanmış kiracı, kullanıcı veya çalışma alanına göre bölümlendirin.
- Oturum ve denetim noktası durumunu yalnızca çalıştırma veya akış tamamlandıktan sonra kalıcı hale getirin.
Bu kendi kendine barındırma düzeni, uygulamanızın yalnızca ihtiyaç duyduğu protokol uç noktalarını ve ilkelerini uygulamasına olanak tanır; desteklenen her protokolün tam API yüzeyini uygulamayı denemez.
Sonraki Adımlar
Daha derine gidin: