workiq-copilot

WorkIQ Copilot 技能

概述

WorkIQ（公開預覽版）讓 Copilot 能以自然語言查詢 Microsoft 365 資料。支援行事曆、文件、Teams 訊息、電子郵件串、待辦事項追蹤、利害關係人摘要等。當任務需要超越本機儲存庫的即時組織智慧時，請使用此技能。

支援的資料與範例提示

• 電子郵件 – 「摘要 Sarah 關於預算的電子郵件。」
• 會議 – 「我這週有哪些即將到來的會議？」
• 文件 – 「尋找關於 Q4 規劃的最新文件。」
• Teams – 「摘要今天 Engineering 頻道的訊息。」
• 人員/專案 – 「誰在負責 Project 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 查詢（按專案、利害關係人、時間範圍）以進行深入分析。