Microsoft 365 Agents TypeScript 技能
帮助你用 TypeScript 构建可路由、可流式响应并接入 Copilot Studio 的 Microsoft 365 企业代理。
技能要求通过环境变量加载密钥，并建议避免将秘密写入源代码，显示出基本的秘密保护意识；但未说明权限最小化、令牌范围、数据流、外部服务副作用、用户确认或回滚方案，因此扣分。
核心示例在结构上较为一致，并建议用 finally 结束流；但未提供针对该技能的测试、版本锁定、完整认证配置或异常输入处理，而且流式示例遗漏了其使用的 ai 与 @ai-sdk/azure 安装依赖，因此扣分。
名称、受众、TypeScript/Node.js 场景和触发词较明确，覆盖 AgentApplication、Express、流式响应及 Copilot Studio；但未声明非适用范围、输入输出边界、运行时前置条件或中文支持，亦没有证据证明在中国大陆网络环境中的可达性，因此扣分。
具备 front matter、MIT 许可、版本号、安装步骤、环境变量、示例、最佳实践和参考链接，结构清晰；但缺少 FAQ、故障排查、已知限制、变更日志、依赖版本策略和明确维护更新路径，因此扣分。
示例可直接作为若干 SDK 用法的起点，覆盖路由、流式输出、invoke 和 Copilot Studio；但缺少完整项目配置、身份验证流程、部署说明、错误恢复和必要依赖，生成结果仍需较多人工核验，因此扣分。
技能提供 Microsoft 官方文档、API 参考和 GitHub samples 链接，具备一定可追溯性；但本次仅静态阅读，没有该技能专属测试或可核验执行结果，仓库级 CI 证据也未证明覆盖此路径，因此按静态上限保守扣分。
- 安装说明未包含流式示例实际使用的 ai 和 @ai-sdk/azure 依赖，也未锁定版本；实现前必须核对当前 API 和包版本。
- 环境变量示例包含 CLIENT_SECRET、API key 和 bearer token，但没有说明权限范围、轮换、存储方式或日志脱敏要求。
- Copilot Studio 和 Azure 服务依赖外部网络与云凭据；文件未证明中国大陆网络可达性、区域限制或离线替代方案。
- 未提供该技能专属验收标准、测试套件、部署配置或失败排查流程。
它能做什么 & 适用场景
这是一个面向 TypeScript/Node.js 的 Microsoft 365 Agents SDK 技能。它提供 AgentApplication 路由、Express 托管、流式响应、invoke 活动处理，以及 Copilot Studio 直连和 WebChat 集成示例。技能覆盖 Teams、Microsoft 365 和 Copilot Studio 场景。实现前要求使用 microsoft-docs MCP 核对 API 签名，并确认 npm 包版本。
指导安装 Microsoft 365 Agents SDK 相关 npm 包；创建 AgentApplication 并用 startServer 启动 Express 服务；为成员加入、消息和 invoke 活动注册处理器；通过 Azure OpenAI 和 streamText 排队文本块、提示更新并结束流；创建 CopilotStudioClient、启动会话并提问；使用 CopilotStudioWebChat 创建连接并渲染 WebChat；说明如何通过环境变量提供 Azure、租户和 Copilot Studio 凭据。
- 负责 Teams 或 Microsoft 365 集成的 TypeScript 开发者，需要用 AgentApplication 为欢迎消息和文本消息配置路由。
- 需要逐步返回长文本生成结果的开发者，希望将 Azure OpenAI 流式输出发送给用户。
- 构建 Copilot Studio 外部客户端的团队，需要直接启动会话并提交问题。
- 需要在网页中嵌入 Copilot Studio 对话的前端开发者，希望使用 WebChat 连接。
- 处理 Teams 或 Microsoft 365 invoke 活动的开发者，需要返回状态并发送反馈消息。
优缺点一览
- 提供可直接改造的 TypeScript/Node.js 代码模式，覆盖路由、Express 托管和流式响应。
- 同时涵盖 Teams/Microsoft 365 代理处理和 Copilot Studio 客户端集成。
- 明确给出环境变量、密钥管理、流结束和 invoke 校验等实践建议。
- 技能采用简洁的 SKILL.md 格式，没有显示 Claude Code 或 Codex 专属扩展。
- 示例依赖多个 Microsoft npm 包及 Azure/Copilot Studio 配置，采用前需要准备相应凭据和环境变量。
- 代码示例没有固定 npm 包版本，且要求使用文档 MCP 核对最新 API。
- 源材料未提供该技能专属的测试场景或验收标准。
- 技能聚焦 SDK 集成模式，未说明完整部署、权限配置或生产运维流程。
如何安装
将仓库中的 .github/plugins/azure-sdk-typescript/skills/m365-agents-ts/ 作为技能目录安装到所用 Agent Skills 客户端的技能位置。若安装整个集合，可运行：npx skills add microsoft/skills，然后在向导中选择需要的技能。之后安装示例所需依赖：npm install @microsoft/agents-hosting @microsoft/agents-hosting-express @microsoft/agents-activity；npm install @microsoft/agents-copilotstudio-client。
如何使用
用包含触发词的请求调用，例如：“使用 Microsoft 365 Agents SDK 为 TypeScript 项目创建 AgentApplication 和 Express 服务，并加入 streamingResponse。”触发词包括 Microsoft 365 Agents SDK、@microsoft/agents-hosting、AgentApplication、startServer、streamingResponse、Copilot Studio client 和 @microsoft/agents-copilotstudio-client。实现前应通过 microsoft-docs MCP 核对 AgentApplication、startServer 和 CopilotStudioClient 的最新签名，并确认 npm 版本。具体的客户端安装位置和自动触发配置未在该技能中说明。