WorkIQ Copilot 技能

概述

WorkIQ（公开预览版）让 Copilot 能够使用自然语言查询 Microsoft 365 数据。它支持日程安排、文档、Teams 消息、电子邮件线程、后续跟进跟踪、利益相关者摘要等功能。每当任务需要超出本地存储库范围的实时组织情报时，请使用此技能。

支持的数据和示例提示

• 电子邮件 – “总结 Sarah 关于预算的邮件。”
• 会议 – “我本周有哪些即将到来的会议？”
• 文档 – “查找关于 Q4 规划的最新文档。”
• Teams – “总结今天工程频道中的消息。”
• 人员/项目 – “谁在参与 Alpha 项目？”

获取访问权限

1. Copilot CLI 插件（首选）
   • copilot
   • /plugin marketplace add github/copilot-plugins
   • /plugin install workiq@copilot-plugins
   • 重启 Copilot CLI。
2. 独立 CLI / MCP 服务器
   • npm install -g @microsoft/workiq（或 npx -y @microsoft/workiq mcp）。
   • 如果需要，运行 workiq mcp 以暴露 MCP 工具。
3. 租户同意
   • 首次使用会提示 Microsoft 365 管理员同意（最终用户许可协议 + 权限）。非管理员必须联系租户管理员根据租户管理员启用指南进行批准。

预检查清单

• 运行 Get-Command workiq 确保二进制文件可用。
• 通过 workiq accept-eula 接受一次最终用户许可协议。
• 确认正确的租户（如果与默认的 common 不同，则使用 -t <租户ID>）。
• 准备好当提示时在浏览器中完成设备登录。

核心工作流程

1. 澄清意图 – 议程、行动项、文档查找、人员搜索、风险总结等。
2. 精心设计提示 – 包括时间范围、来源或主题（例如，“总结今天 #eng 频道中的 Teams 帖子”）。
3. 运行命令 – workiq ask --question "<提示>"（如果需要，可以使用简写 -q）。
4. 监控执行 – 长答案可能会流式传输；在发出后续请求之前，等待响应完成。
5. 总结与整理 – 突出见解，注意冲突/任务，除非必要，避免粘贴原始链接。
6. 提供后续操作 – 安排时间、起草笔记、更深入的查询等。

命令参考

提示模式

• 议程：“我明天的日程安排是什么？”
• 行动项：“总结今天客户同步会的后续事项。”
• 文档：“列出关于 Contoso FY26 路线图的 PowerPoint。”
• 沟通：“我的经理关于截止日期说了什么？”
• 洞察：“最近三次会议中出现了哪些阻碍？”
• 规划：“为周二下午建议专注时段。”

响应指南

• 保持总结简洁（2–3 句），指出负载、优先级、阻碍和可选的下一步步骤。
• 除非用户特别需要链接，否则泛泛地提及会议/文档。
• 提及 WorkIQ 是否可以继续（例如，“如果需要，WorkIQ 可以显示周四至周日的安排”）。
• 将 WorkIQ 建议的操作映射到清晰的提议（安排时间、发送后续邮件、请求录音、运行更深层查询）。

最佳实践

• 优先使用狭窄的提示以减少干扰；如果需要，可以运行多个查询。
• 在响应之前，逻辑地组合输出（议程 + 冲突 + 行动项）。
• 尊重隐私：除非明确要求，否则不要暴露与会者列表或机密片段。
• 记录运行的命令，以便后续步骤可以引用它们（“向 WorkIQ 询问了议程 + 冲突”）。
• 当另一个代理/工作流需要直接工具访问时，使用 MCP 模式（workiq mcp）。

故障排除

• 缺少 CLI – 通过 npm 安装或确保 PATH 已设置；如果不可用，通知用户。
• 同意/认证错误 – 在管理员授予权限或完成设备登录后重新运行命令。
• 长/不完整的输出 – 用更精确的范围重新运行，或要求特定的数据片段（按天/项目/人员）。
• 命令挂起 – 在终端中取消正在运行的命令（例如，使用 Ctrl+C）或重启 Copilot CLI 会话，然后重试；确保浏览器登录已完成。

可提供的后续操作

• 在建议的时间安排专注/溢出时段。
• 参考 WorkIQ 的指导，起草重新安排/拒绝消息。
• 为重叠的会话请求录音或总结。
• 将行动项捕获到任务跟踪器中。
• 运行额外的 WorkIQ 查询（按项目、利益相关者、时间范围）以进行更深入的分析。