Work IQ ve M365 Agents Toolkit: Terminal'den Microsoft 365 Copilot Ajanı Geliştirme

Terminal'den Ajan Geliştirme Vizyonu

Microsoft 365 Copilot ekosisteminde ajan geliştirme süreci, geleneksel olarak birden fazla araç, portal ve yapılandırma adımı gerektiriyordu. Geliştiriciler; VS Code'da proje oluşturma, JSON manifest düzenleme, API plugin yapılandırma, test ve dağıtım arasında sürekli bağlam değiştirmek zorunda kalıyordu.

Microsoft, bu sorunu Work IQ ve Microsoft 365 Agents Toolkit plugin'inin birleşimiyle çözüyor. Work IQ, AI asistanlarınızı Microsoft 365 verilerinize bağlayan bir CLI ve MCP Server sunuyor. M365 Agents Toolkit plugin'i ise GitHub Copilot CLI ve Claude Code üzerinden doğal dille declarative agent geliştirme, yapılandırma ve dağıtım işlemlerini mümkün kılıyor.

Sonuç: üç skill, tek kurulum, sıfır bağlam değiştirme — fikirden dağıtılmış ajana en hızlı yol.

Work IQ Nedir?

Microsoft Work IQ, AI asistanlarınızı Microsoft 365 Copilot verilerinize bağlayan bir komut satırı arayüzü (CLI) ve Model Context Protocol (MCP) sunucusudur. Doğal dil kullanarak e-postalarınızı, toplantılarınızı, belgelerinizi, Teams mesajlarınızı, kişi bilgilerinizi ve iş yeri içgörülerinizi sorgulayabilirsiniz.

Desteklenen Veri Türleri

Veri Türü	Örnek Sorgular
E-postalar	"John proje teslim tarihi hakkında ne dedi?"
Toplantılar	"Yarın takvimimde ne var?"
Belgeler	"Son PowerPoint sunumlarımı bul"
Teams mesajları	"Mühendislik kanalındaki bugünkü mesajları özetle"
Kişiler	"Proje Alpha üzerinde kim çalışıyor?"

Nasıl Çalışır?

Work IQ iki modda çalışır:

CLI Modu: Terminal'den doğrudan workiq ask komutuyla sorgular çalıştırabilirsiniz. Etkileşimli modda ardışık sorular sorarak derinlemesine araştırma yapabilirsiniz. MCP Server Modu: GitHub Copilot (VS Code veya CLI) ve diğer AI asistanlarla entegre olarak, kodlama asistanınızın Microsoft 365 verilerinize bağlamsal olarak erişmesini sağlar. Örneğin, yakın zamanda bir toplantıda tartışılan bir özelliği uygularken, AI asistanınız toplantı notlarına erişerek daha ilgili öneriler sunabilir ve uygulamayı başlatabilir.

Work IQ Eklentileri

Work IQ, GitHub Copilot CLI plugin pazaryeri üzerinden üç ana eklenti sunar:

Eklenti	Açıklama
workiq	Microsoft 365 verilerini sorgulayan ask_work_iq MCP aracı
microsoft-365-agents-toolkit	Declarative agent iskeletleme, manifest yazma, yetenek yapılandırma ve dağıtım araç seti
workiq-productivity	Salt okunur iş yeri içgörüleri: aksiyon öğesi çıkarma, e-posta analitiği, toplantı maliyet hesaplama, kanal denetimi

M365 Agents Toolkit Plugin

M365 Agents Toolkit plugin'i, Work IQ eklentileri arasında özellikle dikkat çekici olanıdır. GitHub Copilot CLI ve Claude Code üzerinden doğal dil kullanarak Microsoft 365 Copilot declarative agent'ları geliştirmek, yapılandırmak ve dağıtmak için tasarlanmıştır.

Üç Skill

Declarative Agent Developer: Proje iskeletleme, JSON manifest yazma, API plugin ekleme, MCP server bağlama, yetenekleri yapılandırma ve dağıtım — tüm bunlar doğal dil komutlarıyla gerçekleştirilir. "İK SSS için yeni bir declarative agent iskeletle", "Ajanıma web arama ekle" veya "Ajanımı dağıt" gibi komutlar yeterlidir. UI Widget Developer: MCP Apps ve OpenAI Apps SDK kullanarak, Copilot Chat içinde doğrudan render edilen zengin etkileşimli widget'lara sahip MCP sunucuları oluşturur. Dashboard'lar, formlar, görselleştirmeler ve çok adımlı iş akışları gibi etkileşimli bileşenler, sohbet içinde doğrudan kullanılabilir. Install ATK: Agents Toolkit CLI ve VS Code uzantısını saniyeler içinde kurar. Geliştirme ortamını hızlıca hazır hale getirir.

Doğal Dil ile Ajan Geliştirme İş Akışı

Geleneksel ajan geliştirme sürecinde, geliştiriciler JSON dosyalarını elle düzenler, yapılandırma adımlarını belgelere bakarak takip eder ve her değişiklik için test döngüsüne girerdi. M365 Agents Toolkit plugin'i bu süreci tamamen dönüştürür:

1. Copilot CLI'a ajanınız için ne istediğinizi söyleyin 2. Plugin, proje yapısını ve gerekli dosyaları otomatik oluşturur 3. MCP sunucu bağlantısı, API plugin yapılandırması ve yetenek ekleme işlemlerini doğal dille yönetin 4. Hazır olduğunuzda "Ajanımı dağıt" diyerek dağıtımı başlatın

MCP Apps ve UI Widget'ları

MCP Apps, Model Context Protocol'ün etkileşimli kullanıcı arayüzü yetenekleri sunan bir uzantısıdır. OpenAI ve MCP-UI ile ortaklaşa geliştirilen bu açık standart; ChatGPT, Claude, Goose ve Visual Studio Code dahil birçok istemcide desteklenmektedir.

MCP Apps ile Neler Yapılabilir?

Araçlar, sohbet içinde doğrudan render edilen etkileşimli UI bileşenleri döndürebilir:

• Dashboard'lar: Gerçek zamanlı veri görselleştirmeleri
• Formlar: Kullanıcıdan veri toplama
• Görselleştirmeler: Grafik ve çizelge gösterimi
• Çok adımlı iş akışları: Sohbet içinde yönlendirmeli süreçler

Mimari olarak, araçlar UI meta verisi içerir ve ui:// şeması üzerinden sunulan UI kaynaklarına yönlendirir. İletişim, korumalı iframe'ler içinde postMessage üzerinden JSON-RPC ile çift yönlü gerçekleşir.

Declarative Agent'lara Widget Ekleme

Microsoft 365 Copilot, iki yöntemle oluşturulan UI widget'larını destekler:

MCP Apps: MCP sunucularının etkileşimli kullanıcı arayüzleri sunmasını sağlayan MCP uzantısı. @modelcontextprotocol/ext-apps npm paketi ile yeni MCP Apps oluşturulabilir. OpenAI Apps SDK: MCP Apps standardına dayalı, ek ChatGPT işlevselliği sunan araçlar. window.openai.* API'leri üzerinden araç çağrısı, mesaj gönderme, tam ekran modu ve daha fazlası desteklenir.

Desteklenen Yetenekler

Yetenek	MCP Apps	OpenAI Apps SDK	M365 Copilot Desteği
Araç girdisi/çıktısı	Evet	Evet	Evet
Widget durumu yönetimi	Alternatif mekanizma	Evet	Evet
Araç çağrısı (callTool)	Evet	Evet	Evet
Takip mesajı gönderme	Evet	Evet	Evet
Tam ekran modu	Evet	Evet	Evet
Harici bağlantı açma	Evet	Evet	Evet
Tema ve yerel ayar bilgisi	Evet	Evet	Evet
Dosya yükleme	Hayır	Evet	Hayır
Modal pencere	Hayır	Evet	Hayır

Kurulum ve Başlangıç Rehberi

Ön Koşullar

• Node.js 18+ (NPM/NPX dahil)
• Microsoft 365 aboneliği ve Copilot lisansı
• Microsoft Entra kiracısında Work IQ uygulaması için yönetici izni
• GitHub Copilot CLI (isteğe bağlı)

Work IQ Kurulumu

GitHub Copilot CLI üzerinden (en hızlı yol):

Copilot CLI'ı açın ve aşağıdaki komutları çalıştırın:

1. Plugin pazaryerini ekleyin: /plugin marketplace add microsoft/work-iq 2. Work IQ'yu kurun: /plugin install workiq@work-iq 3. Copilot CLI'ı yeniden başlatın ve sorgulamaya başlayın

npm ile global kurulum: npm install -g @microsoft/workiq komutuyla global olarak kurabilirsiniz. npx ile anlık çalıştırma (kurulum gerektirmez): npx -y @microsoft/workiq mcp komutuyla doğrudan MCP sunucusu modunda başlatabilirsiniz. VS Code entegrasyonu: .vscode/mcp.json dosyasına aşağıdaki yapılandırmayı ekleyin:

``json { "workiq": { "command": "npx", "args": ["-y", "@microsoft/workiq", "mcp"], "tools": ["*"] } } `

M365 Agents Toolkit Plugin Kurulumu

GitHub Copilot CLI üzerinden M365 Agents Toolkit plugin'ini kurmak için:

1. Plugin pazaryerini ekleyin: /plugin marketplace add microsoft/work-iq 2. Toolkit'i kurun: /plugin install microsoft-365-agents-toolkit@work-iq 3. Copilot CLI'ı yeniden başlatın

Kurulum sonrasında doğal dil komutlarıyla ajan geliştirmeye başlayabilirsiniz.

EULA Kabulü

Work IQ'yu ilk kez kullanmadan önce Son Kullanıcı Lisans Sözleşmesi'ni (EULA) kabul etmeniz gerekir:

workiq accept-eula

Kullanım Senaryoları

Kodlama Sırasında Proje Bağlamı Bulma

Bir toplantıda veya e-postalarda tartışılan bir özelliği uygularken, Work IQ AI asistanınızın kodun arkasındaki iş bağlamını anlamasına yardımcı olur.

CLI kullanımı: workiq ask -q "Sarah müşteri portalı kimlik doğrulama özelliği hakkında hangi gereksinimleri paylaştı?"

VS Code'da GitHub Copilot kullanımı: "Ekibimin müşteri portalı için tartıştığı kimlik doğrulama gereksinimlerini bul. Toplantılarımı ve e-postalarımı kontrol et."

AI asistanınız; toplantı notlarını, teknik gereksinimleri içeren e-postaları, paylaşılan belgeleri ve ekip kararlarını getirir. Bu bağlam, AI asistanınızın ekibinizin kararlarıyla uyumlu daha ilgili kod önerileri sunmasını sağlar.

Spec Belgesinden Özellik Başlatma

SharePoint'te saklanan bir spesifikasyon belgesine dayalı olarak yeni bir özellik üzerinde çalışmaya başlarsınız. Work IQ, temel özellikleri ve gereksinimleri özetler ve AI kodlama asistanınızın başlangıç uygulamalarını oluşturmasını sağlar.

CLI kullanımı: workiq ask -q "Kullanıcı portalı test sandbox'ı için spesifikasyon belgesindeki temel gereksinimleri ve özellikleri özetle."`

Müşteri Geri Bildirimi Analizi

Bir müşteri toplantısında dile getirilen sorunları hızlıca organize etmek ve çözüm önerileri almak için Work IQ'yu kullanabilirsiniz. Work IQ, Facilitator tarafından oluşturulan toplantı notlarından belirli sorunları ve kritik olanları tespit eder.

Ajan İskeletleme ve Dağıtım

M365 Agents Toolkit plugin'i ile sıfırdan ajan oluşturmak son derece kolaydır:

• "İK SSS için yeni bir declarative agent iskeletle"
• "Ajanıma web arama ekle"
• "Ajanımı dağıt"

Bu komutlar, proje yapısının oluşturulmasından JSON manifest'lerin yazılmasına, MCP sunucu bağlantısından dağıtıma kadar tüm süreçleri yönetir.

Güvenlik ve Gizlilik

Work IQ, Microsoft 365 Copilot tarafından sağlanan tüm veri korumalarını devralır:

• Kurumsal düzey güvenlik: Tüm veri erişimi, organizasyonunuzun güvenlik politikalarına uyar.
• İzin sistemi: Work IQ yalnızca görüntüleme izniniz olan verilere erişebilir.
• Yönetici görünürlüğü: Kurum yöneticileri, organizasyonlarındaki Work IQ kullanımını izleyebilir ve kontrol edebilir.
• Veri saklamama: Work IQ, Microsoft 365 verilerinizi saklamaz. Bilgileri yalnızca sorgu yaptığınızda isteğe bağlı olarak getirir.

Sınırlamalar ve Dikkat Edilmesi Gerekenler

• Public preview durumu: Work IQ şu anda genel ön izleme aşamasındadır. Özellikler ve API'ler değişebilir.
• Yönetici izni gereksinimi: Microsoft 365 organizasyon verilerine erişim, Microsoft Entra kiracısında yönetici iznini gerektirir. Yönetici değilseniz, izin için kurum yöneticinizle iletişime geçmeniz gerekir.
• Copilot lisansı gerekli: Work IQ'nun tam işlevselliği için Microsoft 365 Copilot lisansı gereklidir.
• Platform desteği: Windows (x64, ARM64), Linux (x64, ARM64), macOS (x64, ARM64) ve WSL desteklenir.
• MCP Apps kısıtlamaları: Declarative agent UI widget'larında dosya yükleme ve modal pencere gibi bazı yetenekler henüz M365 Copilot'ta desteklenmemektedir.