OfficeDev/microsoft-365-agents-toolkit

Microsoft 365 Agents Toolkit

是什么 – 一组开发工具（VS Code 扩展、Visual Studio 扩展和 CLI），帮助您创建、运行、调试和部署 Microsoft 365 Copilot、Microsoft Teams 和 Office 插件的 代理 及其他扩展。该工具包集成了项目模板、认证助手、无服务器函数集成以及 CI/CD 模板，让您专注于应用的 AI 驱动逻辑，而非繁琐的基础设施搭建。

核心组件

包	作用
vscode-extension	IDE 插件，为 Visual Studio Code 添加向导、热重载、安全隧道和一个“代理沙盒”环境。
cli	同样功能的命令行版本，适用于键盘驱动的工作流或 CI 管道。
sdk	轻量级库，为客户端和服务器端代码抽象 Microsoft 365 认证。
api	类型定义和契约，允许第三方插件扩展该工具包。
fx-core	IDE 和 CLI 共享的实现（项目级配置、生命周期管理等）。
function-extension	用于添加 Azure Functions 的助手，可自动将其集成到 Teams 应用中并支持认证。
spec-parser	从 OpenAPI 规范生成基于 API 的消息扩展代码和 Adaptive Card 模板。

主要功能

• 支持 Copilot 代理、Teams 聊天机器人、标签页、消息扩展和 Office 插件的端到端项目模板。
• 集成 Microsoft 365 资源的单点登录（SSO）认证。
• 支持热重载和安全隧道的全栈调试，以及用于快速迭代的“代理沙盒”环境。
• 通过 Azure Functions 实现无服务器后端，并内置认证处理。
• 支持 CI/CD – 提供预配置的 GitHub Actions 和 Azure DevOps 管道。
• 跨语言支持 – 通过 CLI/VS Code 扩展支持 JavaScript/TypeScript，通过 Visual Studio 扩展支持 .NET。

典型使用场景

1. 构建一个 Microsoft 365 Copilot 代理，能够从 SharePoint、Outlook 或自定义 API 获取数据，并响应自然语言查询。
2. 创建一个 Teams 聊天机器人，利用 Teams AI 库，可在本地通过热重载运行，再发布。
3. 添加一个自定义消息扩展（例如 Adaptive Card UI），其界面可从 OpenAPI 描述自动生成。
4. 使用 Azure Functions 为 Teams 应用部署无服务器后端，无需编写样板认证代码。

快速入门

• VS Code：从 Marketplace 安装 Microsoft 365 Agents Toolkit 扩展，运行“创建新项目”向导。
• Visual Studio：安装对应扩展，使用 .NET 代理的项目模板。
• CLI：npm install -g @microsoft/m365agentstoolkit-cli，然后运行 m365 init 创建新项目，m365 run 启动本地调试，m365 deploy 部署到 Azure。
• 详细文档请访问 https://aka.ms/teamsfx-docs。

社区与支持

• 问题与功能请求： https://github.com/OfficeDev/TeamsFx/issues
• 问题咨询：Stack Overflow 标签 teams-toolkit
• 直接反馈：ttkfeedback@microsoft.com

许可证与治理

• 该仓库遵循 Microsoft 的现代生命周期政策，并包含外部贡献的贡献者许可协议（CLA）。默认收集遥测数据，可在 VS Code 常见问题解答中找到退出选项。

---

以上所有信息均直接来自仓库的 README。