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.
Önemli
Microsoft Agent 365'e erken erişim elde etmek için Frontier önizleme programının bir parçası olmanız gerekir. Frontier sizi Doğrudan Microsoft'un en son yapay zeka yenilikleri ile bağlar. Sınır önizlemeleri, müşteri sözleşmelerinizin mevcut önizleme koşullarına tabidir. Bu özellikler hala geliştirme aşamasında olduğundan, bunların kullanılabilirliği ve özellikleri zaman içinde değişebilir.
Microsoft Agent 365 SDK'sı, kurumsal düzeyde kimlik, gözlemlenebilirlik, araçlar ve idare ile herhangi bir aracı yığını üzerinde oluşturulmuş mevcut yapay zeka aracınızı genişletir.
Agent 365 SDK ile geliştiriciler isteğe bağlı olarak üretkenlik uygulamalarından gelen bildirimleri almak ve yanıtlamak için Aracı Kimliği'ni kullanabilir. SDK ayrıca aracıların Microsoft'tan yönetilen ve gözlemlenebilir Model Bağlam Protokolü (MCP) sunucularını çağırmasına da olanak tanır. Ayrıca aracılar, BT yöneticilerine aracı işlevselliği ve performansı hakkında içgörüler sağlamak için telemetri yayımlayabilir.
Aracı 365 SDK nedir?
Agent 365 SDK, aracıları mevcut iş akışlarına sorunsuz bir şekilde sığacak şekilde genişleten ve gerektiğinde bağımsız olarak çalışmaya devam eden kapsamlı bir yazılım geliştirme setidir. Aracılar benzersiz kimliklere sahip olabilir; yaygın hareketler kullanılarak çağrılabilir (örneğin @mentions) , kullanıcıların genellikle içinde çalıştığı uygulamalarda (Teams, Word, Outlook vb.), gözlemlenebilir davranışlar gösterir, güven oluşturur, denetlenebilir eylemler gerçekleştirir ve araçlara ve verilere güvenli erişim yoluyla bunların tümünü elde eder.
Aracı Kimliği, yöneticiye geçitli, izlenen erişim denetimi sağlarken aracıya başarılı olması için gereken gücü sağlamaya devam eder. Aracılar, alma işlemi aracılığıyla bir kimlik alır. Geliştirme yaşam döngüsü sırasında geliştiriciler, Agent 365 CLI kullanarak gerekli MCP sunucularıyla bir Microsoft Entra App Blueprint alabilir ve bu şemadan oluşturulan tüm aracı örnekleri için şablon oluşturabilir.
Bildirimler sayesinde aracıların etkileşim desenlerini bir insana yaklaştırıyoruz. Aracılar, Teams gibi üretkenlik uygulamalarındaki veya Word'deki yorumlardaki kullanıcılara bağlam içinde yanıt verebilir. Aracılar, aracının posta kutusuna gönderilen ve aracı tarafından barındırılan bir bildirim uç noktasına teslim edilen e-postaları da yanıtlayabilir. Aracı ayrıca Alma ve Sorgulamayı Kaldırma gibi yaşam döngüsü işlemlerine katılabilir ve aracı kimliği için bu süre boyunca kurulum ve temizleme döngüleri yapmayı seçebilir.
Açık Telemetri üzerine kurulu ve tümleştirilmiş olan Agents 365 SDK'sı, çıkarım olayları, araç kullanımı ve bildirimler de dahil olmak üzere her aracının etkinliği için ayrıntılı telemetriyi yakalar. Yöneticiler, Purview ve Defender kullanarak aracıların nasıl çalıştığına ve kullanıcılar, sistemler ve verilerle nasıl etkileşime girdiğine ilişkin tam görünürlük elde eder.
Aracılar, e-posta gönderme, SharePoint'te belgeleri bulma ve belgedeki açıklamaları Aracı kodunda en az değişiklikle yanıtlama gibi çeşitli senaryoları gerçekleştirmek için Microsoft MCP sunucularını kullanabilir. Yöneticiler bu MCP sunucularını yönetir ve araçların büyüyen listesi, aracının üretkenlik alanında başarılı olmasını sağlar.
Agent 365; Microsoft Agent Framework, Copilot Studio, Azure AI Foundry, Semantic Kernel, OpenAI Agents SDK, Claude Code SDK ve LangGraph üzerinde oluşturulmuş aracılarla çalışır.
Aracı 365 SDK'sının farkı nedir?
- Aracı 365 SDK'sı bir aracı yığını değildir. Aracı oluşturmanın veya barındırmanın yolu değildir ve Microsoft Agent Framework, Microsoft Copilot Studio veya Microsoft Foundry'nin aksine herhangi bir düzenleyici veya iş akışı yönetimiyle birlikte gelmez.
- Microsoft 365 Aracı SDK'sının ve barındırma, etkinlik protokolü ve kimlik için sağladığı işlevselliğin yerini almaz. Tam tersine, Aracı 365 SDK'sı Etkinlik protokolü aracılığıyla bildirim göndermek için Microsoft 365 Aracı SDK'sına yönelik paketleri kullanır ve uygun olduğunda aracı için Aracı Kimliği paketlerini kullanır.
- Agent 365, geliştiricilerden seçtikleri bir aracı çerçevesinden mevcut bir aracıyla başlamalarını ister. Daha sonra aracılarını, aracılarını dijital dünyada yönetilebilir, gözlemlenebilir ve daha üretken hale getiren daha fazla işlevsellik sağlayacak şekilde genişletebilirler.
Aracı 365'te bir aracının şemasını anlama
Aracınızın bir örneğini oluşturmadan önce, Aracı 365 aracısının şemasıyla ne demek istediğimizi anlamanız yararlı olur. Şema, tüm uyumlu aracıların oluşturulduğu kurumsal "şablon" olan bir aracı türünün BT onaylı, önceden yapılandırılmış tanımıdır. Aracının özelliklerini, gerekli MCP aracı erişimini, güvenlik ve uyumluluk kısıtlamalarını, denetim gereksinimlerini, yaşam döngüsü meta verilerini ve DLP, dış erişim kısıtlamaları veya günlük kuralları gibi bağlı idare ilkesi şablonlarını tanımlar. Şema etkinleştirildiğinde hirable olur, yani yöneticiler bu şemadan Microsoft 365 Yönetici Merkezi'nde yeni aracılar oluşturabilir. Her aracı örneği şemanın kurallarını devralarak posta, takvim, Teams mesajlaşması, SharePoint erişimi ve aracının dokunduğu diğer Microsoft 365 iş yükleri arasında tutarlı bir idare sağlar. Bu, "gölge aracıları" önler, gözlemlenebilirliği zorlar ve her aracıyı güvenli bir Entra-backed kimlik ve izin modeline sabitler.
Aracı 365 Aracı SDK paketleri
Desteklenen diller için paket yöneticilerinde Agent 365 Aracı SDK paketlerini bulun.
Python için Agent 365 Aracı SDK paketleri Python Paket Dizini'nde (PYPI) bulunur
| Paket | Description |
|---|---|
| microsoft-agents-a365-notifications | Yapay zeka aracısı uygulamaları için bildirim ve mesajlaşma uzantıları. Microsoft 365 uygulamalarında aracı bildirimlerini, yaşam döngüsü olaylarını ve farklı kanallar ve alt kanallar arasında yönlendirmeyi işlemek için yardımcı programlar sağlar. |
| microsoft-agents-a365-observability-core | OpenTelemetry üzerinde oluşturulan yapay zeka aracıları için telemetri, izleme ve izleme bileşenleri. Bağlam yayma ve eklenebilir dışarı aktarıcılarla aracı çağırma, araç yürütme ve LLM çıkarımı için yapılandırılmış aralıklar sağlar. |
| microsoft-agents-a365-observability-extensions-agent-framework | Microsoft Agent Framework için gözlemlenebilirlik uzantıları. Özel olarak Agent Framework tabanlı uygulamalar için OpenTelemetry izleme tümleştirmesi sağlar. |
| microsoft-agents-a365-observability-extensions-openai | OpenAI Aracıları SDK'sı için gözlemlenebilirlik uzantıları. Aracı iş akışları ve araç çağrıları için otomatik izleme ile OpenAI Aracıları tabanlı uygulamalar için OpenTelemetry izleme tümleştirmesi sağlar. |
| microsoft-agents-a365-observability-extensions-langchain | LangChain çerçevesi için gözlemlenebilirlik uzantıları. Zincirler, aracılar ve araçlar için otomatik izleme ile LangChain tabanlı yapay zeka uygulamaları için OpenTelemetry izleme tümleştirmesi sağlar. |
| microsoft-agents-a365-observability-extensions-semantic-kernel | Anlam Çekirdeği çerçevesi için gözlemlenebilirlik uzantıları. Semantik Çekirdek tabanlı uygulamalar için çekirdek işlevleri, eklentiler ve planlayıcılar için otomatik izleme ile OpenTelemetry izleme tümleştirmesi sağlar. |
| microsoft-agents-a365-runtime | Yapay zeka aracısı uygulamaları için temel çalışma zamanı yardımcı programları ve ortam yönetimi. Temel Power Platform API'sini bulma, ortam yapılandırması ve kimlik doğrulama kapsamı çözümlemesi sağlar. |
| microsoft-agents-a365-tooling | Microsoft Agent 365 SDK ile oluşturulan uygulamalarda MCP (Model Bağlam Protokolü) araç sunucusu yönetimi için temel araç işlevselliği. Farklı yapay zeka çerçevelerinde araç sunucularını bulma, kaydetme ve yönetme için temel sağlar. |
| microsoft-agents-a365-tooling-extensions-agentframework | AI aracısı geliştirme için Agent Framework'e özgü araçlar ve hizmetler. Aracı Çerçevesi aracılarına dinamik olarak MCP sunucuları eklemek için MCP (Model Bağlam Protokolü) araç kayıt hizmeti sağlar. |
| microsoft-agents-a365-tooling-extensions-openai | Yapay zeka aracısı geliştirme için OpenAI Aracıları SDK'sına özgü araçlar ve hizmetler. OPENAI Aracıları SDK tabanlı aracılara dinamik olarak MCP sunucuları eklemek için MCP (Model Bağlam Protokolü) araç kayıt hizmeti sağlar. |
| microsoft-agents-a365-tooling-extensions-semantickernel | Yapay zeka aracısı geliştirme için Semantik Çekirdek'e özgü araçlar ve hizmetler. AnlamSal Çekirdek tabanlı aracılara dinamik olarak MCP sunucuları eklemek için MCP (Model Bağlam Protokolü) araç kayıt hizmeti sağlar. |
| microsoft-agents-a365-tooling-extensions-azureaifoundry | Yapay zeka aracısı geliştirme için Azure AI Foundry'ye özgü araçlar ve hizmetler. McP sunucularını Azure AI Foundry aracılarına dinamik olarak eklemek için MCP (Model Bağlam Protokolü) araç kayıt hizmeti sağlar. |
Aracı 365 Aracısı'nın üst düzey akışı
Aşağıdaki diyagramda aracılar için geliştirici akışı gösterilmektedir
Programlama dilini ve tercih ettiğiniz aracı çerçevesini kullanarak önceden oluşturduğunuz bir aracıyla başlarsınız. Daha sonra aracı 365 SDK'sını kullanarak önceden oluşturduğunuz aracıları genişletebilir ve platformda çalıştırmak için ihtiyaç duydukları bildirimler, gözlemlenebilirlik ve araç sunucusu bağlantıları gibi özel özellikleri ekleyebilirsiniz. Mevcut aracıların nasıl yapılandırıldığına ilişkin örnekler istiyorsanız, hızlı başlangıçlar VS Code için Microsoft 365 Aracılar Araç Seti'nde yer alan örnek aracılar konusunda size yol gösterir. Örnekler için kullanılabilir Agent 365 hızlı başlangıçlarına bakın:
- Hızlı Başlangıç: JavaScript LangChain örnek aracısını ayarlama ve çalıştırma
- Hızlı Başlangıç: Python Aracısı çerçeve örnek aracısını ayarlama ve çalıştırma
- Hızlı Başlangıç: JavaScript Claude Aracısı SDK örnek aracısını ayarlama ve çalıştırma
GitHub örneklerinde sağlanan desenleri kullanarak aracınızın hangi Microsoft MCP sunucularına bağlı olduğunu belirler, bu bağlantıları yapılandırabilir ve Agent 365 bileşenlerini (gözlemlenebilirlik, bildirimler ve araç sunucusu bağlantıları) tümleştirebilirsiniz.
Bundan sonra, aracınızın nasıl temsil edilir ve platforma nasıl bağlandığını tanımlayan bir Agent 365 şeması oluşturun. Şemayı yerleştirerek aracınızı Agents Playground'da test edin. Bu size bildirimleri doğrulamanız, MCP etkileşimlerini denemeniz ve herhangi bir yere dağıtmadan önce telemetri verilerini incelemeniz için bir alan sağlar.
Her şey iyi göründüğünde, aracınızı bir kiracıda yayımlayın. Buradan, yöneticiler Microsoft 365 yönetim merkezi etkinleştirebilir ve yönetebilir.
Aracı 365 SDK'sı ne zaman gerekiyor?
Aşağıdaki durumlarda Agent 365 SDK'sını kullanın:
- Güvenli MCP bağlayıcıları aracılığıyla Microsoft 365 verileri veya araçlarıyla tümleştirme
- Kuruluşunuz genelinde birden çok aracıyı yönetme ve denetleme
- Kurumsal düzeyde telemetri ve izleme sağlama
- Aracı etkileşimleri için bildirimleri etkinleştirme
- İzlenebilirlik ve yaşam döngüsü yönetimi gerektiren düzenlenmiş ortamlarda dağıtma
Agent 365 SDK'sı aracı ekosistemine nasıl uyum sağlar?
| Katman | Role | Sağlayan |
|---|---|---|
| Kurumsal Özellikler | Kimlik, bildirimler, gözlemlenebilirlik, araçlar | Aracı 365 SDK |
| Aracı Mantığı | İstemler, iş akışları, akıl yürütme | Hızlı uygulama |
| Orchestrator Çalışma Zamanı | Model çağırma ve araç düzenleme | Seçtiğiniz çerçeve |
Bir bakışta avantajlar
- Tüm aracılar arasında birleşik kimlik ve idare
- Hazır telemetri ve izleme
- Microsoft 365 araçlarına güvenli ve yönetilen erişim
- Çapraz düzenleyici ve çoklu bulut desteği
- Mevcut aracılar için basitleştirilmiş yükseltme yolu