workiq-copilot

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

WorkIQ Copilot Skill

WorkIQ Copilot 技能

Overview

概述

WorkIQ (Public Preview) lets Copilot query Microsoft 365 data with natural language. It supports schedules, documents, Teams messages, email threads, follow-up tracking, stakeholder summaries, and more. Use this skill whenever a task needs live organizational intelligence beyond the local repository.

WorkIQ（公开预览版）允许Copilot通过自然语言查询Microsoft 365数据。它支持日程安排、文档、Teams消息、电子邮件线程、跟进跟踪、利益相关者摘要等功能。当任务需要本地存储库之外的实时组织智能时，请使用此技能。

Supported Data & Sample Prompts

支持的数据类型及示例提示词

Emails – “Summarize emails from Sarah about the budget.”
Meetings – “What are my upcoming meetings this week?”
Documents – “Find recent documents about Q4 planning.”
Teams – “Summarize messages in the Engineering channel today.”
People/Projects – “Who is working on Project Alpha?”

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

Getting Access

获取访问权限

Copilot CLI plugin (preferred)

```
copilot
```

/plugin marketplace add github/copilot-plugins

```
/plugin install workiq@copilot-plugins
```
Restart Copilot CLI.

Standalone CLI / MCP server

npm install -g @microsoft/workiq

(or

npx -y @microsoft/workiq mcp

Run
```
workiq mcp
```
to expose MCP tools if needed.

Tenant consent
- First use prompts for Microsoft 365 admin consent (EULA + permissions). Non-admins must contact tenant admin to approve per the Tenant Administrator Enablement Guide.

Copilot CLI 插件（推荐方式）

```
copilot
```

/plugin marketplace add github/copilot-plugins

```
/plugin install workiq@copilot-plugins
```
重启Copilot CLI。

独立CLI / MCP服务器
- ```
npm install -g @microsoft/workiq
```
  （或
```
npx -y @microsoft/workiq mcp
```
  ）。
- 若需要，运行
```
workiq mcp
```
  以暴露MCP工具。
租户授权
- 首次使用时会提示获取Microsoft 365管理员授权（最终用户许可协议+权限）。非管理员用户必须联系租户管理员，按照《租户管理员启用指南》完成审批。

Pre-flight Checklist

飞行前检查清单

Run
```
Get-Command workiq
```
to ensure the binary is available.
Accept the EULA once via
```
workiq accept-eula
```
.
Confirm the correct tenant (
```
-t <tenant-id>
```
if different from default
```
common
```
).
Be ready to complete device login in the browser when prompted.

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

Core Workflow

核心工作流程

Clarify intent – agenda, action items, document lookup, people search, risk summary, etc.
Craft precise prompt – include timeframe, source, or topic (e.g., “Summarize Teams posts in #eng for today”).
Run command –
```
workiq ask --question "<prompt>"
```
(use
```
-q
```
for shorthand if desired).
Monitor execution – long answers may stream; wait for the response to finish before issuing additional requests.
Summarize & redact – highlight insights, note conflicts/tasks, avoid pasting raw links unless required.
Offer follow-ups – blocking time, drafting notes, deeper queries, etc.

明确意图 – 日程、行动项、文档查找、人员搜索、风险摘要等。
编写精准提示词 – 包含时间范围、来源或主题（例如：“总结今天#eng频道中的Teams帖子”）。
运行命令 –
```
workiq ask --question "<prompt>"
```
（若需要，可使用
```
-q
```
作为简写）。
监控执行过程 – 较长的回复可能会流式输出；在发出额外请求前，请等待响应完成。
总结与编辑 – 突出关键见解，记录冲突/任务，除非必要，避免粘贴原始链接。
提供后续操作建议 – 安排时间、起草笔记、深入查询等。

Command Reference

命令参考

Command	Purpose
`workiq --help`	Show global options.
`workiq version`	Display installed version.
`workiq accept-eula`	Accept license (first use).
`workiq ask`	Interactive mode.
`workiq ask --question "..."`	Ask a specific question (use `-q` shorthand if preferred).
`workiq ask -t <tenant> -q "..."`	Target a specific tenant.
`workiq mcp`	Start MCP stdio server (expose WorkIQ tools to other agents).

命令	用途
`workiq --help`	显示全局选项。
`workiq version`	显示已安装版本。
`workiq accept-eula`	接受许可协议（首次使用）。
`workiq ask`	交互模式。
`workiq ask --question "..."`	提出特定问题（若需要，可使用 `-q` 简写）。
`workiq ask -t <tenant> -q "..."`	指定目标租户。
`workiq mcp`	启动MCP标准输入输出服务器（向其他Agent暴露WorkIQ工具）。

Prompt Patterns

提示词模板

Agenda: “What’s on my calendar tomorrow?”
Action items: “Summarize follow-ups from today’s customer sync.”
Documents: “List PowerPoints about Contoso FY26 roadmap.”
Communications: “What did my manager say about the deadline?”
Insights: “What blockers came up in the last three meetings?”
Planning: “Suggest focus blocks for Tuesday afternoon.”

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

Response Guidelines

回复指南

Keep summaries concise (2–3 sentences) calling out load, priorities, blockers, and optional next steps.
Refer to meetings/documents generically unless the user specifically needs links.
Mention if WorkIQ can continue (e.g., “WorkIQ can show Thu–Sun if needed”).
Map WorkIQ’s suggested actions to clear offers (block time, send follow-up, request recording, run deeper query).

保持摘要简洁（2-3句话），重点提及工作量、优先级、障碍以及可选的后续步骤。
除非用户特别需要链接，否则以通用方式提及会议/文档。
说明WorkIQ是否可以继续提供帮助（例如：“如果需要，WorkIQ可以显示周四至周日的内容”）。
将WorkIQ建议的行动转化为清晰的服务选项，例如安排时间、发送跟进邮件、请求录制内容、进行深入查询等。

Best Practices

最佳实践

Prefer narrow prompts to reduce noise; run multiple queries if needed.
Combine outputs logically (agenda + conflicts + action items) before responding.
Respect privacy: do not expose attendee lists or confidential snippets unless explicitly requested.
Log which commands were run so future steps can reference them (“Asked WorkIQ for agenda + conflicts”).
Use MCP mode (
```
workiq mcp
```
) when another agent/workflow needs direct tool access.

优先使用范围明确的提示词以减少无关信息；如有需要，可运行多次查询。
在回复前，将输出内容进行逻辑整合（例如日程+冲突+行动项）。
尊重隐私：除非明确要求，否则不要暴露参会者名单或机密片段。
记录已运行的命令，以便后续步骤可以参考（例如：“已通过WorkIQ查询日程+冲突”）。
当其他Agent/工作流需要直接访问工具时，使用MCP模式（
```
workiq mcp
```
）。

Troubleshooting

故障排除

Missing CLI – install via npm or ensure PATH is set; notify user if unavailable.
Consent/auth errors – re-run command after admin grants permissions or after completing device login.
Long/incomplete output – rerun with refined scope or ask for specific data slices (per day/project/person).
Command hanging – cancel the running command in your terminal (for example, with Ctrl+C) or restart the Copilot CLI session, then retry; ensure browser login completed.

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

Follow-up Actions to Offer

可提供的后续操作

Block focus/overflow holds at suggested times.
Draft reschedule/decline messages referencing WorkIQ guidance.
Request recordings or summaries for overlapping sessions.
Capture action items into task trackers.
Run additional WorkIQ queries (by project, stakeholder, time range) for deeper analysis.

在建议的时段安排专注/缓冲时间。
参考WorkIQ的指导起草重新安排/拒绝会议的消息。
请求重叠会议的录制内容或摘要。
将行动项导入任务跟踪工具。
运行更多WorkIQ查询（按项目、利益相关者、时间范围划分）以进行深入分析。