workiq-copilot

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 管理员同意（EULA + 权限）。非管理员需联系租户管理员根据租户管理员启用指南进行批准。

预检清单

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

核心工作流程

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

命令参考

命令	用途
workiq --help	显示全局选项。
workiq version	显示已安装版本。
workiq accept-eula	接受许可协议（首次使用）。
workiq ask	交互模式。
workiq ask --question "..."	询问特定问题（如果需要，可使用 -q 简写）。
workiq ask -t <tenant> -q "..."	针对特定租户。
workiq mcp	启动 MCP stdio 服务器（将 WorkIQ 工具暴露给其他代理）。

提示模式

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

响应指南

• 保持摘要简洁（2-3 句话），指出工作量、优先级、阻碍和可选的下一步。
• 除非用户特别需要链接，否则一般性地提及会议/文档。
• 提及 WorkIQ 可以继续（例如，“如果需要，WorkIQ 可以显示周四到周日”）。
• 将 WorkIQ 建议的操作映射为清晰的提议（预留时间、发送跟进、请求录制、运行更深层查询）。

最佳实践

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

故障排除

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

可提供的后续操作

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