TOPIC COLLECTION
微软Work IQ新增retrieve工具：让AI代理按权限检索邮件、文件、会议和Teams消息，strategy和capabilities参数怎么选
微软Microsoft 365开发者博客在2026-10-20介绍了Work IQ新的MCP工具retrieve：它按用户本人的访问权限，检索邮件、文件、会议、Teams消息、人员以及已连接的企业数据源，返回两部分结果：带行内引用的markdown（给模型用）和逐条命中记录retrievalHits（含链接、实体类型、敏感度标签等）。strategy参数默认copilot（索引内容加联合连接器、外部源和MCP工具），grounding只查SharePoint、OneDrive、Teams、Outlook索引；capabilities可限定来源。Work IQ API自2026-06-16起按Copilot Credits消耗计费，没有单独的按人授权。本文讲参数怎么选、适合谁、要注意的权限与成本。
资料更新：2026-10-20
依据Microsoft 365 Developer Blog文章《Work IQ: the new retrieve tool》（2026-10-20，Paolo Pialorsi）与Microsoft Licensing Resources《Work IQ GA June 16, 2026》。retrieve具体归入哪一类计费（Tool API固定0.1 Copilot Credits/次还是Context类可变计费）博客未写明，文中已标注。世纪互联运营的中国版Microsoft 365是否提供Work IQ未查到官方说明。核查2026-10-20（新加坡时间）。
主题标签：Work IQ、Microsoft 365、MCP、Copilot、企业AI代理
这篇适合两类人看：公司在用国际版Microsoft 365、想让自己做的AI代理能查到同事邮件和文档的开发者；以及负责审批这类项目的IT和信息安全同事。只用Word、Excel写写东西的普通用户，可以直接跳到文末看「对普通员工意味着什么」。
retrieve是什么
Work IQ是微软给Microsoft 365做的「工作上下文」能力层，开发者可以通过API或MCP工具，让自己的代理用上公司里的邮件、文件、会议这些数据。10月20日，微软开发者博客介绍了一个新的MCP工具，名字就叫retrieve。
它做的事情很单纯：按当前用户的身份，在他有权访问的工作数据里搜。范围包括邮件、文件、会议、Teams消息、人员，以及企业接进来的其他数据源。博客里反复强调了一点：每个用户只能检索到自己被授权访问的内容。说白了，它不会让你的代理看到你本来看不到的东西。
官方说它是从Copilot Retrieval API演进来的，专门为代理调用做了调整。
它返回什么
返回结果分两部分，这个设计挺实用：
- markdown：一段整理好的、带行内引用编号的文本，给模型直接当上下文用。博客原话是让你基于这个字段组织回答。
- retrievalHits：逐条命中记录，字段可能包括
id、webUrl、entityType、contentProtection、sensitivityLabel等。markdown里的引用编号能对应到这里的每一条。
整个返回体放在application/vnd.ms-workiq.retrieval这个命名空间下，还带resultCount和stoppedReason。做产品时，前端展示「答案来自哪封邮件、哪份文档」，就靠retrievalHits里的链接。
几个参数怎么选
| 参数 | 作用 | 我的用法建议 |
|---|---|---|
| query | 必填，用自然语言描述要找什么，不能为空 | 写清楚对象和时间，比如「上周和某客户的续约讨论、负责人是谁」 |
| strategy | copilot（默认）或grounding，其他值会被拒绝 | 不确定资料在哪就用copilot；明确只在邮件和文档里就用grounding |
| capabilities | 可选的来源白名单，如Email、TeamsMessages、OneDriveAndSharePoint、Meetings、People、Dataverse、GraphConnectors | 能缩小就缩小，结果更准，也更不容易翻出不该引用的东西 |
| agentId | 指定一个自定义Copilot代理 | 注意不能和capabilities同时用 |
| includeDeveloperCard | 返回后端编排的诊断信息，默认false | 调试时开，正式环境关 |
两个策略的区别要记清楚。copilot会查Microsoft 365已索引的内容，还会去联合连接器、外部数据源和MCP工具里找，覆盖面大。grounding只查SharePoint、OneDrive、Teams和Outlook这几块已索引的内容。另外有个组合限制：Dataverse和GraphConnectors这两类来源不能和grounding一起用。
capabilities还能细到具体位置，比如某个SharePoint站点、某个OneDrive位置、共享邮箱、指定的邮件文件夹或者某一个联合连接器。不传或者传空列表，等于所选代理能访问的来源全开。
检索和委派是两回事
博客专门提了一句：retrieve只负责给当前代理找证据；如果是想把任务交给另一个代理去办，用ask或do_action。我觉得这个区分对设计代理流程很有帮助。很多团队一开始把「查资料」和「让别的代理去做事」混在一个调用里，结果查询意图被稀释，命中率下降。
钱怎么算
微软授权页面写得比较明白：Work IQ API在2026年6月16日正式可用，按消耗计费，用的是Copilot Credits，这和Copilot Studio等服务共用一个额度池。没有单独的Work IQ订阅、SKU或者按人授权。
计费分两块：Chat API和Context API这类「查询型」消耗按场景复杂度浮动；Tool API是固定的，每次调用0.1 Copilot Credits。retrieve到底按哪一类算，这篇博客没写，我也没在授权页上看到明确对应。上线前请让IT查一下Copilot Credit指南，或者先小流量跑几天看账单。
还有一个容易混的点：如果是通过Microsoft Foundry连接Work IQ，微软Learn文档写的是调用代理的每个用户都需要Microsoft 365 Copilot许可证。直接调用Work IQ API和走Foundry，授权要求不一样，别拿一套标准套另一套。
上手顺序
- 先在博客提到的Interactive Demo里试，不用写代码，能直观看到copilot和grounding两种策略的结果差别。
- 用一个测试账号、一份你确定能访问的文档做验证，看引用编号和webUrl是否能对上。
- 把capabilities收窄到真正需要的来源，再接进自己的代理。
- 调试阶段打开includeDeveloperCard，确认没问题后关掉。
- 接入前和信息安全同事过一遍：敏感度标签的内容在你的应用里怎么展示、日志里会不会落下原文。
容易踩的坑
- 权限是按人走的。同一个问题，经理问和实习生问，结果不一样，这是正常的。测试时别用管理员账号，否则会高估效果。
- 摘要时丢引用。博客建议总结时保留引用。如果你的代理会对markdown再做一轮改写，记得把引用编号带上，不然用户没法回查原文。
- 中国版Microsoft 365。世纪互联运营的版本是否提供Work IQ，我没查到官方说明，用之前先问微软或你的服务商。
对普通员工意味着什么
如果公司里的内部助手、Microsoft Copilot类工具或者第三方代理接入了Work IQ，它们能找到的范围，就是你邮箱、Outlook日历、OneDrive和Teams里你本来就能看到的东西。文件共享权限设得太宽，代理也会照单全收。顺手检查一下自己共享出去的文档链接，是件不亏的事。
想了解微软这一套代理工具的更多背景，站内有Copilot Studio代理账号与流程记忆、Copilot Studio Teams应用退役迁移；其他办公软件接MCP的做法可以对比Notion AI接入MCP应用和Notion。分类入口：AI办公、AI代理搭建、办公套件。微软还说会在11月17日到20日旧金山的Ignite大会上讲Work IQ路线图，可以留意。
来源与核查日期
- Microsoft 365 Developer Blog：Work IQ: the new retrieve tool（2026-10-20）
- Microsoft Licensing Resources：Work IQ GA June 16, 2026（Copilot Credits计费）
- Microsoft Learn：Work IQ overview
核查日期：2026-10-20（新加坡时间）。计费与授权以微软官方文档和你的合同为准。
