Work IQ retrieve Aracı: Ajanlara Kaynaklı İş Bağlamı

Microsoft 365 Developer Blog’da duyurulan Work IQ retrieve aracı, ajanların yanıtlarını kullanıcının iş verilerine dayandırmasını tek bir alma (retrieval) katmanı üzerinden mümkün kılıyor. E-posta, dosya, toplantı, Teams mesajları ve kişiler gibi farklı çalışma kaynakları için ayrı ayrı arama sistemi kurmadan ajana kurumsal bağlam sağlanabiliyor. Ajanın eline geçen şey, kanıtı atıflarıyla birlikte modele taşıyan hazır bir bağlam metni.

retrieve ne yapıyor?

retrieve, Work IQ’nun MCP araçlarından biri olarak kullanıcının işyeri verilerinde arama yapıyor. Kapsamda e-posta, dosyalar, toplantılar, Teams mesajları ve kişilerin yanı sıra bağlı kurumsal kaynaklar da var. Erişim sınırı Work IQ’daki diğer araçlarda olduğu gibi kullanıcıya göre çiziliyor, yani her kullanıcı yalnızca yetkili olduğu iş kaynaklarından bilgi alabiliyor. Kurumsal zeka tüketiminde güvenlik ve erişim denetimi ilk sırada tutuluyor.

Bu araç, Copilot Retrieval API’nin evrilmiş hali olarak tanımlanıyor. Alma işlemini ajan tüketimine göre yeniden şekillendiriyor, ajanlar kararlarını iş bağlamına dayandırdıkça ölçeklenecek biçimde tasarlanıyor. Mevcut agentic retrieval akışlarını taşımak isteyenler için ayrı bir geçiş rehberi var.

Yanıtın yapısı: markdown ve retrievalHits

Araç iki ana bileşen dönduruyor: kaynak bazında ham sonuç kayıtları ve satır içi atıflar içeren, model dostu bir grounding markdown’ı. Yanıt sıralanmış bir belge listesinden ibaret kalmıyor; okunabilir bir temellendirme temsili ile yapılandırılmış hit kayıtları bir arada geliyor.

Cevabı oluştururken modele verilecek bağlam markdown alanıdır. Bu alandaki satır içi atıf kimlikleri tek tek hit kayıtlarına karşılık gelir. Hit alanları arasında id, resourceId, webUrl, entityUrl, entityType, contentProtection, resourceMetadata ve sensitivityLabel yer alabilir. Özetleme yaparken atıfları koruyun; uygulamanız kaynağa geri bağlantı vermek ya da kaynağa duyarlı bir işleme uygulamak istediğinde hit metadata’sını kullanın.

Yanıt yükü application/vnd.ms-workiq.retrieval ad alanı altında taşınıyor ve resultCount ile stoppedReason gibi alanlar da içeriyor. Gerçek yanıtlar çok daha fazla hit ve kaynağa özgü zengin metadata barındırabilir.

Alma ve delegasyon ayrı işlemler

Work IQ’da bilgi toplama ile görevi devretme bilinçli olarak ayrılmış durumda. Mevcut ajan için ilgili bağlamı toplamak istediğinizde retrieve kullanılıyor. Görev başka bir ajana devredilecekse ask veya do_action devreye giriyor, bu çağrılarda isteğe bağlı olarak hedef ajan kimliği seçilebiliyor. Ayrım sayesinde alma sorgusu işi örtük biçimde yönlendirmek yerine yalnızca kanıt bulmaya odaklı kalıyor.

Parametreler: strategy ve capabilities

Aracın davranışını belirleyen parametreler şöyle özetlenebilir:

Parametre	İşlevi
query	Zorunlu. Aranacak şeyin doğal dildeki tanımı. Boş veya yalnızca boşluk içeren girdi geçersiz.
includeDeveloperCard	Backend tarafından dönen isteğe bağlı orkestrasyon tanılamaları: ajan metadata’sı, araç çağrısı ayrıntıları ve alma özeti. Varsayılanı false.
agentId	Özel bir Copilot ajanını hedefler (bizchat-as-gpt-scenario); kimlik istekte yer alır.
strategy	copilot (varsayılan) dizine alınmış Microsoft 365 içeriğinin yanı sıra federated connector’ları, dış kaynakları ve MCP araçlarını arar. grounding ise aramayı dizine alınmış SharePoint, OneDrive, Teams ve Outlook içeriğiyle sınırlar. Bu ikisi dışındaki değerler reddedilir.
capabilities	Declarative Agent yetenek şeklini kullanan isteğe bağlı izin listesi: People, Meetings, OneDriveAndSharePoint, Email, TeamsMessages, Dataverse ve GraphConnectors. Listeyi atlarsanız veya boş geçerseniz seçili ajanın erişebildiği tüm kaynaklar kapsamda kalır.

strategy seçimi, verinin nerede olduğuna dair bildiklerinizi yansıtır. Konum bilinmiyorsa veya dizin dışında olabilecekse geniş kapsamlı copilot, istek yalnızca Microsoft 365 dizininden yanıtlanabiliyorsa grounding uygun olur.

Daha dar kaynak seçimi gereken uygulamalarda capabilities devreye girer. Bu parametreyle alma işlemini Email, TeamsMessages ya da OneDriveAndSharePoint gibi yetenek ailelerine kısıtlayabilir; yeteneğe özgü kapsam alanlarıyla belirli bir SharePoint sitesini, OneDrive konumunu, SharePoint Embedded container’ını, paylaşılan posta kutusunu veya belirli mail klasörlerini ya da tek bir federated connector’ı hedefleyebilirsiniz.

Dikkat edilmesi gereken iki kısıt var. capabilities listesi varsayılan dışı bir agentId ile birlikte kullanılamaz, Dataverse ve GraphConnectors da grounding stratejisiyle birleştirilemez.

Örnek çağrı ve hata ayıklama

Farklı iş artefaktlarına yayılan bir sorgu, geniş kapsamlı alma ile yalnızca dizinle sınırlı almanın farkını somutlaştırır. Aşağıdaki kavramsal istek varsayılan geniş stratejiyi kullanır ve kaynak kümesini seçili ajana bırakır:

{
"query": "Find the latest launch decision, who owns the follow-up, and the meeting or document it came from",
"strategy": "copilot",
"includeDeveloperCard": false
}

Sorguyu Microsoft 365 dizinine sınırlamak için "strategy": "grounding" ayarlanır. Daha da daraltmak için capabilities bir JSON dizisi olarak verilir; örneğin desteklenen kapsam alanlarıyla birlikte bir Email yeteneği tanımlanabilir. Orkestrasyonda hata ayıklarken backend tanılamalarını istemek için includeDeveloperCard: true, normal alma akışında ise false kullanılması öneriliyor.

Yanıt tarafında önce markdown alanı üzerinden yanıtı temellendirin, ardından satır içi atıf kimliklerini retrievalHits kayıtlarıyla eşleştirin. Yükün yapısı kısaltılmış biçimde şöyle görünür (bağlantı alanları burada kısaltılmıştır):

{
"application/vnd.ms-workiq.retrieval": {
"markdown": "## Files
- **Launch decision** [^h1]
## Meetings
- **Follow-up owner** [^h2]",
"retrievalHits": [
{
"id": "h1",
"webUrl": "…",
"entityType": "Files",
"sensitivityLabel": {}
},
{
"id": "h2",
"webUrl": "…",
"entityType": "Meetings",
"sensitivityLabel": {}
}
],
"resultCount": 2,
"stoppedReason": "completed"
}
}

Nereden başlamalı?

Microsoft, deseni denemek için Interactive Demo üzerinden Work IQ MCP araçlarının incelenmesini öneriyor. Bir ajanın iş kaynakları arasından atıflı bağlama ihtiyacı olduğunda retrieve kullanın, strateji ve kaynak seçimlerini bilinçli biçimde değiştirerek dönen temellendirme metnini ve metadata’yı inceleyin. Bu inceleme, kaynağa duyarlı almanın kendi ajan mimarinizi nasıl şekillendirebileceğini gösterir.

Work IQ’ya dair daha fazla içerik için Microsoft, 17-20 Kasım 2026 tarihlerinde San Francisco’da düzenlenecek Microsoft Ignite etkinliğine davet ediyor. Etkinlik ayrıntıları ve yol haritası güncellemeleri Ignite sitesinden takip edilebiliyor.

Kaynaklar ve İleri Okuma

• devblogs.microsoft.com
• devblogs.microsoft.com

• Work IQ: the new retrieve tool — Microsoft 365 Developer Blog (Paolo Pialorsi)
• Work IQ MCP’de retrieve aracını kullanma — Microsoft Learn
• Agentic retrieval akışlarını Work IQ MCP’ye taşıma — Microsoft Learn
• Interactive Demo ve Copilot geliştirici kaynakları
• Microsoft Ignite etkinlik sitesi
• Work IQ Developer Tools Önizlemesi Duyuruldu
• Work IQ Developer Tools ile Copilot Plugin Paketleme