Microsoft Work IQ — 插件市场

GitHub Copilot 的官方 Microsoft Work IQ 插件集合 ✨

通过 Work IQ 插件扩展 GitHub Copilot 的功能——MCP 服务器、技能和工具，可将 AI 助手连接到您的 Microsoft 365 数据。

⚠️ 公开预览版： 功能和 API 可能会变更。

要访问 Microsoft 365 租户数据，WorkIQ CLI 和 MCP 服务器需要获得租户上的管理权限授权。首次访问时，会出现一个授权对话框。如果您不是管理员，请联系您的租户管理员以授予访问权限。

面向租户管理员： 请参阅 租户管理员启用指南，其中包含详细的管理员授权说明，包括一键式快速授权 URL。

如需更多信息，请参阅 Microsoft 的 用户与管理员授权概述。

📋 先决条件

在开始之前，请确保已安装 Node.js（包含 NPM 和 NPX）：

• Node.js 18+ — 从 nodejs.org 下载

您可以通过运行以下命令来验证安装是否成功：

node --version
npm --version

💡 为什么需要 Node.js？ WorkIQ 使用 NPX 来运行 MCP 服务器。NPX 自动包含在随 Node.js 一起提供的 NPM 中。

---

🚀 使用 GitHub Copilot CLI 快速入门

# 1. 打开 GitHub Copilot CLI
copilot

# 2. 添加此插件市场（一次性设置）
/plugin marketplace add microsoft/work-iq

# 3. 安装任意插件
/plugin install workiq@work-iq
/plugin install microsoft-365-agents-toolkit@work-iq
/plugin install workiq-productivity@work-iq

就是这样！ 重启 Copilot CLI，即可开始使用该插件：

你：我这周有哪些即将召开的会议？
你：总结一下 Sarah 关于预算的邮件。
你：查找我昨天处理过的文档。

---

📦 替代方案：独立 MCP 安装

如果您希望将 WorkIQ 作为独立的 MCP 服务器运行：

# 全局安装
npm install -g @microsoft/workiq

# 运行 MCP 服务器
workiq mcp

或者使用 npx 而无需安装：

npx -y @microsoft/workiq mcp

也可以将其作为 MCP 服务器添加到您的编码助手或 IDE 中：

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

注意：有关 Visual Studio Code 的配置说明，请参阅 在 VS Code 中使用 MCP 服务器。

更新

如果您使用 npm 全局安装了 WorkIQ，请运行以下命令以更新到最新版本：

npm update -g @microsoft/workiq

更新后，可通过以下命令验证已安装的版本：

workiq version

💡 使用 npx 吗？ 如果您通过 npx -y @microsoft/workiq mcp 运行 WorkIQ，npx 每次都会自动获取最新版本，因此无需手动更新。

---

🎯 您可以查询的内容

数据类型	示例问题
电子邮件	“John 对提案说了什么？”
会议	“我明天的日程安排是什么？”
文档	“查找我最近的 PowerPoint 演示文稿”
Teams	“总结一下工程频道今天的消息。”
人员	“谁在负责 Alpha 项目？”

---

📖 CLI 参考

命令

命令	描述
workiq accept-eula	接受最终用户许可协议 (EULA)
workiq ask	向特定代理提问或进入交互模式
workiq mcp	启动用于代理通信的 MCP 标准输入输出服务器
workiq version	显示版本信息

全局选项

选项	描述	默认值
-t, --tenant-id <tenant-id>	用于身份验证的 Entra 租户 ID	common
--version	显示版本信息	无
-?, -h, --help	显示帮助和使用信息	无

workiq ask 选项

选项	描述
-q, --question <question>	要向代理提出的问题

示例

# 接受 EULA（首次使用时必需）
workiq accept-eula

# 交互模式
workiq ask

# 提出具体问题
workiq ask -q "我明天有哪些会议？"

# 使用特定租户
workiq ask -t "your-tenant-id" -q "显示我的邮件"

# 启动 MCP 服务器
workiq mcp

---

🔌 可用插件

插件	描述
workiq	使用自然语言查询 Microsoft 365 数据——电子邮件、会议、文档、Teams 消息等。
microsoft-365-agents-toolkit	用于构建 M365 Copilot 声明式代理的工具包——脚手架生成、清单编写和能力配置。
workiq-productivity	仅读取的 WorkIQ 生产力洞察——邮件分类、会议成本、组织结构图、频道审计等。

📖 请参阅 PLUGINS.md，了解完整的插件目录，其中包含详细的技能列表、示例提示、MCP 服务器信息以及安装说明。

---

平台支持

WorkIQ CLI 和 MCP 服务器支持 win_x64、win_arm64、linux_x64、linux_arm64、osx_x64 和 osx_arm64 系统。

---

🤝 贡献

我们欢迎新的插件！请参阅 CONTRIBUTING.md，了解完整指南。简而言之：

1. 在 plugins/{your-plugin}/ 目录下创建您的插件。
2. 添加 .mcp.json、README.md 和 skills/{name}/SKILL.md 文件。
3. 在 .github/plugin/marketplace.json 中注册。
4. 提交拉取请求。

---

📄 许可证

使用本软件包即表示您同意许可协议。有关法律条款，请参阅软件包中的 [NOTICES.TXT] 和 EULA。

商标

本项目可能包含项目、产品或服务的商标或标识。微软商标或标识的授权使用须遵守并严格执行微软商标与品牌指南。在本项目的修改版本中使用微软商标或标识时，不得造成混淆或暗示微软的赞助关系。任何第三方商标或标识的使用均应遵循该第三方的相关政策。

Microsoft Work IQ 快速上手指南

Microsoft Work IQ 是 GitHub Copilot 的官方插件集合，通过 MCP（Model Context Protocol）服务器将 AI 助手连接到您的 Microsoft 365 数据（如邮件、会议、文档和 Teams 消息）。

⚠️ 注意：目前处于公共预览版（Public Preview），功能和 API 可能会发生变化。首次使用时需要租户管理员授权或用户自行确认权限。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：支持 Windows (x64/ARM64)、Linux (x64/ARM64) 和 macOS (x64/ARM64)。
• 核心依赖：必须安装 Node.js 18+（包含 NPM 和 NPX）。
  • 下载地址：https://nodejs.org/
  • 国内开发者建议：如下载缓慢，可使用淘宝镜像或国内云厂商提供的 Node.js 镜像源。

验证安装是否成功：

node --version
npm --version

安装步骤

您可以根据使用场景选择以下两种安装方式之一：

方式一：集成到 GitHub Copilot CLI（推荐）

如果您直接使用 GitHub Copilot 命令行工具，请按以下步骤操作：

1. 打开终端并启动 Copilot CLI：

   copilot
   

2. 添加 Work IQ 插件市场（仅需执行一次）：

   /plugin marketplace add microsoft/work-iq
   

3. 安装所需的具体插件（例如查询 M365 数据）：

   /plugin install workiq@work-iq
   

   其他可选插件：microsoft-365-agents-toolkit@work-iq 或 workiq-productivity@work-iq

4. 重启 Copilot CLI 即可生效。

方式二：独立安装 MCP 服务器

如果您希望在 VS Code 或其他支持 MCP 的 IDE 中独立运行服务：

选项 A：全局安装（推荐）

# 全局安装
npm install -g @microsoft/workiq

# 运行 MCP 服务器
workiq mcp

选项 B：免安装运行（使用 npx）

npx -y @microsoft/workiq mcp

选项 C：配置 VS Code 在 VS Code 的 settings.json 中添加以下配置以启用 MCP 服务器：

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

权限提示：首次运行时，系统会弹出 consent 对话框请求访问 Microsoft 365 租户数据的权限。如果您不是租户管理员，请联系管理员进行授权，或参考官方提供的“一键授权”链接。

基本使用

安装并完成授权后，您可以直接使用自然语言查询 Microsoft 365 数据。

1. 接受许可协议（首次使用必需）

在使用命令行工具前，需先接受最终用户许可协议：

workiq accept-eula

2. 交互式提问

运行以下命令进入交互模式，或直接传入问题：

# 进入交互模式
workiq ask

# 直接提问示例
workiq ask -q "What meetings do I have tomorrow?"

3. 在 Copilot 中使用

如果在 Copilot CLI 中安装了插件，可以直接对话：

• 查询会议： You: What are my upcoming meetings this week?
• 总结邮件： You: Summarize emails from Sarah about the budget
• 查找文档： You: Find documents I worked on yesterday
• Teams 消息： You: Summarize today's messages in the Engineering channel

常用命令参考

命令	说明
workiq accept-eula	接受用户许可协议
workiq ask -q "<问题>"	向代理发送特定问题
workiq mcp	启动 MCP stdio 服务器
workiq version	查看当前版本
workiq -t <tenant-id>	指定 Entra 租户 ID 进行认证