SuperAPI AI 工具集

add-workiq

编程与开发

查看项目

更新于 10-16 06:47

技能介绍

用途:add-workiq 用于在应用中添加 Work IQ Copilot MCP 连接器,面向需要基于 Microsoft 365 数据(邮件、Teams、日历、文档等)做知识型问答与分析的场景。它本身是薄封装,唯一实现路径是调用 /add-data-source,参数为 api-id: shared_a365copilotchatmcp、mode: action。

主要能力:接入后可使用 WorkIQCopilotMCPService。Work IQ 基于 MCP(Model Context Protocol)这一有状态协议,需要会话初始化、会话 ID 跟踪、JSON-RPC ID 顺序、多轮对话 ID 持久化与响应解析。资料提供了 McpSession 封装类,负责会话协商、错误自动重试、会话失效后重新初始化,以及从嵌套 JSON-RPC 响应中提取 Copilot 文本。

使用方式:先按委托约定调用 /add-data-source 添加连接器;再创建 src/connectors/mcpClient.ts,原样复制资料中的 McpSession 实现;每个应用会话初始化一次 McpSession,之后复用调用 callCopilotChat()。提示词建议包含角色、上下文、任务与输出格式,可要求 markdown 分节或 JSON,再按需解析。

适用场景:会议摘要与行动项、每日优先级任务、项目风险分析、团队协作洞察,以及其他基于 M365 数据的知识型分析。

限制:资料未提供收费、价格、平台支持范围与效果保证。McpSession 实现较复杂,应原样使用;绕过它自行使用随机或硬编码会话 ID、直接调用 API 会导致 “Session not found” 错误。错误需在应用层 try/catch 中处理并展示。