Microsoft 365 Agents 工具包

适用于 Visual Studio、Visual Studio Code 和命令行界面 (CLI) 的 Microsoft 365 Agents 工具包，是用于快速简便地为 Microsoft 365 Copilot、Microsoft Teams 和 Microsoft 365 构建代理或应用的工具。无论您是新手开发者还是经验丰富的开发人员，Microsoft 365 Agents 工具包都是您开始创建、构建、调试、测试和部署的最佳选择。

Microsoft 365 Agents 工具包支持端到端的开发流程，包括：

• 支持所有 Microsoft 365 平台的扩展点，包括适用于 Microsoft 365 的 Copilot、代理/聊天机器人、Microsoft Teams 的选项卡和消息扩展，以及 Office 加载项。
• 与 Microsoft Agents SDK 无缝集成，以构建自托管代理。
• 与 Microsoft Teams SDK 无缝集成，轻松在 Microsoft Teams 中构建智能聊天机器人。
• 与您熟悉和喜爱的工具、语言和框架集成。
• 提供脚手架，帮助您快速入门扩展接口和常见场景，例如适用于 Microsoft 365 Copilot 的代理以及跨平台的智能聊天机器人。
• 通过全栈调试、热重载、安全隧道以及 Microsoft 365 Agents Playground 实现快速迭代。
• 简化的 SSO 身份验证。
• 集成的托管、数据存储和无服务器函数支持。
• 适用于 GitHub 和 Azure DevOps 的 CI/CD 操作，让您自信地交付应用。

开始使用

选择您偏好的工具开始：

• 对于 JavaScript 和 TypeScript 开发者，请安装 适用于 Visual Studio Code 的 Microsoft 365 Agents 工具包。
• 对于 .NET 开发者，请安装 适用于 Visual Studio 的 Microsoft 365 Agents 工具包。
• 对于命令行用户，请安装 Microsoft 365 Agents 工具包 CLI：npm install -g @microsoft/m365agentstoolkit-cli

访问 Microsoft 365 Agents 工具包文档，开始构建代理和应用。

路线图

适用于 Visual Studio、Visual Studio Code 和命令行界面 (CLI) 的 Microsoft 365 Agents 工具包将定期更新新功能和错误修复，持续改进 Teams 的端到端开发体验。请查看我们的 变更日志 和 预发布变更日志，了解当前可用的内容，并查看 产品路线图，了解即将推出的功能。

支持政策

Microsoft 365 Agents 工具包产品将遵循 现代生命周期政策，并按照我们的 生命周期与支持文档 中所述提供扩展支持。

反馈

• 在 Stack Overflow 上提问
• 请求新功能
• 提交问题
• 发送邮件至 ttkfeedback@microsoft.com，与产品团队交流
• 将安全问题和漏洞报告至 Microsoft 安全响应中心 (MSRC)，邮箱为 secure@microsoft.com。更多信息请参阅 安全技术中心。

仓库

本仓库包含以下软件包：

软件包	描述
Microsoft 365 Agents Toolkit for Visual Studio Code packages/vscode-extension	Teams Toolkit for Visual Studio Code 允许您直接从 Visual Studio Code 中搭建、运行、调试和部署自定义 Teams 应用。它将 Teams Toolkit CLI 工具的所有功能集成到 IDE 中，并提供对更多示例、文档和工具的便捷访问。
Microsoft 365 Agents Toolkit CLI packages/cli	无论您偏好以键盘为中心的开发操作，还是正在自动化您的 CI/CD 流程，Teams Toolkit CLI 工具都提供与 IDE 扩展相同的特性。
SDK packages/sdk	主要代码库，封装了专为 Teams 开发者设计的客户端和服务器端简单身份验证功能。
API packages/api	API 包是一组由 IDE 扩展和 CLI 支持的契约集合。它使开发者能够编写插件，以扩展 TeamsFx 的新功能。
Core packages/fx-core	Core 包集中实现了 IDE 扩展和 CLI 共享的功能。
Azure Functions 支持 packages/function-extension	Teams Toolkit 帮助开发者在其 Teams 应用中包含由 Azure Functions 提供支持的服务器端代码。此插件增加了对身份验证感知 Azure Function 的支持，从而简化其与 Teams 应用的集成过程。
Spec 解析器 packages/spec-parser	Teams Toolkit 通过解析 OpenAPI 描述文档，自动完成基于 API 的消息扩展（[learn.microsoft.com/en-us/microsoftteams/platform/messaging-extensions/api-based-overview]）和 Adaptive Cards 的生成流程。

贡献

本项目欢迎贡献和建议。大多数贡献都需要您同意一份贡献者许可协议（CLA），声明您有权且确实授予我们使用您贡献的权利。有关详情，请访问 贡献者许可协议。

当您提交拉取请求时，CLA 机器人会自动判断您是否需要提供 CLA，并相应地标记 PR（例如状态检查、评论）。请按照机器人提供的指示操作即可。对于所有使用我们 CLA 的仓库，您只需执行一次此步骤。

• 在 这里 下载我们的最新每日构建版本
• 请查看我们的 贡献指南 以获取更多信息

遥测

Microsoft 365 Agents Toolkit 会收集使用数据并将其发送至 Microsoft，以帮助改进我们的产品和服务。请阅读我们的 隐私声明 和 数据收集通知，了解更多相关信息。您还可以在我们的 常见问题解答 中找到更多信息。

商标

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

行为准则

本项目已采用 微软开源行为准则。如需更多信息，请参阅 行为准则常见问题解答，或如有其他疑问或意见，请联系 opencode@microsoft.com。

Microsoft 365 Agents Toolkit 快速上手指南

Microsoft 365 Agents Toolkit 是专为构建 Microsoft 365 Copilot、Microsoft Teams 应用及 Office 插件而设计的开发工具集。它支持 Visual Studio、Visual Studio Code 和命令行界面（CLI），提供从脚手架搭建、调试到部署的全流程支持。

环境准备

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

• 操作系统：Windows 10/11, macOS, 或 Linux。
• Node.js：建议安装 LTS 版本（用于 CLI 和 JS/TS 开发）。
• .NET SDK：如果您使用 C# 或 .NET 进行开发，需安装最新的 .NET SDK。
• 代码编辑器（任选其一）：
  • Visual Studio Code：适合 JavaScript/TypeScript 开发者。
  • Visual Studio (2022 或更高版本)：适合 .NET 开发者。
• Microsoft 365 账号：需要拥有有效的 Microsoft 365 开发者账号或订阅，以便测试和部署应用。

安装步骤

根据您的开发偏好，选择以下一种方式进行安装：

选项 1：Visual Studio Code (推荐 JS/TS 开发者)

1. 打开 Visual Studio Code。
2. 进入扩展市场（快捷键 Ctrl+Shift+X 或 Cmd+Shift+X）。
3. 搜索 Microsoft 365 Agents Toolkit。
4. 点击“安装”按钮。
   • 或者通过命令行安装：

     code --install-extension teamsdevapp.ms-teams-vscode-extension
     

选项 2：Visual Studio (推荐 .NET 开发者)

1. 打开 Visual Studio Installer。
2. 点击已安装版本的“修改”。
3. 在工作负载列表中，勾选 Microsoft 365 Agents Toolkit (原 Teams Toolkit)。
4. 点击“修改”以应用更改。

选项 3：命令行接口 (CLI)

如果您偏好命令行操作或需要集成到 CI/CD 流水线中，请使用 npm 全局安装：

npm install -g @microsoft/m365agentstoolkit-cli

提示：如果在国内下载速度较慢，可配置淘宝镜像源加速安装：

npm config set registry https://registry.npmmirror.com
npm install -g @microsoft/m365agentstoolkit-cli

基本使用

以下以 CLI 为例，演示如何快速创建一个简单的 Microsoft 365 Copilot 智能体应用。VS Code 和 Visual Studio 的操作逻辑类似，可通过图形界面向导完成。

1. 创建新项目

在终端中运行以下命令启动脚手架向导：

m365agents new

• 按提示选择项目类型（例如：Copilot for Microsoft 365 或 Teams App）。
• 选择编程语言（JavaScript/TypeScript 或 C#）。
• 输入项目名称并确认。

2. 本地调试

进入项目目录并启动本地调试服务器：

cd <your-project-name>
m365agents debug

该命令将自动执行以下操作：

• 安装项目依赖。
• 启动本地隧道（ngrok），使本地服务可被外部访问。
• 编译代码并启动应用。
• 自动打开浏览器或 Teams 客户端加载应用进行预览。

3. 部署到云端

当应用开发完成并测试无误后，可将其部署到 Azure：

m365agents provision
m365agents deploy

• provision：在 Azure 上创建所需的资源（如函数应用、存储账户等）。
• deploy：将代码打包并上传至云端资源。

部署完成后，您即可在生产环境中使用该智能体或应用。更多详细文档请访问 Microsoft 365 Agents Toolkit 官方文档。