Microsoft 365 Aracıları SDK'sı nedir?

Microsoft 365 Aracıları SDK'sı, konuşma aracıları oluşturmak için bir geliştirme çerçevesidir. Konuşma aracıları, kullanıcılardan mesaj alabilen, onları işleyen ve yanıt verebilen yazılımlardır. Bunu, bir kullanıcının mesaj göndermesi (ister Teams, ister bir web sitesinde, ister Slack, ister başka bir yerde) ile o mesaja yanıt vermek için oluşturduğunuz mantık arasındaki katman olarak düşünün.

SDK, mesajların farklı platformlarda alınması ve gönderilmesiyle ilgili teknik işlemleri yönetir; böylece geliştiriciler, düşük seviyeli iletişim protokollerine odaklanmak yerine, aracıların ne yaptığına odaklanabilirler.

Desteklenen diller

Agents SDK şunları destekler:

  • C# (.NET 8.0 SDK ile)
  • JavaScript (Node.js 18 ve üzeri sürümlerle)
  • Python 3.9 ile 3.11 arası bir sürüm kullanılarak

Agents SDK'nın çözüm sunduğu üç problem

  • Aracınız birden fazla ortamda çalışmalı. Kullanıcıların hepsi aynı kanaldan iletişim kurmaz. Bazıları Microsoft Teams'i, bazıları Microsoft 365 Copilot'u, bazıları şirket web sitesini, bazıları ise Slack veya Facebook Messenger gibi Microsoft dışı platformları kullanır. Bir framework olmadan, geliştirici her bir platform için ayrı entegrasyon kodu yazmak zorundadır; her birinin kendine özgü mesaj formatı, kimlik doğrulama şeması ve bağlantı protokolü vardır.

    SDK, bir kanal soyutlama katmanı sunar. Aracı mantığınızı bir kez yazarsınız ve SDK, gelen ve giden mesajları her kanalın beklediği formata iki yönlü olarak dönüştürür. Yeni bir kanal eklemek, aracınızın çekirdek davranışını yeniden yazmanızı gerektirmez.

  • Tek bir yapay zeka servisine kilitli kalmak istemezsiniz. Bir aracıı hangi yapay zeka hizmetinin destekleyeceği kararı—ister Azure Yapay Zeka Foundry, OpenAI, Semantik Çekirdek ya da tamamen başka bir şey olsun—ortam geliştikçe ve farklı kullanım senaryoları ortaya çıktıkça sık sık değişir. Belirli bir yapay zeka sağlayıcısını içeren bir aracı çerçevesi, bu seçenek değiştiğinde geliştiricileri kodlarının büyük bölümlerini yeniden yazmaya zorlar.

    SDK tasarımı gereği yapay zeka bağımsızdır. Mesajları almak, durumu yönetmek ve olayları yönlendirmek için altyapı sağlar, ancak yanıtı neyin ürettiği konusunda hiçbir varsayımda bulunmaz. Geliştiriciler tercih ettikleri yapay zeka hizmetlerini veya orkestrasyon kütüphanelerini entegre ederler. SDK bu seçime müdahale etmez.

  • Konuşma durumunu yönetmek zor. Konuşmalar durumsuz değildir. Bir kullanıcı takip sorusu sorabilir, iki tur önce söylenen bir şeye atıfta bulunabilir veya bir konuşmayı bırakıp daha sonra devam edebilir. Bu bağlamı yönetmek, ne olduğunu, nerede saklandığını ve mesajlar arasında nasıl aktığını takip etmek, sıfırdan inşa edildiğinde zahmetli ve hataya açık bir süreçtir.

    SDK, yerleşik durum ve depolama yönetimi sağlar. SDK, bir konuşmadaki tek bir işlem birimi olan 'tur' kavramını tanıtır ve geliştiricilerin kendi kalıcılık katmanlarını kurmalarına gerek kalmadan, turlar arasında durumu izler. Bu, daha az tekrarlayan kod ve konuşma akışı mantığında daha az hata oluşması anlamına gelir.

Nasıl birbirine uyduğunu

Temelde, SDK bir mesaj geldiğinde üç şey yapar:

  1. Hangi kanaldan gelirse gelsin (Teams, web sohbeti, Slack vb.), mesajı alır ve bunu Activity olarak adlandırılan ortak bir formata normalleştirir.

  2. Etkinliği aracı kodunuzdaki uygun işleyiciye yönlendirir. Örneğin, bir mesaj etkinliği bir işleyiciyi tetiklerken, bir kullanıcının konuşmaya katılması başka bir işleyiciyi tetikler.

  3. Yanıtı aynı kanal üzerinden gönderir ve yanıtınızı kanalın beklediği formata dönüştürür.

Geliştiriciler, ilgilendikleri etkinlik türleri için handler'lar yazıyor. SDK, kimlik doğrulama, mesaj formatı çevirisi ve kanal bağlantısı dahil olmak üzere diğer her şeyi yönetir.

Aracılar SDK'sı ne değildir?

Agents SDK bir yapay zeka modeli, bir orkestrasyon motoru veya kodsuz bir oluşturucu değildir. Aracılar SDK'sı bir aracının ne dediğine karar vermez. Bu unsurlar, geliştiricinin aracıya entegre ettiği herhangi bir yapay zeka hizmeti veya iş mantığının işidir. Aracılar SDK'sı, iletileri mantığa ve mantıktan güvenilir bir şekilde ileten, kanallar arasında konuşma durumunu koruyan bir çerçevedir.

Sonraki adımlar

  • Last updated on